Skip to main content
Quer pedir pro assistente mandar um WhatsApp, checar status de envio ou listar webhooks sem abrir o Postman? É pra isso que serve o MCP: ele conecta sua IDE ao mesmo mundo da API Notifique, com a mesma API Key que você já usa no app. Só precisa de duas coisas: uma chave sk_... (em Workspace → API Keys) e uns segundos pra colar o JSON certo no seu programa favorito. O servidor já está no ar em https://mcp.notifique.dev/mcp

​
Claude Desktop

Abre as configurações do Claude Desktop ou edita o arquivo direto:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Altere sk_... abaixo com sua API Key. Reinicie o Claude Desktop para aplicar. 
{
  "mcpServers": {
    "notifique": {
      "url": "https://mcp.notifique.dev/mcp",
      "headers": {
        "X-API-Key": "sk_..."
      }
    }
  }
}

​
Cursor

Cursor → Settings → MCP, ou o arquivo .cursor/mcp.json no projeto (às vezes no perfil do usuário — depende da versão). Mesma ideia: 
{
  "mcpServers": {
    "notifique": {
      "url": "https://mcp.notifique.dev/mcp",
      "headers": {
        "X-API-Key": "sk_..."
      }
    }
  }
}

​
Claude Code

Um comando e pronto (troca a chave): 
claude mcp add notifique https://mcp.notifique.dev/mcp \
  --transport http \
  --header "X-API-Key: sk_..."

​
Outros (Windsurf, VS Code com extensão MCP, etc.)

Se o app pedir URL + headers, é sempre o mesmo casamento: URL https://mcp.notifique.dev/mcp e header X-API-Key. Quando o formato for JSON, costuma ser este: 
{
  "mcpServers": {
    "notifique": {
      "url": "https://mcp.notifique.dev/mcp",
      "headers": {
        "X-API-Key": "sk_..."
      }
    }
  }
}
Alguns clientes preferem Authorization: Bearer sk_... em vez de X-API-Key — as duas formas funcionam na Notifique.
Não joga chave em repositório público nem print de config com a chave inteira. Se vazar, revoga e cria outra na área de API Keys.

​
Será que tá no ar?

No terminal: 
curl -sS https://mcp.notifique.dev/health
Se aparecer "ok": true, o café tá pronto. Não precisa de API Key pra esse teste.

​
O que dá pra fazer depois de conectar?

O assistente ganha tools pra falar com a API: WhatsApp (mensagens, instâncias, grupos), SMS, e-mail, push, templates, contatos, webhooks, métricas e mais. Tem também resources e prompts úteis pra operação, o próprio cliente MCP lista o que existe (tools/list, etc.). Pra não se perder no cardápio, existem system.help e system.capabilities — ótimos quando você não sabe qual tool chamar. Algumas ideias de frases no chat:
  • “Qual o status da mensagem …?”
  • “Quais instâncias WhatsApp estão ativas?”
  • “Manda um texto pro número … com o texto …”
  • “Mostra webhooks com falha recente”
  • “Resumo rápido de métricas do workspace”

​
Segurança sem drama

Sem chave válida na primeira conexão, não entra — é 401 e pronto. Algumas ações mais “pesadas” podem pedir confirmação explícita na tool (confirm: "YES"). Sua chave não aparece inteira nos logs; erros vêm no formato da API pra facilitar debug.

​
Dicas rápidas

  • Várias instâncias de WhatsApp? Informe instanceId quando a tool pedir.
  • Reenvio ou retry? Use idempotencyKey nos envios.
  • Quer status de uma mensagem? Use a tool do canal (tipo whatsapp.get_message), não só métrica agregada.