MCP da Notifique

MCP é o garçom da IDE: você pede em linguagem natural (“manda um WhatsApp”, “cria link compartilhável da instância”) e a IA chama a API da Notifique por você.

O que é MCP?

MCP (Model Context Protocol) liga a IA no seu computador à API da Notifique. Servidor: https://mcp.notifique.dev/mcp. Catalog 3.0 (~200 tools no catálogo completo; no Cursor o MCP expõe packs sob demanda). Auth: API Key (X-API-Key / Authorization: Bearer sk_…) ou OAuth Bearer (descoberta em /.well-known/oauth-protected-resource com escopos completos).

Domains no Cursor (~40 tools)

O Cursor limita ~40 tools. Por padrão só o pack system aparece em tools/list. Fluxo:

system.list_domains — packs (whatsapp, forms, …) + contagem
system.load_domain { "domain": "whatsapp" } — carrega o pack e notifica listChanged
system.search_tools { "query": "carousel" } — busca no catálogo inteiro
system.unload_domain — libera slots

Env úteis: NOTIFIQUE_MCP_DEFAULT_DOMAINS=whatsapp,sms, NOTIFIQUE_MCP_EXPOSE_ALL=true (catálogo completo; não use no Cursor), NOTIFIQUE_MCP_MAX_TOOLS (soft cap, default 38).

Capacidade (catalog 3.0)

Domínio	Exemplos de tools
WhatsApp	`whatsapp.send`, `whatsapp.create_instance`, `whatsapp.connect_page.*`, `whatsapp.sync_templates`, groups, carousel/buttons, presence, inbound media
Instagram / Telegram	send, instances, connect-page, comments (IG), bot-token (TG)
SMS / Email / Push / RCS / Voice	send/list/get + voice.call_action
Notify	`messages.send_notify` (fallback 8 canais)
Templates / CRM	templates., topics., segments., campaigns. (+ run_preview/cancel/stats)
Forms / Short links	`forms.lists.`, `forms.subscriptions.`, `short_links.*`
Automations	`automations.`, `events.`
Suppressions / Phone / Conversions	`suppressions.`, `phone_numbers.`, `conversions.track`
OAuth apps	`oauth_apps.`, `oauth_connections.` (apps do workspace; ≠ DCR do MCP)
System	`system.help`, `system.capabilities`, `system.list_domains`, `system.load_domain`, `system.search_tools`

Chat no site (AI widget) não tem tool de envio — só painel.

WhatsApp oficial no MCP

Tarefa	Tool
QR não oficial	`whatsapp.create_instance` `mode: UNOFFICIAL`
Oficial BYOK	`mode: OFFICIAL_BYOK` + token + phoneNumberId
Oficial + link remoto	`mode: OFFICIAL` + `generateShareableLink: true` → `whatsapp.connect_page.enable`
Pairing sem QR	`whatsapp.get_pairing_code`
Botões / lista / carrossel (sessão)	`whatsapp.send` (`type`) — carrossel freeform = QR; oficial preferir template Meta
Fora 24h	`messages.send_template`
Sync / push Meta	`whatsapp.sync_templates`, `whatsapp.push_template`

META_TEMPLATE_REQUIRED → use template aprovado, não texto livre.

Segurança

Regra	Detalhe
Escopos	Backend valida em cada chamada; peça só o necessário na chave/OAuth
Destrutivo	`NOTIFIQUE_ALLOW_DESTRUCTIVE=true` e `confirm: "YES"` (delete, rotate secret, disable connect-page, export PII, …)
Segredos	`clientSecret` / connect-page secret retornam uma vez
Isolamento	Credencial = um workspace; sem `x-workspace-id`

Peça system.capabilities para ver sensitivity por domínio.

Exemplos de frase

“Cria instância oficial com link compartilhável e me devolve a URL”
“Envia carrossel no WhatsApp QR para…”
“Lista forms e cria short link para essa landing”
“Preview de re-run da campanha X só em WhatsApp e SMS”
“Cria um OAuth app com redirect https://…”
“Quais tools de suppressions existem?”

Como configurar

Cursor

{
  "mcpServers": {
    "notifique": {
      "url": "https://mcp.notifique.dev/mcp",
      "headers": { "X-API-Key": "sk_..." }
    }
  }
}

Claude Desktop / Code

Mesma URL + header X-API-Key. Health sem chave: curl -sS https://mcp.notifique.dev/health.

Nunca commite a chave. Vazou? Revogue e crie outra.

Próximos passos

LLMs.txt · Skills · skill.md
Modos WhatsApp · OAuth

Guias simples

Conheça mais

Workspaces

OAuth 2.1

IA e no-code

BYOK

Changelog

Platform API

Conta

API Keys

Billing

Créditos

Equipe

Metadados

OAuth

Webhooks

Entregas

Logs

Workspaces

O que é MCP?

Domains no Cursor (~40 tools)

Capacidade (catalog 3.0)

WhatsApp oficial no MCP

Segurança

Exemplos de frase

Como configurar

Cursor

Claude Desktop / Code

Próximos passos

​O que é MCP?

​Domains no Cursor (~40 tools)

​Capacidade (catalog 3.0)

​WhatsApp oficial no MCP

​Segurança

​Exemplos de frase

​Como configurar

​Cursor

​Claude Desktop / Code

​Próximos passos

O que é MCP?

Domains no Cursor (~40 tools)

Capacidade (catalog 3.0)

WhatsApp oficial no MCP

Segurança

Exemplos de frase

Como configurar

Cursor

Claude Desktop / Code

Próximos passos