Een workspace-endpoint
Een enkel MCP-endpoint dekt je workspace. Projecttools gebruiken project_id om calls af te bakenen.
Functies · MCP-server
Verbind AI-agents met je Ceyo-data .
Verbind MCP-compatibele AI-tools met Ceyo visibility-data, prompts, actions, concurrenten en analytics.
MCP endpoint Ceyo MCP
Zelfde API key
POST /mcp MCP
JSON-RPC 2.0
Wat MCP mogelijk maakt
Geef agents de context om te handelen.
Ceyo MCP laat AI-tools dezelfde projectstatus lezen en gebruiken als je team in het platform, met workspace API key en project_id.
Dezelfde API key
De MCP-server gebruikt dezelfde Ceyo API key als de REST API, via X-Api-Key of Authorization bearer.
Volledige visibility-context
Stel metrics, prompts, LLM-antwoorden, citaties, concurrenten, actions, fan-out queries en analytics beschikbaar.
Workflows klaar voor agents
Verbind Cursor, Claude Desktop, n8n of een generieke MCP-client zodat agents Ceyo-data direct kunnen inspecteren.
01 · Clients
Verbind de AI-tools die je team al gebruikt.
De MCP-docs bevatten setup-paden voor Cursor, Claude Desktop, n8n en generieke MCP-clients. OAuth-gebaseerde remote clients staan als binnenkort gemarkeerd.
- Cursor deeplink. Installeer de Ceyo MCP-server in Cursor en vervang de API key placeholder door een workspace key.
- Claude Desktop. Handmatige lokale configuratie is live via mcp-remote en het Ceyo MCP-endpoint.
- n8n en generieke clients. Gebruik de MCP Client node of kopieer endpoint en X-Api-Key header naar elke compatibele client.
02 · Tooldekking
Stel de projectstatus beschikbaar die GEO-agents nodig hebben.
De MCP-server is meer dan een metrics-endpoint. Agents krijgen gestructureerde toegang tot workspace-, project-, prompt-, action-, concurrent-, suggestie-, fan-out- en analyticsdata.
- Project- en promptintelligentie. Lees projectmetrics, visibility time series, citaties, promptantwoorden, promptcitaties en promptconcurrenten.
- Optimalisatie-actions. List actions, bekijk details en update statussen wanneer schrijfrechten beschikbaar zijn.
- Analytics-context. Gebruik GA4-tools voor overview, conversies, landing pages, referrals en conversion events wanneer gekoppeld.
03 · Protocol en security
Gebouwd op MCP en JSON-RPC met voorspelbare scope.
De server implementeert Model Context Protocol via HTTP met JSON-RPC 2.0. Authenticatie gebeurt voor tool calls en elke projectactie gebruikt project_id.
- MCP-protocol. Ondersteunt initialize, tools/list, tools/call, ping en notifications via een HTTP-endpoint.
- Workspace-authenticatie. Gebruik X-Api-Key of Authorization bearer met je Ceyo workspace API key.
- Duidelijke foutenlagen. HTTP errors, JSON-RPC errors en tool errors hebben elk een aparte vorm voor agents.
Setupflow
Van API key naar agentcontext.
Maak een API key
Maak of hergebruik een workspace API key in Workspace settings, dezelfde credentials als de REST API.
Voeg het endpoint toe
Configureer je MCP-client met het Ceyo MCP-endpoint en geef de API key door via een ondersteunde header.
List projecten
Vraag de agent projecten te listen om de workspace-connectie en beschikbare project IDs te bevestigen.
Call tools
Gebruik project_id scoped calls voor visibility, prompts, actions, concurrenten, fan-out queries en analytics.
MCP-server FAQ.
Workspace- en projecttools voor visibility metrics, prompt tracking, LLM-antwoordanalyse, citaties, concurrenten, actions, fan-out queries, suggesties en GA4 analytics wanneer gekoppeld.
De docs bevatten setup voor Cursor, Claude Desktop, n8n en generieke MCP-clients. ChatGPT en Claude.ai remote setup vereisen OAuth en staan als binnenkort gemarkeerd.
Nee. De MCP-server gebruikt dezelfde Ceyo workspace API key als de REST API, via X-Api-Key of Authorization bearer.
Het endpoint is workspace-scoped via API key. Projecttools accepteren project_id zodat dezelfde MCP-connectie meerdere projecten kan gebruiken.
De meeste tools zijn read tools, maar enkele write tools bestaan, zoals projecten maken, prompts maken en action status bijwerken, afhankelijk van rechten en plan.
Data access voor agents
Breng Ceyo-data naar je AI-tools.
Zie hoe de MCP-server je agents visibility, prompts, concurrenten, actions en analytics laat inspecteren zonder terug te gaan naar het dashboard.