> ## Documentation Index > Fetch the complete documentation index at: https://docs.waspytech.com/llms.txt > Use this file to discover all available pages before exploring further. # Conectar Waspy con ChatGPT y otros clientes > Cómo conectar la bandeja y el CRM de Waspy en ChatGPT, Claude, Cursor, Codex, Grok y n8n. 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: ```bash theme={null} 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: 1. Entrá a [chatgpt.com/plugins](https://chatgpt.com/plugins). 2. **Add → Create MCP App**. 3. URL del servidor: `https://api.waspytech.com/mcp`. Autenticación: **OAuth**. 4. 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. 5. 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](https://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](/webhooks/events) (`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: ```json theme={null} { "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. [![Agregar a Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=Waspy\&config=eyJ1cmwiOiJodHRwczovL2FwaS53YXNweXRlY2guY29tL21jcCJ9) 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](https://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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.