MCP — Conectar Pymaia a Claude / ChatGPT

El MCP (Model Context Protocol) te deja usar tus datos de Pymaia desde un cliente de IA como Claude, ChatGPT, Codex o Cursor: preguntás en el chat y responde con tu información real (ventas, ads, campañas, tareas), y puede proponer acciones.

Qué es MCP

Es un estándar que conecta un cliente de IA con herramientas y datos externos. Pymaia corre un servidor MCP en https://api.pymaia.com/mcp que expone 269 herramientas para consultar tus métricas y operar sobre tu cuenta. Cuántas ve tu conexión depende de tres cosas: los módulos que tenga tu organización, los permisos de la credencial y —si entraste por OAuth— tu rol.

Conectar

OAuth es el camino primario. No genera ninguna credencial que después haya que cuidar: autorizás con tu cuenta de Pymaia, elegís la organización, y el acceso queda atado a tu rol.

• Desde el chat (claude.ai, ChatGPT, Claude Desktop): pegás https://api.pymaia.com/mcp como conector y autorizás. Guía paso a paso: Usar Pymaia desde tu chat.
• Desde la terminal (Claude Code, Codex, Cursor, n8n): claude mcp add --transport http pymaia https://api.pymaia.com/mcp y después /mcp → Authenticate. Guía completa: Usar Pymaia desde tu terminal.

API keys para lo que corre sin una persona adelante (n8n, cron, CI): se generan en Ajustes → Conectores IA, con los scopes que le quieras dar. En esa misma pantalla está el snippet listo para pegar según el cliente, y ahí se revocan tanto las keys como las conexiones OAuth activas.

Descubrimiento OAuth

El servidor implementa OAuth 2.1 con PKCE y registro dinámico de clientes. Los metadatos son públicos, por si tu cliente los necesita a mano:

• Recurso protegido (PRM): https://api.pymaia.com/.well-known/oauth-protected-resource — declara el authorization_servers.
• Servidor de autorización (AS): https://api.pymaia.com/.well-known/oauth-authorization-server — endpoints, scopes_supported y code_challenge_methods_supported (S256).

Un 401 del endpoint MCP devuelve el header WWW-Authenticate con el resource_metadata que el cliente necesita para arrancar la autorización.

Nota

Los pasos exactos de la UI del cliente pueden variar según la versión. Si te trabás, escribinos desde Ayuda en la app o a info@pymaia.com.

Seguridad

• Las credenciales están scopeadas a tu organización y a los permisos elegidos: sólo acceden a tus datos.
• Menor privilegio por rol en OAuth: sólo un admin o el owner puede otorgarle a un conector externo permisos de escritura o de aprobación. El resto conecta en sólo lectura.
• Vigencia: el token de acceso dura 1 hora; el de refresco, 30 días. Se revocan desde Ajustes → Conectores IA con efecto inmediato.
• Algunas herramientas no existen desde una conexión OAuth (aprobar o rechazar acciones, gestión de miembros y accesos, desconectar plataformas, webhooks salientes): son operaciones de la app, no de un chat.
• Las acciones que modifican tus plataformas siguen pasando por el Trust Layer (aprobación humana).
• Qué se registra de cada llamada y por cuánto tiempo, en la Política de Privacidad (sección 9).

Qué podés hacer

Consultar ventas y tienda, performance de ads (Meta/Google), analytics, email, tareas y recomendaciones; gestionar alertas; correr agentes; generar reportes; y proponer acciones sobre tus plataformas, que se aprueban en la app. Para el detalle de scopes y el endpoint REST, ver API y Scopes y permisos.