Un endpoint workspace
Un seul endpoint MCP couvre le workspace. Chaque outil projet utilise project_id pour cadrer l’appel.
Fonctionnalités · Serveur MCP
Connectez les agents IA à vos données Ceyo .
Connectez les outils IA compatibles MCP à la visibilité, aux prompts, actions, concurrents et analytics Ceyo.
MCP endpoint Ceyo MCP
Même clé API
POST /mcp MCP
JSON-RPC 2.0
Ce que MCP débloque
Donnez aux agents le contexte pour agir.
Ceyo MCP permet aux outils IA de lire et utiliser le même état projet que votre équipe dans la plateforme, avec clé API workspace et project_id.
La même clé API
Le serveur MCP utilise la même clé API Ceyo que la REST API, via les headers X-Api-Key ou Authorization bearer.
Contexte complet de visibilité
Exposez métriques, prompts, réponses LLM, citations, concurrents, actions, fan-out queries et analytics.
Workflows prêts pour agents
Connectez Cursor, Claude Desktop, n8n ou un client MCP générique pour que les agents inspectent directement les données Ceyo.
01 · Clients
Connectez les outils IA que votre équipe utilise déjà.
La documentation MCP inclut des chemins de configuration pour Cursor, Claude Desktop, n8n et clients MCP génériques. Les clients distants OAuth sont indiqués comme bientôt disponibles.
- Deeplink Cursor. Installez l’entrée du serveur MCP Ceyo dans Cursor puis remplacez le placeholder de clé API par une clé workspace.
- Claude Desktop. La configuration locale manuelle est disponible avec mcp-remote et l’endpoint MCP Ceyo.
- n8n et clients génériques. Utilisez le node MCP Client ou copiez l’endpoint et le header X-Api-Key dans tout client compatible.
02 · Couverture des tools
Exposez l’état projet dont les agents GEO ont besoin.
Le serveur MCP n’est pas seulement un endpoint de métriques. Il donne accès aux données workspace, projet, prompts, actions, concurrents, suggestions, fan-out et analytics.
- Intelligence projet et prompts. Lisez métriques projet, séries de visibilité, citations, réponses de prompts, citations de prompts et concurrents par prompt.
- Actions d’optimisation. Listez les actions, inspectez le détail et mettez à jour le statut quand les droits d’écriture sont disponibles.
- Contexte analytics. Utilisez les outils GA4 pour overview, conversions, landing pages, referrals et événements quand connecté.
03 · Protocole et sécurité
Basé sur MCP et JSON-RPC avec un scope prévisible.
Le serveur implémente Model Context Protocol sur HTTP avec JSON-RPC 2.0. L’authentification précède les tool calls et chaque opération projet utilise project_id.
- Protocole MCP. Prend en charge initialize, tools/list, tools/call, ping et notifications sur un seul endpoint HTTP.
- Authentification workspace. Utilisez X-Api-Key ou Authorization bearer avec votre clé API workspace Ceyo.
- Couches d’erreur claires. Les erreurs HTTP, JSON-RPC et tool ont chacune une forme distincte pour les agents.
Flux de configuration
De clé API à contexte agent.
Créez une clé API
Créez ou réutilisez une clé API workspace depuis les paramètres, les mêmes identifiants que la REST API.
Ajoutez l’endpoint
Configurez le client MCP avec l’endpoint Ceyo et transmettez la clé API via un header accepté.
Listez les projets
Demandez à l’agent de lister les projets pour confirmer la connexion et les project IDs disponibles.
Appelez les tools
Utilisez des appels scoped par project_id pour visibilité, prompts, actions, concurrents, fan-out queries et analytics.
Serveur MCP FAQ.
Il expose des outils workspace et projet pour métriques de visibilité, suivi des prompts, réponses LLM, citations, concurrents, actions, fan-out queries, suggestions et analytics GA4 quand connecté.
La documentation couvre Cursor, Claude Desktop, n8n et clients MCP génériques. ChatGPT et Claude.ai distants nécessitent OAuth et sont indiqués comme bientôt disponibles.
Non. Il utilise la même clé API workspace Ceyo que la REST API, envoyée avec X-Api-Key ou Authorization bearer.
L’endpoint est scoped au workspace par clé API. Les outils projet acceptent project_id, donc une connexion MCP peut couvrir plusieurs projets.
La plupart des outils sont en lecture, mais certains outils d’écriture existent, comme créer des projets, créer des prompts et mettre à jour le statut des actions selon permissions et plan.
Accès aux données pour agents
Apportez les données Ceyo dans vos outils IA.
Découvrez comment le serveur MCP permet aux agents d’inspecter visibilité, prompts, concurrents, actions et analytics sans revenir au dashboard.