Conectar Waspy con ChatGPT y otros clientes

Waspy expone un servidor MCP remoto. Desde ahí un cliente puede buscar contactos y conversaciones, leer mensajes, anotar, mover la etapa de un contacto y, si lo autorizás, enviar un mensaje o una plantilla. El servidor vive en la API:

https://api.waspytech.com/mcp

El transporte es HTTP con JSON-RPC (Streamable HTTP). No abre una sesión: cada pedido es un POST. Un GET responde 405.

En la pantalla del conector podés Entrar con Google. No hace falta crear una contraseña antes.Si preferís email y contraseña, o tu cuenta entra solo con Apple, creala en el panel: menú de tu usuario (el avatar, abajo a la izquierda) → Mi configuración → Tu cuenta → Crear contraseña (/preferences#cuenta). Si entraste hace un momento, la definís ahí. Si no, Waspy te manda un email para confirmarla. En esa misma pantalla del conector, y en el inicio de sesión, está Olvidé mi contraseña.

Cómo entra

Hay dos formas. Las dos quedan atadas a una sola cuenta de Waspy. Un argumento tenantId en la herramienta no cambia de cuenta. OAuth 2.1 con PKCE. ChatGPT, Claude y Codex lo arrancan solos. Waspy publica el metadata en https://api.waspytech.com/.well-known/oauth-authorization-server y el recurso protegido en https://api.waspytech.com/.well-known/oauth-protected-resource/mcp. El registro de clientes es dinámico (POST /oauth/register). En la pantalla de consentimiento elegís la cuenta y, si el cliente pidió envíos, podés dejar solo lectura y notas. API key. Para Cursor, Grok, n8n o cualquier cliente que mande un header:

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

La key se crea en el panel, en Configuración → API Keys. Si no le ponés scopes, puede hacer todo. Si le ponés scopes, solo esos. templates:write existe en el conector y no en la API REST: crea una plantilla y la manda a revisión de Meta. El access token de OAuth dura 1 hora. El refresh dura 30 días y se rota en cada uso. Para cortar una key, revocala en el panel. Para cortar OAuth, desconectá el complemento en el cliente: el cliente llama a POST /oauth/revoke.

ChatGPT

Buscar Waspy en Configuración → Complementos todavía no funciona. Eso va a estar cuando el directorio de ChatGPT apruebe el complemento. Hasta entonces, creá la app a mano:

Entrá a chatgpt.com/plugins.
Add → Create MCP App.
URL del servidor: https://api.waspytech.com/mcp. Autenticación: OAuth.
En la pantalla de Waspy, entrá con Google o con email y contraseña, y elegí la cuenta. Si el permiso incluye envíos, Solo lectura y notas deja afuera mandar mensajes y crear plantillas.
En el chat, mencioná @Waspy y pedile lo que necesitás. Por ejemplo: “resumen de la bandeja” o “quién está en etapa esperando”.

En los planes Business, Enterprise y Edu, ChatGPT deja leer y escribir. En Pro el conector es solo lectura: podés buscar y leer, pero no anotar, mover la etapa ni enviar. Cuando el directorio lo apruebe, el complemento va a agrupar la app MCP y dos habilidades: el resumen de la bandeja y el seguimiento de leads. El mismo complemento lo va a ver Codex. En Business, Enterprise y Edu, ChatGPT pregunta los permisos por nivel: preguntar siempre, permitir lectura, permitir acciones de bajo riesgo, o permitir todo. Las herramientas de Waspy están marcadas para que encaje:

Acción	Qué ve ChatGPT
Buscar, leer, métricas, `search` y `fetch`	Lectura
Nota interna o mover la etapa	Acción de bajo riesgo. No le escribe a nadie
Enviar mensaje o plantilla a un cliente	Acción de riesgo. Pedile confirmación a la persona
Crear una plantilla	Sale a Meta para revisión. No le escribe a un cliente

Para cortar esa sesión, desconectá la app MCP desde chatgpt.com/plugins. Si habías pegado una API key en otro cliente, revocala aparte en Waspy. La investigación profunda puede usar Waspy como fuente. search devuelve { "results": [{ "id", "title", "url" }] } y fetch devuelve { "id", "title", "text", "url", "metadata" }. La url apunta al contacto o a la conversación en el panel. Al buscar un contacto o abrir una conversación, el chat puede mostrar una tarjeta. Es un resumen para leer: no manda el mensaje. Waspy no le empuja eventos a ChatGPT. Una tarea programada puede llamar a get_inbox_summary. Si necesitás aviso en el momento de un mensaje nuevo o un lead nuevo, usá los webhooks (message.received, contact.created) hacia tu propio sistema. El conector no indexa la bandeja completa en el espacio de trabajo: cada consulta lee la cuenta en el momento.

Claude

En Claude: Customize → Connectors → Add custom connector. Pegá https://api.waspytech.com/mcp. Claude hace el OAuth. Si Use Claude’s identity falla, elegí Register automatically. En el chat vas a ver las mismas herramientas. Las dos habilidades también aparecen como prompts (resumen-diario-bandeja y seguimiento-de-leads).

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 arranca OAuth contra esa URL, podés omitir el header y entrar por la pantalla de Waspy. Es el camino principal: no hace falta una API key.

El mismo enlace en el protocolo de Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=Waspy&config=eyJ1cmwiOiJodHRwczovL2FwaS53YXNweXRlY2guY29tL21jcCJ9. El botón instala el servidor remoto. La pantalla de Waspy pide la cuenta.

Codex

Codex usa lo que conectaste en ChatGPT. Si ya creaste la app MCP con la misma cuenta de OpenAI, Codex la ve. Si no, seguí el paso de ChatGPT: chatgpt.com/plugins → Add → Create MCP App, con la URL https://api.waspytech.com/mcp. Buscar Waspy en Complementos va a estar cuando el directorio lo apruebe.

Grok

Grok acepta un servidor MCP remoto. Configurá la URL https://api.waspytech.com/mcp y autenticá con el flujo OAuth que te ofrezca, o con el header Authorization: Bearer wspy_TU_KEY. No hay un menú distinto dentro de Waspy.

n8n

En el nodo MCP Client, el endpoint es https://api.waspytech.com/mcp y el transporte es Streamable HTTP. En las credenciales, mandá Authorization: Bearer wspy_TU_KEY. Para un flujo que solo lee, creá la key con contacts:read, conversations:read y messages:read.

Qué puede hacer

Herramienta	Para qué
`search_contacts` / `search_conversations`	Buscar en esta cuenta
`get_conversation_messages`	Leer los últimos mensajes
`send_message`	Texto dentro de la ventana de 24 h en WhatsApp
`send_template`	Plantilla de WhatsApp ya aprobada, también fuera de esa ventana
`list_templates` / `create_template`	Ver plantillas, o crear una de texto y mandarla a revisión
`list_tags` / `list_funnel_stages` / `move_contact_stage`	Etiquetas y etapa manual (`etapa:`)
`add_note`	Nota interna. No sale al cliente
`get_metrics` / `get_inbox_summary`	Números y pendientes de la bandeja
`search` / `fetch`	Fuente para investigación profunda

Instagram, Facebook y TikTok se leen igual. El envío de texto libre usa la ventana de cada canal. En TikTok el negocio no escribe primero. Email y chat web no se mandan por el conector. Las conversaciones de grupo no entran. La clasificación caliente, tibio, silencioso o frío la calcula Waspy. move_contact_stage solo cambia la etapa manual. Si la cuenta está bloqueada por una factura vencida, un pago rechazado o una prueba terminada, /mcp responde 402 y no ejecuta herramientas.

​Cómo entra

​ChatGPT

​Claude

​Cursor

​Codex

​Grok

​n8n

​Qué puede hacer