MCP do WhatsApp: conecte o Claude e outras IAs

O que é MCP e para que serve no WhatsApp?

MCP (Model Context Protocol) é um padrão aberto que liga assistentes de IA a sistemas externos por meio de "ferramentas" que a IA chama sozinha. O servidor MCP da FlashConnect transforma a sua conta de WhatsApp oficial em ferramentas: a IA consulta conversas, responde contatos, monta o agente de IA, cadastra produtos, cria templates e webhooks, tudo a partir de um pedido em português.

Ele usa a mesma autenticação e as mesmas regras da API REST: janela de 24 h, escopos da chave, isolamento por conta.

Qual é o endereço do servidor MCP?

https://qqyphyubrxyouaqicdbo.supabase.co/functions/v1/mcp

• Transporte: Streamable HTTP sem sessão. Cada POST é uma mensagem JSON-RPC e a resposta volta em application/json. Não há SSE (GET responde 405) e lotes JSON-RPC não são aceitos.
• Versões do protocolo: 2025-06-18, 2025-03-26 e 2024-11-05.
• Autenticação: Authorization: Bearer ck_live_… (chave de API) ou o token do login OAuth, no caso do app do Claude e do ChatGPT.
• Quem pode: por login, só dono ou admin da conta; o papel atendente recebe 403 PERMISSAO_INSUFICIENTE. Por chave, valem os escopos dela.

Como conectar o WhatsApp no app do Claude (claude.ai e Desktop)?

O app do Claude conecta por login (OAuth), sem copiar chave.

1. Adicione o conectorNo Claude, abra Configurações → Conectores → Adicionar conector personalizado. Dê o nome FlashConnect e cole o endereço do servidor MCP. Em conta de empresa (Team ou Enterprise), quem adiciona conectores é o administrador da organização no Claude.
2. Entre com a sua conta FlashConnectClique em Conectar. Abre a tela da FlashConnect: entre com e-mail e senha, veja o que a IA poderá fazer e clique em Permitir. Só o dono ou um admin da conta pode conectar.
3. Comece a conversaNuma conversa nova, confira se o FlashConnect está ligado no menu de ferramentas e peça: "Rode status_setup e me explique o que falta".

A conexão por login tem todas as permissões do seu usuário. Mensagem enviada por ela sai com autor humano e assume a conversa, como no painel. Para desconectar, use a lista "IAs conectadas" em Conectar IA, no painel.

Como conectar o Claude Code?

1. Instale o Claude CodeNo Mac ou Linux, no Terminal: curl -fsSL https://claude.ai/install.sh | bash. No Windows, no PowerShell: irm https://claude.ai/install.ps1 | iex. Depois rode claude e entre com a sua conta da Anthropic.
2. Gere a chaveNo painel da FlashConnect, em Conectar IA → Claude Code → Gerar chave. A chave aparece uma vez e já sai com todos os escopos.
3. Adicione o servidorNo terminal, cole o comando abaixo trocando SUA_CHAVE. O --scope user vale para qualquer pasta do computador.
4. Opcional: deixe o Claude usar o painelCom a extensão Claude in Chrome, rode claude --chrome: ele passa a enxergar e clicar no painel com o seu login. Login da Meta e pagamento continuam com você.

claude mcp add --transport http castilho --scope user https://qqyphyubrxyouaqicdbo.supabase.co/functions/v1/mcp --header "Authorization: Bearer SUA_CHAVE"

Como conectar o WhatsApp no ChatGPT?

O ChatGPT conecta por login (OAuth), no modo desenvolvedor, que ainda é beta na OpenAI. Ele não aceita chave de API.

1. Ligue o modo desenvolvedorNo ChatGPT pelo navegador, abra Configurações → Aplicativos → Configurações avançadas e ligue o Modo desenvolvedor. Em conta de empresa, o administrador precisa liberar.
2. Crie o app FlashConnectEm Aplicativos, clique em Criar. Nome: FlashConnect. Autenticação: OAuth. Cole o endereço do servidor MCP.
3. Entre com a sua conta FlashConnectEntre com e-mail e senha e clique em Permitir. Só o dono ou um admin da conta pode conectar.
4. Use na conversaNuma conversa nova, escolha Modo desenvolvedor no menu + e ative o FlashConnect.

Pela documentação da OpenAI, MCP completo (com ações de escrita) é para ChatGPT Business, Enterprise e Edu; no Pro, o ChatGPT só consulta. Os nomes dos menus mudam com frequência.

Como conectar Codex, Cursor, VS Code, Gemini CLI, Windsurf, Lovable e n8n?

Todos usam a chave ck_live_ no header. Gere a chave em Conectar IA, no painel: lá o comando de cada app já sai com a chave preenchida.

Codex (CLI, app e extensão): fim do arquivo ~/.codex/config.toml

[mcp_servers.castilho]
url = "https://qqyphyubrxyouaqicdbo.supabase.co/functions/v1/mcp"
http_headers = { "Authorization" = "Bearer SUA_CHAVE" }

Cursor: ~/.cursor/mcp.json (vale para todos os projetos)

{
  "mcpServers": {
    "castilho": {
      "url": "https://qqyphyubrxyouaqicdbo.supabase.co/functions/v1/mcp",
      "headers": { "Authorization": "Bearer SUA_CHAVE" }
    }
  }
}

VS Code (Copilot): comando MCP: Open User Configuration

{
  "servers": {
    "castilho": {
      "type": "http",
      "url": "https://qqyphyubrxyouaqicdbo.supabase.co/functions/v1/mcp",
      "headers": { "Authorization": "Bearer SUA_CHAVE" }
    }
  }
}

Gemini CLI: ~/.gemini/settings.json

{
  "mcpServers": {
    "castilho": {
      "httpUrl": "https://qqyphyubrxyouaqicdbo.supabase.co/functions/v1/mcp",
      "headers": { "Authorization": "Bearer SUA_CHAVE" }
    }
  }
}

Windsurf: mcp_config.json (versões novas em ~/.config/devin/, antigas em ~/.codeium/windsurf/)

{
  "mcpServers": {
    "castilho": {
      "serverUrl": "https://qqyphyubrxyouaqicdbo.supabase.co/functions/v1/mcp",
      "headers": { "Authorization": "Bearer SUA_CHAVE" }
    }
  }
}

Lovable: Connectors → + → MCP server

Nome:          FlashConnect
URL:           https://qqyphyubrxyouaqicdbo.supabase.co/functions/v1/mcp
Autenticação:  Bearer token / API key
Token:         SUA_CHAVE

No Lovable a conexão serve para conversar com ele sobre a sua conta. O app que o Lovable publica não usa conectores de chat: para o site enviar e receber mensagens, use a API REST.

n8n: nó MCP Client Tool, transporte HTTP Streamable, autenticação por header

Endpoint: https://qqyphyubrxyouaqicdbo.supabase.co/functions/v1/mcp
Header:   Authorization
Valor:    Bearer SUA_CHAVE

Qualquer outro cliente que aceite MCP remoto (HTTP) com header de autorização funciona com o mesmo endereço e a mesma chave.

A IA consegue enviar arquivos pelo WhatsApp?

Sim. A ferramenta enviar_mensagem manda imagem, vídeo, documento, áudio e figurinha, de três jeitos:

• Arquivo com link público: a IA passa o link em midia_url.
• Arquivo no computador (Claude Code, Codex, scripts): a IA sobe o arquivo no endpoint media-upload com a mesma chave (escopo messages:send) e envia com o caminho devolvido em midia_caminho.
• Arquivo anexado no chat (app do Claude, ChatGPT): esses apps não repassam anexos para ferramentas. A IA usa link_enviar_arquivo e te entrega o link da conversa no painel, onde você anexa e envia.

Quais ferramentas o MCP do WhatsApp oferece?

São 31 ferramentas. As de agenda e tarefas só aparecem quando o módulo correspondente está liberado na conta. Uma chave sem o escopo da ferramenta recebe ESCOPO_INSUFICIENTE e a IA explica o que falta; conexão por login tem todos os escopos.

Começar

Atendimento

Agente de IA e catálogo

Templates e webhooks

Agenda (só com o módulo de agenda ligado)

Tarefas (só com o módulo de tarefas ligado)

As ferramentas marcadas como destrutivas são anunciadas assim ao cliente MCP (destructiveHint), que costuma pedir confirmação. As de leitura são marcadas como somente leitura.

Quais recursos e prompts prontos o servidor tem?

• Recurso castilho://guia (Markdown): como a plataforma funciona (números, conversas, agente, produtos, templates, webhooks, janela de 24 h e escopos). A IA lê quando você pergunta "como funciona".
• Prompt configurar: roteiro guiado de setup da conta, a partir do status_setup.
• Prompt criar_agente: entrevista curta sobre o negócio e monta agente, produtos e base de conhecimento, mostrando o resumo antes de ligar.
• Prompt criar_template: escreve o template com você, sugere a categoria e envia para aprovação quando você aprovar.

Ao conectar, o servidor também manda instruções para a IA: entrevistar antes de montar o agente, não inventar preço ou política, confirmar antes de enviar mensagem a contatos reais e de apagar qualquer coisa, e ligar o agente só depois do seu "pode ligar".

O que dá para pedir em linguagem natural?

"Rode status_setup e me diga o que falta para o meu WhatsApp atender sozinho."

"Mostre as conversas não lidas em modo IA e resuma o que cada cliente quer."

"Responda a Ana confirmando a consulta de amanhã às 14h." (a IA confirma com você antes de enviar)

"Monte um agente de vendas para a minha loja de roupas, com tom amigável, e cadastre estes 10 produtos."

"Crie um template de lembrete de consulta e acompanhe se a Meta aprovou."

"Veja os horários livres de sexta e marque a Ana às 10h; depois crie uma tarefa para ligar para ela na segunda."

"Cadastre um webhook para o meu n8n receber todas as mensagens." (o secret aparece uma vez)

O MCP é seguro para a minha conta?

• Cada ferramenta exige um escopo. Gere chaves só com o necessário: uma chave só de leitura não envia nem altera nada.
• Tudo é isolado por conta: a IA só enxerga os dados da sua empresa.
• Toda ferramenta que altera dados é registrada no log de auditoria (mcp.<ferramenta>), com a chave usada. Leituras não são registradas.
• O secret dos webhooks nunca é listado: aparece só na criação.
• Erro de negócio volta para a IA como resultado com isError e a mensagem, para ela explicar a você. Os códigos estão em códigos de erro.

Mais sobre proteção de dados em segurança e LGPD.

Perguntas frequentes