WhatsApp en Cursor: mcp.json, variables de entorno y la OpenAPI de ZapZap

Paso a paso

1. 1

   Ten las claves en variables de entorno

   En el panel, Settings > API, copia la API Key y el API Secret y expórtalas como ZAPZAP_API_KEY y ZAPZAP_API_SECRET en el entorno donde se abre Cursor. El archivo de configuración hará referencia al nombre de la variable, no al valor.

2. 2

   Compila el servidor MCP

   git clone https://github.com/zapzapapi/zapzap-mcp.git, luego npm install y npm run build (Node.js 18 o superior). El README del repositorio prevé npx -y zapzap-mcp, pero el 11/11/2026 el paquete aún no está publicado en npm (el registro responde 404). El camino que funciona hoy es clonar, compilar y apuntar el comando a dist/src/index.js.

3. 3

   Crea el mcp.json en el proyecto o en tu cuenta

   Según la documentación de Cursor (leída el 11/11/2026), .cursor/mcp.json vale para el proyecto y ~/.cursor/mcp.json vale para todos. El formato es mcpServers con command, args y env. Prefiere el archivo global para que la clave no caiga en un repositorio compartido.

4. 4

   Usa la interpolación en vez de escribir la clave

   Cursor resuelve ${env:NOMBRE} en command, args, env, url y headers (documentación leída el 11/11/2026). Escribe "ZAPZAP_API_KEY": "${env:ZAPZAP_API_KEY}" y el valor nunca aparece en el archivo. Empieza con ZAPZAP_READ_ONLY=true.

5. 5

   Mira las herramientas y aprueba cada uso

   Las herramientas aparecen en Available Tools y Cursor pide aprobación antes de usar una herramienta MCP por defecto, con argumentos y respuesta expandibles en el chat. Pregunta: lista mis instancias y el estado de cada una.

6. 6

   Dale la OpenAPI y el llms.txt al agente

   Para generar código, agrega a los documentos del proyecto https://zapzapapi.com/openapi/zapzap-openapi.es.json y https://zapzapapi.com/llms.txt, y escribe en las reglas del proyecto: base https://api.zapzapapi.com/api/v1, cabeceras x-api-key y x-api-secret, usa solo endpoints de la especificación.

{
  "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"
      }
    }
  }
}