MCP Server da Notifica: Gerencie Notificações com Linguagem Natural

Imagine abrir o Claude Code e digitar:

"Envie uma notificação WhatsApp de boas-vindas para todos os novos inscritos de hoje"

E pronto. Sem código, sem dashboard, sem API calls manuais. A IA entende, busca os dados, renderiza o template certo e dispara as notificações. Tudo em segundos.

Isso já é possível com o MCP Server da Notifica.

Se você é desenvolvedor e usa assistentes de IA como Claude, Cursor ou Windsurf, acabamos de eliminar a fricção entre "pensar na notificação" e "enviar a notificação". Bem-vindo ao futuro da gestão de notificações.

---

O que é MCP (Model Context Protocol)?

MCP é um protocolo aberto criado pela Anthropic que permite que assistentes de IA chamem ferramentas externas de forma nativa. Pense nele como uma ponte entre a IA e sua infraestrutura.

Em vez de você:

1. Abrir a documentação da API
2. Escrever um script HTTP
3. Debugar erros de autenticação
4. Consultar o dashboard para ver se funcionou

...você simplesmente conversa com a IA, e ela faz tudo isso por você.

O MCP transforma APIs em ferramentas conversacionais.

---

Como funciona?

1. Configure o MCP Server da Notifica

Abra o arquivo de configuração do seu assistente de IA (Claude Desktop, Cursor ou Windsurf) e adicione:

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "notifica": {
      "command": "npx",
      "args": ["-y", "@notifica/mcp@latest"],
      "env": {
        "NOTIFICA_API_KEY": "nk_live_..."
      }
    }
  }
}

Cursor

Edite ~/.cursor/mcp.json:

{
  "mcpServers": {
    "notifica": {
      "command": "npx",
      "args": ["-y", "@notifica/mcp@latest"],
      "env": {
        "NOTIFICA_API_KEY": "nk_live_..."
      }
    }
  }
}

Windsurf

Adicione à configuração MCP do Windsurf (arquivo equivalente):

{
  "mcpServers": {
    "notifica": {
      "command": "npx",
      "args": ["-y", "@notifica/mcp@latest"],
      "env": {
        "NOTIFICA_API_KEY": "nk_live_..."
      }
    }
  }
}

2. Pegue sua API Key

Entre no Dashboard da Notifica e crie uma API key com os escopos que você precisa:

• notifications:read — Ver notificações enviadas
• notifications:write — Enviar notificações
• templates:read/write — Gerenciar templates
• analytics:read — Consultar métricas

Dica de segurança: Comece com uma chave read-only para explorar. Adicione permissões de escrita só quando precisar.

3. Reinicie seu assistente de IA

Depois de salvar a configuração, reinicie o Claude, Cursor ou Windsurf. As ferramentas da Notifica estarão disponíveis automaticamente.

---

Exemplos Reais: O Que Você Pode Fazer?

1. Debugar notificações que falharam

Você: Liste as últimas 10 notificações que falharam

IA: 📋 Aqui estão as últimas 10 notificações com falha:

1. ID: notif_abc123
   Canal: WhatsApp
   Para: +5511999999999
   Status: failed
   Erro: Invalid phone number format
   Data: 04/02/2026 14:30

2. ID: notif_xyz789
   Canal: SMS
   Para: +5511888888888
   Status: failed
   Erro: Provider timeout (Twilio)
   Data: 04/02/2026 13:15

[...]

💡 Notei um padrão: 8 das 10 falhas são do provedor Twilio com timeout.
Quer que eu verifique o status do provedor?

2. Criar templates de forma conversacional

Você: Crie um template de boas-vindas para WhatsApp com nome do usuário e link de ativação

IA: Vou criar esse template. Proposta:

**Nome:** welcome-whatsapp
**Canal:** WhatsApp
**Conteúdo:**
"Olá {{user_name}}! 👋

Bem-vindo à nossa plataforma. Para ativar sua conta, clique no link abaixo:

{{activation_link}}

Se tiver dúvidas, estamos aqui para ajudar!"

**Variáveis detectadas:**
- user_name
- activation_link

Salvo como template "welcome-whatsapp"? (Requer scope templates:write)

3. Consultar métricas de entrega

Você: Mostre o uso de SMS deste mês

IA: 📊 Uso de SMS (Fevereiro 2026):

Total enviado: 8.450 SMS
Entregues: 8.198 (97.0%)
Falhas: 252 (3.0%)

Breakdown por provedor:
• Twilio: 5.200 enviados, 96.5% entregues
• Zenvia: 3.250 enviados, 97.8% entregues

Cota mensal: 10.000 SMS
Usado: 8.450 (84.5%)
Restante: 1.550

⚠️ Atenção: Você está usando 84% da cota mensal. 
Considere aumentar o plano antes do fim do mês.

4. Disparar workflows automatizados

Você: Dispare o workflow 'welcome-flow' para +5511999999999

IA: Vou disparar o workflow "welcome-flow" para +5511999999999.

Esse workflow tem 3 etapas:
1. Enviar email de boas-vindas
2. Aguardar 1 hora
3. Enviar WhatsApp com dicas de uso

Confirma? Isso vai enviar notificações reais.

Você: Sim, pode enviar

IA: ✅ Workflow disparado!
ID da execução: wfrun_123xyz
Status: running
Etapa atual: 1/3 (Email enviado)

Você pode acompanhar o progresso com: "Mostre o status da execução wfrun_123xyz"

5. Verificar configuração de provedores

Você: Quais provedores SMS estão configurados?

IA: 🔌 Provedores SMS configurados:

1. **Twilio** (Padrão)
   Tipo: twilio
   Status: ✅ Ativo
   Regiões: BR, US
   Rate limit: 100 SMS/min
   Última verificação: 04/02/2026 10:15

2. **Zenvia**
   Tipo: zenvia
   Status: ✅ Ativo
   Regiões: BR
   Rate limit: 50 SMS/min
   Última verificação: 03/02/2026 18:40

Você está usando BYOP (Bring Your Own Provider). 
As credenciais estão armazenadas de forma segura e mascaradas.

6. Analisar métricas de entrega

Você: Mostre as métricas de entrega dos últimos 7 dias

IA: 📈 Métricas de Entrega (Últimos 7 dias)

**Visão Geral:**
Total enviado: 3.842 notificações
Entregues: 3.685 (95.9%)
Falhas: 157 (4.1%)

**Por Canal:**
• Email: 1.523 enviados → 98.2% entregues
• WhatsApp: 1.204 enviados → 94.5% entregues
• SMS: 815 enviados → 96.1% entregues
• In-App: 300 enviados → 100% entregues

**Templates Mais Usados:**
1. welcome-email (412 envios, 98.8% entrega)
2. order-confirmation (387 envios, 97.2% entrega)
3. password-reset (234 envios, 99.1% entrega)

💡 WhatsApp tem a menor taxa de entrega. Quer investigar as falhas?

---

45+ Ferramentas Disponíveis

O MCP Server da Notifica expõe mais de 45 ferramentas organizadas em 11 categorias:

📨 Notificações

• Enviar notificações (email, WhatsApp, SMS, in-app)
• Listar notificações com filtros
• Consultar status de entrega
• Ver tentativas de entrega (debugging)

📝 Templates

• Listar templates por canal
• Criar e editar templates
• Preview com dados de exemplo
• Validar sintaxe de templates

🔄 Workflows

• Listar workflows automatizados
• Disparar workflows
• Consultar status de execuções
• Cancelar workflows em andamento

👥 Assinantes (Subscribers)

• Criar e buscar assinantes
• Gerenciar preferências de notificação
• Importação em massa
• Consultar notificações não lidas

📱 SMS (BYOP)

• Listar provedores configurados
• Adicionar novos provedores (Twilio, Zenvia, custom)
• Testar envio via provedor específico
• Consultar configurações de compliance
• Ver estatísticas de consentimento (opt-in/opt-out)

📊 Analytics

• Métricas de entrega (total, taxa de sucesso)
• Breakdown por canal
• Templates mais usados
• Filtros por período (1h, 24h, 7d, 30d)

💳 Faturamento

• Ver plano atual e data de renovação
• Consultar uso vs quotas
• Listar faturas
• Ver métodos de pagamento

🌐 Domínios (Email)

• Listar domínios de envio
• Verificar saúde de DNS (SPF, DKIM, DMARC)
• Disparar verificação de domínio

🔗 Webhooks

• Listar webhooks configurados
• Ver tentativas de entrega de webhooks
• Testar webhooks com eventos de exemplo

📥 Inbox Embed

• Configurar widget de inbox
• Rotacionar chaves de embed
• Consultar configurações

📬 Inbox (API Pública)

• Listar notificações in-app de um usuário
• Marcar como lido
• Contar não lidas

---

Fase 1 vs Fase 2: Read-Only vs Write Tools

Para garantir segurança, o MCP Server foi lançado em duas fases:

✅ Fase 1: Read-Only (Disponível Agora)

Todas as ferramentas de leitura estão ativas. Você pode:

• Consultar notificações, templates, workflows
• Ver métricas e analytics
• Listar provedores e configurações
• Debugar entregas

Sem riscos: Essas ferramentas não alteram dados nem enviam notificações.

🔜 Fase 2: Write Tools (Em Breve)

Ferramentas de escrita exigem confirmação:

• Enviar notificações
• Criar/editar templates
• Disparar workflows
• Criar assinantes

Confirmação inteligente: A IA pedirá sua confirmação antes de enviar notificações reais para evitar disparos acidentais.

Exemplo de confirmação:
IA: "Vou enviar um WhatsApp para +5511999999999. Esse é um número real. Confirma o envio?"

---

Segurança: Escopos de API Key

Cada API key tem escopos granulares que controlam o acesso:

Escopo	Acesso	Uso Recomendado
notifications:read	Ler notificações enviadas	Debugging, analytics
notifications:write	Enviar notificações	Automações, testes
templates:read	Ler templates	Preview, consulta
templates:write	Criar/editar templates	Gestão de conteúdo
analytics:read	Consultar métricas	Dashboards, relatórios
workflows:*	Gerenciar workflows	Automação completa
billing:read	Ver plano e uso	Monitoramento de custos

Melhores Práticas:

1. Comece com read-only — Use scopes de leitura para explorar sem riscos
2. Chaves separadas — Crie uma chave para MCP e outra para produção
3. Rotacione a cada 90 dias — Renove chaves periodicamente
4. Nunca commite no git — Adicione arquivos de config MCP ao .gitignore

---

Por Que Isso é Revolucionário?

Antes (Sem MCP):

1. Lembrar/buscar endpoint da API
2. Escrever código HTTP (fetch, axios, etc.)
3. Lidar com autenticação e headers
4. Debugar erros de JSON
5. Abrir o dashboard para confirmar
6. Repetir para cada operação

Tempo médio: 10-15 minutos por tarefa simples

Agora (Com MCP):

1. Falar com a IA: "Envie um email de reset de senha para joao@example.com"
2. IA faz tudo automaticamente
3. Resultado em segundos

Tempo médio: 30 segundos

Ganho de produtividade: Redução de 95% no tempo para tarefas rotineiras de notificação.

---

Como Começar em 3 Passos

Passo 1: Crie sua conta na Notifica

Se ainda não tem, crie sua conta gratuita. O plano gratuito inclui:

• 500 notificações/mês
• Todos os canais (email, WhatsApp, SMS, in-app)
• Acesso completo à API

Passo 2: Gere uma API Key

No Dashboard, vá em Settings → API Keys e crie uma nova chave.

Sugestão de escopos para começar:

notifications:read
templates:read
analytics:read
workflows:read

Passo 3: Configure seu assistente de IA

Claude Desktop:

# Edite o arquivo de configuração
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Cole a configuração (veja exemplo acima)
# Reinicie o Claude Desktop

Cursor:

# Edite o arquivo MCP do Cursor
code ~/.cursor/mcp.json

# Cole a configuração
# Reinicie o Cursor

Windsurf:

# Consulte a documentação do Windsurf para localização do arquivo
# Cole a configuração equivalente
# Reinicie o Windsurf

Pronto! Agora você pode gerenciar toda sua infraestrutura de notificações via linguagem natural.

---

Casos de Uso Reais

1. Debugging em Produção

Dev: Por que a notificação notif_xyz não foi entregue?

IA: Investigando... A notificação notif_xyz falhou por:
- Canal: WhatsApp
- Erro: "Invalid phone number format"
- Número fornecido: +55119999
- Esperado: +5511999999999 (E.164 format)

Sugestão: Valide o formato do número antes de enviar. 
Quer que eu mostre as últimas notificações com esse mesmo erro?

2. Monitoramento de Quotas

Dev: Estou perto do limite de SMS?

IA: 📊 Status de Quota SMS:
Plano: Pro (10.000 SMS/mês)
Usado: 8.450 (84.5%)
Restante: 1.550

⚠️ Você está em 84% da quota.
Projeção: Com o ritmo atual (~300 SMS/dia), você vai atingir o limite em ~5 dias.

Recomendação: Considere fazer upgrade para o plano Enterprise (50.000 SMS/mês) 
ou configurar alertas para 90% de uso.

3. A/B Testing de Templates

Dev: Qual template de boas-vindas tem melhor taxa de entrega?

IA: 📈 Comparação de Templates de Boas-Vindas (Últimos 30 dias):

**welcome-v1:**
- Enviados: 1.240
- Entregues: 1.198 (96.6%)
- Abertos: 487 (40.6% open rate)

**welcome-v2:**
- Enviados: 1.180
- Entregues: 1.165 (98.7%)
- Abertos: 612 (52.5% open rate)

🏆 welcome-v2 está performando melhor (+12% open rate, +2% delivery).
Quer migrar todo tráfego para v2?

---

Notifica é BYOP (Bring Your Own Provider)

É importante destacar: Notifica não é um provedor de SMS ou BSP de WhatsApp. Somos uma plataforma de orquestração.

O que isso significa?

Para SMS: Você conecta suas próprias credenciais:

• Twilio
• Zenvia
• Qualquer provedor HTTP custom

Para WhatsApp: Você conecta sua própria conta WABA (WhatsApp Business API). Não somos um BSP — somos a camada que gerencia templates, workflows e analytics sobre sua conta.

Para Email: Você pode usar:

• Nosso relay SMTP (incluído)
• Seu próprio servidor SMTP

Por que BYOP?

1. Flexibilidade: Troque de provedor sem refatorar código
2. Controle de custos: Negocie diretamente com provedores
3. Sem vendor lock-in: Seus contratos são seus
4. Compliance: Mantenha dados em provedores homologados

Roadmap: Push Notifications estão planejados para Q2 2026 — esse será nosso primeiro canal gerenciado diretamente.

---

Primeiros no Mercado

Até fevereiro de 2026, nenhuma outra plataforma de notificações oferece um MCP Server oficial:

• ❌ Novu — Sem MCP público
• ❌ Knock — Sem MCP anunciado
• ❌ Courier — Sem MCP encontrado
• ⚠️ Resend — MCP não-oficial da comunidade
• ❌ SendGrid — Sem suporte MCP
• ❌ Twilio — Sem MCP (apesar de Segment ter)

A Notifica é a primeira plataforma de notificações multi-canal com um MCP Server oficial, completo e mantido.

Isso é mais do que um recurso — é uma nova categoria de produto.

---

Roadmap: O Que Vem Por Aí?

Q1 2026 (Agora)

• ✅ MCP Server — 45+ ferramentas read-only
• ✅ Suporte para Claude, Cursor, Windsurf
• ✅ Documentação completa em PT-BR e EN

Q2 2026

• 🚧 Write Tools — Envio de notificações via MCP
• 🚧 Hosted MCP Endpoint — MCP via HTTPS/SSE (sem npx)
• 🚧 Push Notifications — Primeiro canal gerenciado pela Notifica
• 🚧 MCP Analytics Dashboard — Métricas de uso do MCP

Q3 2026

• 🔮 Custom Tool Descriptions — Personalize como a IA vê suas ferramentas
• 🔮 Multi-Account Support — Gerencie várias contas Notifica no mesmo MCP
• 🔮 Onboarding via AI — IA guia setup inicial automaticamente

---

Performance e Limitações

Rate Limiting

O MCP Server respeita os limites da API da Notifica:

• 100 chamadas/minuto por tipo de ferramenta
• Circuit breaker após 5 erros consecutivos
• Exponential backoff automático em caso de 429 (Too Many Requests)

Timeouts

• Request timeout padrão: 30 segundos
• Configurável via NOTIFICA_TIMEOUT
• Retries automáticos: até 3 tentativas

Modos de Operação

Modo Sandbox

{
  "env": {
    "NOTIFICA_API_KEY": "nk_test_...",
    "NOTIFICA_SANDBOX_MODE": "true"
  }
}

• Só permite envio para endereços de teste
• Ideal para desenvolvimento e experimentação

Modo Produção

{
  "env": {
    "NOTIFICA_API_KEY": "nk_live_...",
    "NOTIFICA_CONFIRM_DESTRUCTIVE": "true"
  }
}

• Envia notificações reais
• Confirmação obrigatória antes de writes

---

Conclusão: O Futuro é Conversacional

Gerenciar infraestrutura via dashboards e APIs vai parecer tão antiquado quanto usar FTP em vez de Git.

A IA é a nova interface.

Com o MCP Server da Notifica, você não precisa mais escolher entre:

• Produtividade (usar a IA)
• Controle (usar a API diretamente)

Agora você tem os dois.

Envie notificações, depure erros, gerencie templates, analise métricas — tudo sem sair do seu fluxo de trabalho. A IA entende seu contexto e executa as tarefas com a mesma precisão que você faria manualmente, mas em 5% do tempo.

Isso não é automação. É colaboração humano-IA em infraestrutura crítica.

---

Recursos e Links

Começar Agora

• Criar conta gratuita — 500 notificações/mês, sem cartão
• Dashboard — Gerar API keys e configurar

Documentação

• Docs do MCP Server — Guia completo de setup
• API Reference — Todas as ferramentas disponíveis
• GitHub — Código aberto, issues e PRs

Pacote NPM

npx @notifica/mcp@latest

Comunidade

• Discord — Tire dúvidas, compartilhe casos de uso
• Changelog — Novidades e updates

---

Você já usa Claude, Cursor ou Windsurf?
Configure o MCP Server da Notifica em 2 minutos e descubra como é gerenciar notificações com linguagem natural. Sem código, sem fricção, só resultados.

🚀 Comece agora