Ein Workspace-Endpunkt
Ein MCP-Endpunkt deckt den Workspace ab. Projekttools nutzen project_id zur Eingrenzung.
Funktionen · MCP-Server
Verbinden Sie AI Agents mit Ihren Ceyo-Daten .
Verbinden Sie MCP-kompatible AI-Tools mit Ceyo Visibility-Daten, Prompts, Actions, Wettbewerbern und Analytics.
MCP endpoint Ceyo MCP
Gleicher API-Key
POST /mcp MCP
JSON-RPC 2.0
Was MCP ermöglicht
Geben Sie Agents den Kontext zum Handeln.
Ceyo MCP lässt AI-Tools denselben Projektstatus lesen und nutzen wie Ihr Team in der Plattform, mit Workspace-API-Key und project_id.
Derselbe API-Key
Der MCP-Server nutzt denselben Ceyo API-Key wie die REST API, über X-Api-Key oder Authorization bearer.
Vollständiger Visibility-Kontext
Metriken, Prompts, LLM-Antworten, Zitate, Wettbewerber, Actions, Fan-out Queries und Analytics verfügbar machen.
Workflows für Agents
Verbinden Sie Cursor, Claude Desktop, n8n oder generische MCP-Clients, damit Agents Ceyo-Daten direkt prüfen können.
01 · Clients
Verbinden Sie die AI-Tools, die Ihr Team bereits nutzt.
Die MCP-Doku enthält Setups für Cursor, Claude Desktop, n8n und generische MCP-Clients. OAuth-basierte Remote-Clients sind als demnächst markiert.
- Cursor Deeplink. Installieren Sie den Ceyo MCP-Server in Cursor und ersetzen Sie den API-Key-Platzhalter durch einen Workspace-Key.
- Claude Desktop. Manuelle lokale Konfiguration ist über mcp-remote und den Ceyo MCP-Endpunkt verfügbar.
- n8n und generische Clients. Nutzen Sie den MCP Client Node oder kopieren Sie Endpunkt und X-Api-Key Header in jeden kompatiblen Client.
02 · Tool-Abdeckung
Stellen Sie den Projektstatus bereit, den GEO-Agents brauchen.
Der MCP-Server ist mehr als ein Metrik-Endpunkt. Agents erhalten strukturierten Zugriff auf Workspace-, Projekt-, Prompt-, Action-, Wettbewerber-, Vorschlags-, Fan-out- und Analytics-Daten.
- Projekt- und Prompt-Intelligence. Lesen Sie Projektmetriken, Visibility Time Series, Zitate, Prompt-Antworten, Prompt-Zitate und Prompt-Wettbewerber.
- Optimierungs-Actions. Actions auflisten, Details prüfen und Status aktualisieren, wenn Schreibrechte verfügbar sind.
- Analytics-Kontext. GA4-Tools für Overview, Conversions, Landing Pages, Referrals und Conversion Events nutzen, wenn verbunden.
03 · Protokoll und Sicherheit
Auf MCP und JSON-RPC mit klarer Scope gebaut.
Der Server implementiert Model Context Protocol über HTTP mit JSON-RPC 2.0. Authentifizierung erfolgt vor Tool Calls, jede Projektoperation nutzt project_id.
- MCP-Protokoll. Unterstützt initialize, tools/list, tools/call, ping und Notifications über einen HTTP-Endpunkt.
- Workspace-Authentifizierung. Nutzen Sie X-Api-Key oder Authorization bearer mit Ihrem Ceyo Workspace API-Key.
- Klare Fehlerebenen. HTTP-, JSON-RPC- und Tool-Fehler haben eigene Formen für Agents.
Setup-Ablauf
Vom API-Key zu Agent-Kontext.
API-Key erstellen
Erstellen oder verwenden Sie einen Workspace API-Key aus den Workspace Settings, dieselben Credentials wie bei der REST API.
Endpunkt hinzufügen
Konfigurieren Sie den MCP-Client mit dem Ceyo MCP-Endpunkt und übergeben Sie den API-Key per unterstütztem Header.
Projekte listen
Bitten Sie den Agent, Projekte zu listen, um Verbindung und Projekt-IDs zu bestätigen.
Tools aufrufen
Nutzen Sie project_id scoped Calls für Visibility, Prompts, Actions, Wettbewerber, Fan-out Queries und Analytics.
MCP-Server FAQ.
Workspace- und Projekttools für Visibility-Metriken, Prompt Tracking, LLM-Antworten, Zitate, Wettbewerber, Actions, Fan-out Queries, Vorschläge und GA4 Analytics, wenn verbunden.
Die Doku enthält Setups für Cursor, Claude Desktop, n8n und generische MCP-Clients. ChatGPT und Claude.ai Remote Setup benötigen OAuth und sind als demnächst markiert.
Nein. Der MCP-Server nutzt denselben Ceyo Workspace API-Key wie die REST API, über X-Api-Key oder Authorization bearer.
Der Endpunkt ist per API-Key Workspace-scoped. Projekttools akzeptieren project_id, sodass eine MCP-Verbindung mehrere Projekte nutzen kann.
Die meisten Tools sind read tools, aber ausgewählte write tools existieren, etwa Projekte erstellen, Prompts erstellen und Action Status aktualisieren, abhängig von Rechten und Plan.
Datenzugriff für Agents
Bringen Sie Ceyo-Daten in Ihre AI-Tools.
Sehen Sie, wie der MCP-Server Agents Visibility, Prompts, Wettbewerber, Actions und Analytics prüfen lässt, ohne ins Dashboard zu wechseln.