WhatsApp no Cursor: mcp.json, variáveis de ambiente e a OpenAPI da ZapZap

Passo a passo

1. 1

   Tenha as chaves em variáveis de ambiente

   No painel, Settings > API, copie a API Key e o API Secret e exporte como ZAPZAP_API_KEY e ZAPZAP_API_SECRET no ambiente em que o Cursor abre. O arquivo de configuração vai referenciar o nome da variável, não o valor.

2. 2

   Compile o servidor MCP

   git clone https://github.com/zapzapapi/zapzap-mcp.git, depois npm install e npm run build (Node.js 18 ou mais). O README do repositório prevê npx -y zapzap-mcp, mas em 11/11/2026 o pacote ainda não está publicado no npm (o registro responde 404). Por isso o caminho que funciona hoje é clonar, compilar e apontar o comando para dist/src/index.js.

3. 3

   Crie o mcp.json no projeto ou na sua conta

   Segundo a documentação do Cursor (lida em 11/11/2026), .cursor/mcp.json vale para o projeto e ~/.cursor/mcp.json vale para todos. O formato é mcpServers com command, args e env. Prefira o arquivo global para a chave não cair num repositório compartilhado.

4. 4

   Use a interpolação em vez de escrever a chave

   O Cursor resolve ${env:NOME} em command, args, env, url e headers (documentação lida em 11/11/2026). Escreva "ZAPZAP_API_KEY": "${env:ZAPZAP_API_KEY}" e o valor nunca aparece no arquivo. Comece com ZAPZAP_READ_ONLY=true.

5. 5

   Veja as ferramentas e aprove cada uso

   As ferramentas aparecem em Available Tools e o Cursor pede aprovação antes de usar uma ferramenta MCP por padrão, com argumentos e resposta expansíveis no chat. Pergunte: liste minhas instâncias e o status de cada uma.

6. 6

   Dê a OpenAPI e o llms.txt ao agente

   Para gerar código, adicione aos documentos do projeto https://zapzapapi.com/openapi/zapzap-openapi.pt.json e https://zapzapapi.com/llms.txt, e escreva nas regras do projeto: base https://api.zapzapapi.com/api/v1, cabeçalhos x-api-key e x-api-secret, use só endpoints da especificação.

{
  "mcpServers": {
    "zapzap": {
      "command": "node",
      "args": ["/absolute/path/to/zapzap-mcp/dist/src/index.js"],
      "env": {
        "ZAPZAP_API_KEY": "${env:ZAPZAP_API_KEY}",
        "ZAPZAP_API_SECRET": "${env:ZAPZAP_API_SECRET}",
        "ZAPZAP_READ_ONLY": "true"
      }
    }
  }
}