Cómo conectar WhatsApp con Claude, ChatGPT y Cursor por MCP (guía 2026)

Respuesta corta: para conectar WhatsApp con Claude, ChatGPT, Cursor, Codex, Grok o n8n usás el servidor MCP remoto de Waspy, que vive en https://api.waspytech.com/mcp. Los clientes que soportan OAuth (Claude, ChatGPT, Codex) inician sesión solos contra Waspy; los que mandan un header (Cursor, Claude Code, Grok, n8n) usan una API key wspy_ creada en Configuración → Claves de API. Desde ahí el asistente puede buscar contactos y conversaciones, leer mensajes, dejar notas internas, mover la etapa de un contacto y, solo si lo autorizás, enviar mensajes y plantillas de WhatsApp.

Ojo con una cosa: Waspy no responde solo a tus clientes. El asistente lo usás vos (o tu equipo): le pedís "resumime lo que quedó sin responder" o "mandale la plantilla de despacho a Laura" y él llama a las herramientas de Waspy. La conexión es con la API oficial de WhatsApp Business de Meta, así que no hay riesgo de bloqueo por automatizar WhatsApp Web.

Qué es MCP y por qué sirve para WhatsApp

MCP (Model Context Protocol) es un estándar abierto para que un asistente de IA use herramientas externas con permisos claros. En vez de copiar y pegar chats en ChatGPT, el asistente consulta tu bandeja en el momento y solo ve lo que le habilitaste.

Para un comercio que vende por WhatsApp eso sirve para tareas concretas:

• "¿Quiénes preguntaron por envíos a Córdoba esta semana y no compraron?"
• "Resumime las conversaciones abiertas que esperan respuesta del equipo."
• "Dejale una nota a la conversación de Martín: el pedido #1847 sale por Andreani el lunes."
• "Creá una plantilla de utilidad para avisar que un pedido fue despachado."

Qué puede hacer el conector de Waspy

Estas son las herramientas que expone el servidor (las podés listar vos mismo con tools/list, más abajo):

Además de WhatsApp, el conector lee las conversaciones de Instagram, Facebook y TikTok conectadas a la misma cuenta. Email y chat web no se envían por el conector, y las conversaciones de grupo no entran.

Antes de empezar

1. Una cuenta de Waspy con tu número de WhatsApp conectado por la API oficial. Si todavía no la tenés, mirá qué es la API de WhatsApp y cómo contratarla.
2. Para los clientes que usan header: una API key. Se crea en Configuración → Claves de API, se muestra una sola vez y empieza con wspy_.
3. Definí qué va a poder hacer el asistente. Una key sin scopes tiene acceso completo; con scopes, solo lo que marques. Para empezar, lo más sano es solo lectura.

Claude: claude.ai, Claude Desktop y Claude Code

Claude (web y escritorio)

En Claude andá a Configuración → Conectores → Agregar conector y pegá:

https://api.waspytech.com/mcp

Claude inicia el OAuth: se abre la pantalla de Waspy, entrás con tu usuario y elegís la cuenta. Si el pedido incluye envíos, ahí mismo podés dejar solo lectura y notas. Además de las herramientas, vas a ver dos habilidades como prompts: resumen-diario-bandeja y seguimiento-de-leads.

Claude Code (terminal)

Claude Code agrega servidores remotos con claude mcp add (documentación oficial de Claude Code). Con OAuth:

claude mcp add --transport http waspy https://api.waspytech.com/mcp

Después, dentro de Claude Code, corré /mcp, elegí waspy y autenticá. Si preferís una API key (por ejemplo, en un servidor sin navegador):

claude mcp add --transport http waspy https://api.waspytech.com/mcp \
  --header "Authorization: Bearer wspy_TU_KEY"

Verificá con claude mcp list. Si aparece como conectado, ya podés pedirle cosas como "usá waspy y decime qué conversaciones esperan respuesta".

ChatGPT y Codex

En ChatGPT, Waspy se instala como complemento: agrupa la app MCP y las dos habilidades (resumen de la bandeja y seguimiento de leads).

1. Andá a Configuración → Complementos.
2. Buscá Waspy y conectalo. Si te pide la URL del servidor, usá https://api.waspytech.com/mcp.
3. En la pantalla de Waspy entrá con tu usuario y elegí la cuenta.
4. En el chat, mencioná @Waspy: "resumen de la bandeja" o "quién está en etapa esperando".

ChatGPT pregunta permisos por nivel, y las herramientas de Waspy vienen marcadas para eso: buscar y leer son lectura; nota interna y mover etapa son acciones de bajo riesgo (no le escriben a nadie); enviar un mensaje o una plantilla es una acción de riesgo y conviene confirmarla siempre.

Codex usa los mismos complementos de ChatGPT: si ya conectaste Waspy con la misma cuenta de OpenAI, Codex lo ve. Si usás Codex desde la terminal, también podés declararlo en ~/.codex/config.toml como servidor Streamable HTTP (referencia de configuración de Codex):

[mcp_servers.waspy]
url = "https://api.waspytech.com/mcp"
bearer_token_env_var = "WASPY_API_KEY"

Y exportás la key antes de abrir Codex: export WASPY_API_KEY=wspy_TU_KEY. El campo guarda el nombre de la variable, no la key.

Cursor

En Settings → MCP agregá un servidor remoto:

{
  "mcpServers": {
    "waspy": {
      "url": "https://api.waspytech.com/mcp",
      "headers": {
        "Authorization": "Bearer wspy_TU_KEY"
      }
    }
  }
}

Si tu versión de Cursor inicia OAuth contra esa URL, podés omitir el bloque headers y entrar por la pantalla de Waspy, sin API key. En la guía oficial del conector está también el botón "Agregar a Cursor".

Grok y n8n

• Grok: acepta un servidor MCP remoto. Configurá la URL https://api.waspytech.com/mcp y autenticá con el OAuth que te ofrezca o con el header Authorization: Bearer wspy_TU_KEY.
• n8n: en el nodo MCP Client, el endpoint es https://api.waspytech.com/mcp y el transporte es Streamable HTTP. En las credenciales mandá el mismo header. Para un flujo que solo lee, creá la key con contacts:read, conversations:read y messages:read.

Probalo con curl antes de conectar nada

El transporte es HTTP con JSON-RPC: cada pedido es un POST (un GET responde 405). Para ver las herramientas que tu key puede usar:

curl -X POST https://api.waspytech.com/mcp \
  -H "Authorization: Bearer wspy_TU_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Y para llamar a una herramienta de solo lectura, por ejemplo el resumen de la bandeja:

curl -X POST https://api.waspytech.com/mcp \
  -H "Authorization: Bearer wspy_TU_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_inbox_summary","arguments":{}}}'

Si la respuesta es 401, la key es inválida, venció o fue revocada. Si es 402, la cuenta está bloqueada por una factura vencida, un pago rechazado o una prueba terminada, y el servidor no ejecuta herramientas hasta que se regularice.

Qué scopes darle según el uso

Regla práctica: empezá con lectura. Sumá messages:write solo cuando ya confiás en cómo trabaja el asistente con tu bandeja, y siempre con confirmación humana antes de cada envío.

Seguridad: qué queda atado y cómo se corta

• Una conexión, una cuenta. El OAuth y la API key quedan atados a una sola cuenta de Waspy. Un argumento tenantId en una herramienta no cambia de cuenta.
• Tokens cortos. El access token de OAuth dura 1 hora; el refresh, 30 días, y se rota en cada uso.
• Cómo se revoca. Una API key se revoca desde el panel. Una conexión OAuth se corta desconectando el complemento o conector en el cliente.
• La ventana de 24 horas sigue mandando. send_message solo funciona si el cliente te escribió en las últimas 24 h; fuera de eso, el asistente tiene que usar send_template con una plantilla aprobada. Lo explicamos en la regla de las 24 horas.

Cuánto cuesta usarlo

El conector no tiene un costo de Meta por leer, buscar o anotar. Lo que se cobra es cada mensaje entregado, igual que si lo mandaras desde el panel. Para destinatarios en Argentina, con la tarifa de Meta vigente desde el 1 de octubre de 2026:

Fuentes: precios de la plataforma de WhatsApp Business y pricing de la Cloud API. El detalle con ejemplos está en precios de la WhatsApp Business API. Waspy no agrega markup: Meta te factura directo.

MCP o API REST: cuál usar

El conector no le empuja eventos al asistente: si necesitás reaccionar a un mensaje nuevo, usá los webhooks de la API hacia tu propio sistema. La API REST está detallada en la página de la API de Waspy, y si querés un ejemplo sin servidor propio, mirá cómo enviar WhatsApp desde Google Sheets con Apps Script.

Si venís de otra plataforma

Si hoy usás una API para desarrolladores que solo te da el envío, el inbox y el CRM los tenés que construir vos. Con Waspy el asistente trabaja sobre la bandeja que ya usa tu equipo. Comparamos costos y alcance en Waspy vs Twilio y Waspy vs 360dialog.

En resumen

• URL del servidor: https://api.waspytech.com/mcp (Streamable HTTP, JSON-RPC por POST).
• Claude, ChatGPT y Codex entran por OAuth; Cursor, Claude Code, Grok y n8n pueden usar una API key wspy_.
• Empezá con scopes de lectura y sumá envíos con confirmación humana.
• Leer no cuesta; cada mensaje entregado lo cobra Meta según su categoría.

¿Querés probarlo con tu bandeja? Creá tu cuenta con 10 días gratis y sin tarjeta, conectá tu número y mirá los planes de Waspy.