Cómo conectar Z-API a Cursor — via MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Z-API, pega tus credenciales, genera una MCP API key — listo. Sin Docker, sin git clone, sin servidor local.

Z-API + Cursor

Z-API, pasarela de WhatsApp de Brasil: comprueba la conexión de la instancia, explora chats y contactos, verifica si un número está en WhatsApp y envía mensajes de texto, imagen y documento a través de un número de WhatsApp vinculado por código QR.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

ZAPI_INSTANCE_ID, ZAPI_INSTANCE_TOKEN, ZAPI_CLIENT_TOKEN

Paso 1 — Obtener credenciales

1. En el panel de Z-API (app.z-api.io), abre Instances, crea o elige una instancia y haz clic en editar. Copia el ID de la instancia en ZAPI_INSTANCE_ID y el token de la instancia en ZAPI_INSTANCE_TOKEN.
2. Abre la pestaña Security, módulo Account Security Token, haz clic en Set Up Now y copia el token en ZAPI_CLIENT_TOKEN. Después haz clic en Activate Token para que todas las solicitudes tengan que incluirlo.
3. Vincula el teléfono: escanea el código QR de la instancia con WhatsApp (Linked devices). Mientras el número no esté vinculado, todos los envíos fallan.
4. Empieza con z_api_get_status: connected: false significa que hay que volver a escanear el código QR; smartphoneConnected: false, que el teléfono está sin conexión.

Z-API es una pasarela de terceros que ejecuta una sesión de WhatsApp Web para tu número. No es la API oficial de WhatsApp Business de Meta, y WhatsApp puede restringir los números que envían mensajes masivos. Los números de teléfono llevan solo dígitos, con código de país y de área, sin +, espacios ni guiones (5511999999999). Las herramientas de envío mandan mensajes reales de WhatsApp: confirma primero el destinatario y el texto, y nunca repitas un envío que haya devuelto un messageId. Si activaste la restricción por IP en la pestaña Security de Z-API, permite la dirección de salida de AnythingMCP.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Z-API.

Herramientas disponibles

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT