Un endpoint de workspace
Un solo endpoint MCP cubre tu workspace. Cada herramienta de proyecto acepta project_id para acotar la llamada.
Funciones · Servidor MCP
Conecta agentes IA a tus datos de Ceyo .
Conecta herramientas IA compatibles con MCP a visibilidad, prompts, acciones, competidores y analytics de Ceyo.
Endpoint MCP Ceyo MCP
Misma API key
POST /mcp MCP
JSON-RPC 2.0
Qué desbloquea MCP
Da a los agentes el contexto para actuar.
Ceyo MCP permite que las herramientas IA lean y usen el mismo estado de proyecto que tu equipo usa en la plataforma, con API key de workspace y project_id.
La misma API key
El servidor MCP usa la misma API key de Ceyo que la API REST, con cabeceras X-Api-Key o Authorization bearer.
Contexto completo de visibilidad
Expón métricas, prompts, respuestas LLM, citas, competidores, acciones, fan-out queries y analytics.
Workflows listos para agentes
Conecta Cursor, Claude Desktop, n8n o cualquier cliente MCP para que los agentes inspeccionen datos de Ceyo directamente.
01 · Clientes
Conecta las herramientas IA que tu equipo ya usa.
La documentación MCP incluye rutas de configuración para Cursor, Claude Desktop, n8n y clientes MCP genéricos, con clientes remotos OAuth marcados como próximamente.
- Deeplink de Cursor. Instala la entrada del servidor MCP de Ceyo en Cursor y reemplaza el placeholder de API key por una key del workspace.
- Claude Desktop. La configuración local manual ya está disponible con mcp-remote y el endpoint MCP de Ceyo.
- n8n y clientes genéricos. Usa el nodo MCP Client o copia el endpoint y la cabecera X-Api-Key en cualquier cliente compatible.
02 · Cobertura de tools
Expón el estado de proyecto que necesitan los agentes GEO.
El servidor MCP no es solo un endpoint de métricas. Da acceso estructurado a datos de workspace, proyecto, prompts, acciones, competidores, sugerencias, fan-out y analytics.
- Inteligencia de proyecto y prompts. Lee métricas de proyecto, series de visibilidad, citas, respuestas de prompts, citas de prompts y competidores por prompt.
- Acciones de optimización. Lista acciones, revisa el detalle y actualiza estados cuando haya permisos de escritura.
- Contexto de analytics. Usa herramientas con datos GA4 para overview, conversiones, landing pages, referidos y eventos cuando esté conectado.
03 · Protocolo y seguridad
Construido sobre MCP y JSON-RPC con alcance predecible.
El servidor implementa Model Context Protocol sobre HTTP con JSON-RPC 2.0. La autenticación ocurre antes de las tools y cada operación de proyecto usa project_id.
- Protocolo MCP. Soporta initialize, tools/list, tools/call, ping y notificaciones sobre un único endpoint HTTP.
- Autenticación de workspace. Usa X-Api-Key o Authorization bearer con tu API key de workspace de Ceyo.
- Errores claros. Errores HTTP, JSON-RPC y de tools tienen formas distintas para que los agentes los manejen.
Flujo de configuración
De API key a contexto para agentes.
Crea una API key
Crea o reutiliza una API key de workspace desde Settings, las mismas credenciales de la API REST.
Añade el endpoint
Configura tu cliente MCP con el endpoint de Ceyo y pasa la API key en una cabecera aceptada.
Lista proyectos
Pide al agente que liste proyectos para confirmar la conexión del workspace y los IDs disponibles.
Llama tools
Usa llamadas con project_id para revisar visibilidad, prompts, acciones, competidores, fan-out queries y analytics.
Servidor MCP FAQ.
Expone herramientas de workspace y proyecto para métricas de visibilidad, prompts, respuestas LLM, citas, competidores, acciones, fan-out queries, sugerencias y analytics GA4 cuando está conectado.
La documentación incluye configuración para Cursor, Claude Desktop, n8n y clientes MCP genéricos. ChatGPT y Claude.ai remotos requieren OAuth y están marcados como próximamente.
No. Usa la misma API key de workspace de Ceyo que la API REST, enviada con X-Api-Key o Authorization bearer.
El endpoint se acota al workspace por API key. Las tools de proyecto aceptan project_id para trabajar con varios proyectos desde la misma conexión MCP.
La mayoría son herramientas de lectura, pero hay algunas de escritura, como crear proyectos, crear prompts y actualizar estados de acciones, según permisos y plan.
Acceso a datos para agentes
Lleva datos de Ceyo a tus herramientas IA.
Mira cómo el servidor MCP permite que tus agentes inspeccionen visibilidad, prompts, competidores, acciones y analytics sin volver al dashboard.