Conecte o Zap MCP a qualquer agente

Crie sua conta e conecte um WhatsApp no painel. Depois escolha seu agente abaixo. Onde aparece zap_SEU_TOKEN, use uma chave criada em Chaves de API.

Endereço do servidor MCP

Formas de conectar

Use a primeira que o seu agente aceitar, nesta ordem.

Login pelo navegador

Recomendado

A IA abre o Zap MCP, você entra e escolhe os WhatsApps. Nada para copiar. Funciona no Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code e Gemini CLI.

https://zap-mcp.billy.dev.br/mcp

Token no cabeçalho

Para APIs e agentes

Crie um acesso no painel e envie o token em Authorization: Bearer. O cabeçalho X-API-Key também é aceito.

Authorization: Bearer zap_SEU_TOKEN

Endereço com chave

Quando só cabe uma URL

Para agentes que aceitam apenas um endereço. Trate o link como uma senha: quem tiver o endereço tem o acesso.

https://zap-mcp.billy.dev.br/mcp?key=zap_SEU_TOKEN

Ponte local (stdio)

Agentes que só rodam comandos

O mcp-remote roda no seu computador e repassa as chamadas para o Zap MCP.

npx -y mcp-remote https://zap-mcp.billy.dev.br/mcp --header "Authorization:Bearer zap_SEU_TOKEN"

Deixe a IA configurar

Agentes que editam arquivos ou rodam comandos conseguem adicionar o Zap MCP sozinhos. Abra o tutorial do seu agente e cole o prompt dele. Funciona em: Claude Code, Codex, Grok Build, Cursor, VS Code e Copilot, Gemini CLI, Windsurf, OpenClaw e Hermes Agent.

Agentes e ferramentas que leem documentação também podem usar o llms.txt, um resumo do Zap MCP feito para IAs.

Claude

claude.ai, app desktop e celular · login pelo navegador ou chave

Conecte uma vez pelo navegador. O conector aparece também no app do Claude no celular.

  1. Abra claude.ai em Configurações → Conectores e toque em Adicionar conector personalizado.
  2. Dê o nome Zap MCP e cole o endereço do servidor.
  3. Toque em Conectar, entre na sua conta Zap MCP e escolha os WhatsApps e as permissões.
  4. Numa conversa, ative o Zap MCP no menu de ferramentas.
Endereço do servidor
https://zap-mcp.billy.dev.br/mcp
Sem login (endereço com chave)
https://zap-mcp.billy.dev.br/mcp?key=zap_SEU_TOKEN
Abrir conectores do Claude

Claude Code

terminal e IDE · login pelo navegador ou chave

Adicione o servidor pelo terminal e autentique dentro do Claude Code.

Deixe o Claude Code se configurar

Cole este prompt no Claude Code. Ele adiciona o servidor e confere se as ferramentas apareceram.

Prompt
Configure o servidor MCP do Zap MCP aqui no Claude Code para mim.

- Nome do servidor: zap-mcp
- Endereço (HTTP streamable): https://zap-mcp.billy.dev.br/mcp
- Autenticação: login pelo navegador (OAuth). Se este cliente não suportar, use o cabeçalho Authorization: Bearer com a chave zap_… que eu vou te passar.
- Não grave a chave em arquivos versionados no git e não invente uma chave.

Configuração de referência:

claude mcp add --transport http --scope user zap-mcp https://zap-mcp.billy.dev.br/mcp

Depois de configurar, confirme que as ferramentas do Zap MCP aparecem (por exemplo list_whatsapps) e me diga se preciso reiniciar ou autorizar no navegador. Não envie nenhuma mensagem de WhatsApp sem eu pedir.

ou configure à mão

  1. Rode o comando abaixo no terminal. Use --scope user para ter o Zap MCP em todos os projetos.
  2. Abra o Claude Code, digite /mcp, escolha zap-mcp e depois Authenticate.
  3. Autorize no navegador e volte ao terminal.
Login pelo navegador
claude mcp add --transport http --scope user zap-mcp https://zap-mcp.billy.dev.br/mcp
Com token
claude mcp add --transport http --scope user zap-mcp https://zap-mcp.billy.dev.br/mcp \
  --header "Authorization: Bearer zap_SEU_TOKEN"

Codex

CLI, IDE e app · login pelo navegador ou chave

O Codex aceita servidores HTTP com login pelo navegador ou token em variável de ambiente.

Deixe o Codex se configurar

Cole este prompt no Codex. Ele adiciona o servidor e confere se as ferramentas apareceram.

Prompt
Configure o servidor MCP do Zap MCP aqui no Codex para mim.

- Nome do servidor: zap-mcp
- Endereço (HTTP streamable): https://zap-mcp.billy.dev.br/mcp
- Autenticação: login pelo navegador (OAuth). Se este cliente não suportar, use o cabeçalho Authorization: Bearer com a chave zap_… que eu vou te passar.
- Não grave a chave em arquivos versionados no git e não invente uma chave.

Configuração de referência:

codex mcp add zap-mcp --url https://zap-mcp.billy.dev.br/mcp
codex mcp login zap-mcp

Depois de configurar, confirme que as ferramentas do Zap MCP aparecem (por exemplo list_whatsapps) e me diga se preciso reiniciar ou autorizar no navegador. Não envie nenhuma mensagem de WhatsApp sem eu pedir.

ou configure à mão

  1. Adicione o servidor com o comando abaixo.
  2. Rode codex mcp login zap-mcp e autorize no navegador.
  3. Abra o Codex e confira com /mcp.
Login pelo navegador
codex mcp add zap-mcp --url https://zap-mcp.billy.dev.br/mcp
codex mcp login zap-mcp
Com token (~/.codex/config.toml)
[mcp_servers.zap-mcp]
url = "https://zap-mcp.billy.dev.br/mcp"
bearer_token_env_var = "ZAP_MCP_TOKEN"

# no terminal, antes de abrir o Codex:
# export ZAP_MCP_TOKEN=zap_SEU_TOKEN

ChatGPT

modo desenvolvedor e API da OpenAI · login pelo navegador ou chave

No ChatGPT, crie um app no modo desenvolvedor. Na API, passe o servidor como ferramenta MCP.

  1. Em Configurações → Apps → Configurações avançadas, ative o Modo desenvolvedor.
  2. Toque em Criar app, cole o endereço e escolha autenticação OAuth.
  3. Entre na sua conta Zap MCP e autorize. Depois, ative o app na conversa.
Endereço do servidor
https://zap-mcp.billy.dev.br/mcp
API Responses (Python)
from openai import OpenAI

client = OpenAI()
resp = client.responses.create(
    model="gpt-5",
    input="Resuma minhas conversas de hoje no WhatsApp",
    tools=[{
        "type": "mcp",
        "server_label": "zap",
        "server_url": "https://zap-mcp.billy.dev.br/mcp",
        "headers": {"Authorization": "Bearer zap_SEU_TOKEN"},
        "require_approval": "never",
    }],
)
print(resp.output_text)

Grok Bot

agente pessoal da xAI, no app e no celular · login pelo navegador ou chave

O Grok Bot não tem arquivo de configuração: você adiciona o servidor conversando com ele.

  1. No chat do Grok Bot, mande a mensagem abaixo. Use as palavras “custom MCP server” para ele não procurar no catálogo.
  2. Confira o nome e o endereço e toque em Add it.
  3. Toque em Authorize no cartão de conexão, entre no Zap MCP e escolha os WhatsApps.
  4. Digite @ no chat e selecione zap-mcp para usar.
Mensagem para o Grok Bot
Add a custom MCP server called zap-mcp at https://zap-mcp.billy.dev.br/mcp
Com chave (mensagem)
Add a custom MCP server called zap-mcp at https://zap-mcp.billy.dev.br/mcp
Use the header Authorization with the value: Bearer zap_SEU_TOKEN

Grok Build

agente de código da xAI, terminal · login pelo navegador ou chave

O Grok Build adiciona servidores com grok mcp add. Servidores com login abrem o navegador no primeiro uso.

Deixe o Grok Build se configurar

Cole este prompt no Grok Build. Ele adiciona o servidor e confere se as ferramentas apareceram.

Prompt
Configure o servidor MCP do Zap MCP aqui no Grok Build para mim.

- Nome do servidor: zap-mcp
- Endereço (HTTP streamable): https://zap-mcp.billy.dev.br/mcp
- Autenticação: login pelo navegador (OAuth). Se este cliente não suportar, use o cabeçalho Authorization: Bearer com a chave zap_… que eu vou te passar.
- Não grave a chave em arquivos versionados no git e não invente uma chave.

Configuração de referência:

grok mcp add --transport http zap-mcp https://zap-mcp.billy.dev.br/mcp

Depois de configurar, confirme que as ferramentas do Zap MCP aparecem (por exemplo list_whatsapps) e me diga se preciso reiniciar ou autorizar no navegador. Não envie nenhuma mensagem de WhatsApp sem eu pedir.

ou configure à mão

  1. Rode o comando abaixo no terminal.
  2. Na primeira chamada, o navegador abre para você entrar no Zap MCP. Ou use /mcps e a tecla i para autenticar.
  3. Se algo falhar, rode grok mcp doctor.
Login pelo navegador
grok mcp add --transport http zap-mcp https://zap-mcp.billy.dev.br/mcp
Com chave
export ZAP_MCP_TOKEN=zap_SEU_TOKEN
grok mcp add --transport http zap-mcp https://zap-mcp.billy.dev.br/mcp \
  --header "Authorization: Bearer ${ZAP_MCP_TOKEN}"

Grok

grok.com, apps e API da xAI · login pelo navegador ou chave

No grok.com, adicione um conector personalizado. Na API, passe o servidor como ferramenta MCP.

  1. Abra grok.com/connectors, clique em New Connector e escolha Custom.
  2. Cole o endereço do servidor e conclua o login no Zap MCP.
  3. Na API da xAI, use o campo tools com type mcp, como no exemplo.
Endereço do servidor
https://zap-mcp.billy.dev.br/mcp
API da xAI (curl)
curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.3",
    "input": [{"role": "user", "content": "Quem me mandou mensagem hoje?"}],
    "tools": [{
      "type": "mcp",
      "server_label": "zap",
      "server_url": "https://zap-mcp.billy.dev.br/mcp",
      "authorization": "Bearer zap_SEU_TOKEN"
    }]
  }'
Abrir conectores do Grok

Cursor

editor · login pelo navegador ou chave

Adicione o servidor no mcp.json. Sem cabeçalhos, o Cursor abre o login pelo navegador.

Deixe o Cursor se configurar

Cole este prompt no Cursor. Ele adiciona o servidor e confere se as ferramentas apareceram.

Prompt
Configure o servidor MCP do Zap MCP aqui no Cursor para mim.

- Nome do servidor: zap-mcp
- Endereço (HTTP streamable): https://zap-mcp.billy.dev.br/mcp
- Autenticação: login pelo navegador (OAuth). Se este cliente não suportar, use o cabeçalho Authorization: Bearer com a chave zap_… que eu vou te passar.
- Não grave a chave em arquivos versionados no git e não invente uma chave.

Configuração de referência:

{
  "mcpServers": {
    "zap-mcp": { "url": "https://zap-mcp.billy.dev.br/mcp" }
  }
}

Depois de configurar, confirme que as ferramentas do Zap MCP aparecem (por exemplo list_whatsapps) e me diga se preciso reiniciar ou autorizar no navegador. Não envie nenhuma mensagem de WhatsApp sem eu pedir.

ou configure à mão

  1. Abra Configurações → MCP → Adicionar servidor, ou edite ~/.cursor/mcp.json.
  2. Cole a configuração abaixo e salve.
  3. Clique em Conectar ao lado de zap-mcp e autorize.
Login pelo navegador
{
  "mcpServers": {
    "zap-mcp": { "url": "https://zap-mcp.billy.dev.br/mcp" }
  }
}
Com token
{
  "mcpServers": {
    "zap-mcp": {
      "url": "https://zap-mcp.billy.dev.br/mcp",
      "headers": { "Authorization": "Bearer zap_SEU_TOKEN" }
    }
  }
}

VS Code e Copilot

modo agente · login pelo navegador ou chave

Crie .vscode/mcp.json no projeto, ou use MCP: Add Server na paleta de comandos.

Deixe o VS Code e Copilot se configurar

Cole este prompt no VS Code e Copilot. Ele adiciona o servidor e confere se as ferramentas apareceram.

Prompt
Configure o servidor MCP do Zap MCP aqui no VS Code e Copilot para mim.

- Nome do servidor: zap-mcp
- Endereço (HTTP streamable): https://zap-mcp.billy.dev.br/mcp
- Autenticação: login pelo navegador (OAuth). Se este cliente não suportar, use o cabeçalho Authorization: Bearer com a chave zap_… que eu vou te passar.
- Não grave a chave em arquivos versionados no git e não invente uma chave.

Configuração de referência:

{
  "servers": {
    "zap-mcp": { "type": "http", "url": "https://zap-mcp.billy.dev.br/mcp" }
  }
}

Depois de configurar, confirme que as ferramentas do Zap MCP aparecem (por exemplo list_whatsapps) e me diga se preciso reiniciar ou autorizar no navegador. Não envie nenhuma mensagem de WhatsApp sem eu pedir.

ou configure à mão

  1. Crie o arquivo .vscode/mcp.json com a configuração abaixo.
  2. Clique em Start acima do servidor e autorize quando o VS Code pedir.
  3. No chat do Copilot, escolha o modo Agente.
Login pelo navegador
{
  "servers": {
    "zap-mcp": { "type": "http", "url": "https://zap-mcp.billy.dev.br/mcp" }
  }
}
Com token
{
  "servers": {
    "zap-mcp": {
      "type": "http",
      "url": "https://zap-mcp.billy.dev.br/mcp",
      "headers": { "Authorization": "Bearer zap_SEU_TOKEN" }
    }
  }
}

Gemini CLI

terminal · login pelo navegador ou chave

Adicione pelo comando ou pelo ~/.gemini/settings.json.

Deixe o Gemini CLI se configurar

Cole este prompt no Gemini CLI. Ele adiciona o servidor e confere se as ferramentas apareceram.

Prompt
Configure o servidor MCP do Zap MCP aqui no Gemini CLI para mim.

- Nome do servidor: zap-mcp
- Endereço (HTTP streamable): https://zap-mcp.billy.dev.br/mcp
- Autenticação: login pelo navegador (OAuth). Se este cliente não suportar, use o cabeçalho Authorization: Bearer com a chave zap_… que eu vou te passar.
- Não grave a chave em arquivos versionados no git e não invente uma chave.

Configuração de referência:

gemini mcp add --transport http zap-mcp https://zap-mcp.billy.dev.br/mcp

Depois de configurar, confirme que as ferramentas do Zap MCP aparecem (por exemplo list_whatsapps) e me diga se preciso reiniciar ou autorizar no navegador. Não envie nenhuma mensagem de WhatsApp sem eu pedir.

ou configure à mão

  1. Rode o comando abaixo.
  2. Abra o Gemini CLI e use /mcp auth zap-mcp para entrar, se escolheu o login pelo navegador.
Login pelo navegador
gemini mcp add --transport http zap-mcp https://zap-mcp.billy.dev.br/mcp
Com token (settings.json)
{
  "mcpServers": {
    "zap-mcp": {
      "httpUrl": "https://zap-mcp.billy.dev.br/mcp",
      "headers": { "Authorization": "Bearer zap_SEU_TOKEN" }
    }
  }
}

Windsurf

editor · chave de API

Edite ~/.codeium/windsurf/mcp_config.json e recarregue os servidores.

Deixe o Windsurf se configurar

Cole este prompt no Windsurf. Ele adiciona o servidor e confere se as ferramentas apareceram. Tenha uma chave em mãos: ele vai pedir.

Prompt
Configure o servidor MCP do Zap MCP aqui no Windsurf para mim.

- Nome do servidor: zap-mcp
- Endereço (HTTP streamable): https://zap-mcp.billy.dev.br/mcp
- Autenticação: cabeçalho Authorization: Bearer com a chave zap_… que eu vou te passar. Pergunte a chave antes de salvar.
- Não grave a chave em arquivos versionados no git e não invente uma chave.

Configuração de referência:

{
  "mcpServers": {
    "zap-mcp": {
      "serverUrl": "https://zap-mcp.billy.dev.br/mcp",
      "headers": { "Authorization": "Bearer zap_SEU_TOKEN" }
    }
  }
}

Depois de configurar, confirme que as ferramentas do Zap MCP aparecem (por exemplo list_whatsapps) e me diga se preciso reiniciar ou autorizar no navegador. Não envie nenhuma mensagem de WhatsApp sem eu pedir.

ou configure à mão

  1. Abra Configurações → Cascade → MCP Servers → Ver configuração.
  2. Cole a configuração e clique em Atualizar.
Com token
{
  "mcpServers": {
    "zap-mcp": {
      "serverUrl": "https://zap-mcp.billy.dev.br/mcp",
      "headers": { "Authorization": "Bearer zap_SEU_TOKEN" }
    }
  }
}

OpenClaw

antigo Clawdbot, agente pessoal · login pelo navegador ou chave

O OpenClaw lê servidores MCP do bloco mcp.servers da configuração dele. Use transport streamable-http.

Deixe o OpenClaw se configurar

Cole este prompt no OpenClaw. Ele adiciona o servidor e confere se as ferramentas apareceram.

Prompt
Configure o servidor MCP do Zap MCP aqui no OpenClaw para mim.

- Nome do servidor: zap-mcp
- Endereço (HTTP streamable): https://zap-mcp.billy.dev.br/mcp
- Autenticação: login pelo navegador (OAuth). Se este cliente não suportar, use o cabeçalho Authorization: Bearer com a chave zap_… que eu vou te passar.
- Não grave a chave em arquivos versionados no git e não invente uma chave.

Configuração de referência:

{
  "mcp": {
    "servers": {
      "zap-mcp": {
        "url": "https://zap-mcp.billy.dev.br/mcp",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}

Depois de configurar, confirme que as ferramentas do Zap MCP aparecem (por exemplo list_whatsapps) e me diga se preciso reiniciar ou autorizar no navegador. Não envie nenhuma mensagem de WhatsApp sem eu pedir.

ou configure à mão

  1. Abra a configuração do OpenClaw (~/.openclaw/openclaw.json) e adicione o bloco abaixo dentro de mcp.servers.
  2. Com login: rode openclaw mcp login zap-mcp e autorize no navegador. Com chave: use a versão com headers.
  3. Reinicie o OpenClaw e peça algo como “quais conversas chegaram hoje no WhatsApp?”.
Login pelo navegador
{
  "mcp": {
    "servers": {
      "zap-mcp": {
        "url": "https://zap-mcp.billy.dev.br/mcp",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}
Com chave
{
  "mcp": {
    "servers": {
      "zap-mcp": {
        "url": "https://zap-mcp.billy.dev.br/mcp",
        "transport": "streamable-http",
        "headers": { "Authorization": "Bearer zap_SEU_TOKEN" }
      }
    }
  }
}

Hermes Agent

Nous Research · chave de API

O Hermes carrega servidores MCP do bloco mcp_servers no ~/.hermes/config.yaml.

Deixe o Hermes Agent se configurar

Cole este prompt no Hermes Agent. Ele adiciona o servidor e confere se as ferramentas apareceram. Tenha uma chave em mãos: ele vai pedir.

Prompt
Configure o servidor MCP do Zap MCP aqui no Hermes Agent para mim.

- Nome do servidor: zap-mcp
- Endereço (HTTP streamable): https://zap-mcp.billy.dev.br/mcp
- Autenticação: cabeçalho Authorization: Bearer com a chave zap_… que eu vou te passar. Pergunte a chave antes de salvar.
- Não grave a chave em arquivos versionados no git e não invente uma chave.

Configuração de referência:

mcp_servers:
  zap-mcp:
    url: "https://zap-mcp.billy.dev.br/mcp"
    headers:
      Authorization: "Bearer zap_SEU_TOKEN"
    timeout: 180

Depois de configurar, confirme que as ferramentas do Zap MCP aparecem (por exemplo list_whatsapps) e me diga se preciso reiniciar ou autorizar no navegador. Não envie nenhuma mensagem de WhatsApp sem eu pedir.

ou configure à mão

  1. Crie uma chave em Chaves de API no painel.
  2. Adicione o bloco abaixo ao ~/.hermes/config.yaml.
  3. Reinicie o Hermes. As ferramentas aparecem como zap-mcp.
Com chave (config.yaml)
mcp_servers:
  zap-mcp:
    url: "https://zap-mcp.billy.dev.br/mcp"
    headers:
      Authorization: "Bearer zap_SEU_TOKEN"
    timeout: 180

n8n

automações · chave de API

Use o nó MCP Client Tool ligado a um AI Agent.

  1. Adicione um nó AI Agent e, em Tools, o nó MCP Client Tool.
  2. Em Endpoint, cole o endereço. Em Server Transport, escolha HTTP Streamable.
  3. Em Authentication, escolha Bearer Auth e cole o token.
Endpoint
https://zap-mcp.billy.dev.br/mcp
Bearer token
zap_SEU_TOKEN

Outros agentes

bots próprios, SDKs, agentes só com stdio · chave de API

Funciona com qualquer agente que fale MCP. Se ele só roda comandos locais (stdio), use a ponte mcp-remote. Se só aceita um endereço, use o endereço com chave.

  1. Agente com MCP por HTTP: informe o endereço e o cabeçalho Authorization.
  2. Agente só com stdio: use a configuração com npx mcp-remote (precisa de Node.js).
  3. Agente que só aceita uma URL: use o endereço com ?key=.
Ponte stdio (mcp-remote)
{
  "mcpServers": {
    "zap-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://zap-mcp.billy.dev.br/mcp",
               "--header", "Authorization:Bearer zap_SEU_TOKEN"]
    }
  }
}
Endereço com chave
https://zap-mcp.billy.dev.br/mcp?key=zap_SEU_TOKEN
Teste rápido com curl
curl -s https://zap-mcp.billy.dev.br/mcp \
  -H "Authorization: Bearer zap_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Ainda não conectou seu WhatsApp?

Leva uns cinco minutos.

Criar conta