Un endpoint workspace
Un unico endpoint MCP copre il workspace. Ogni tool di progetto usa project_id per definire lo scope della chiamata.
Funzionalità · Server MCP
Connetti AI agent ai tuoi dati Ceyo .
Connetti tool AI compatibili con MCP a visibilità, prompt, azioni, competitor e analytics di Ceyo.
MCP endpoint Ceyo MCP
Stessa API key
POST /mcp MCP
JSON-RPC 2.0
Cosa abilita MCP
Dai agli agenti il contesto per agire.
Ceyo MCP consente ai tool AI di leggere e usare lo stesso stato progetto che il team usa nella piattaforma, con API key workspace e project_id.
La stessa API key
Il server MCP usa la stessa API key Ceyo della REST API, tramite header X-Api-Key o Authorization bearer.
Contesto completo di visibilità
Espone metriche, prompt, risposte LLM, citazioni, competitor, azioni, fan-out query e analytics.
Workflow pronti per agenti
Connetti Cursor, Claude Desktop, n8n o un client MCP generico perché gli agenti possano leggere direttamente i dati Ceyo.
01 · Client
Connetti i tool AI che il tuo team usa già.
La documentazione MCP include percorsi di setup per Cursor, Claude Desktop, n8n e client MCP generici. I client remoti basati su OAuth sono indicati come in arrivo.
- Deeplink Cursor. Installa la voce del server MCP Ceyo in Cursor e sostituisci il placeholder della API key con una key workspace.
- Claude Desktop. La configurazione locale manuale è già disponibile con mcp-remote e l’endpoint MCP Ceyo.
- n8n e client generici. Usa il nodo MCP Client o copia endpoint e header X-Api-Key in qualsiasi client compatibile.
02 · Copertura tool
Espone lo stato progetto necessario agli agenti GEO.
Il server MCP non è solo un endpoint di metriche. Offre accesso strutturato a dati di workspace, progetto, prompt, azioni, competitor, suggerimenti, fan-out e analytics.
- Intelligence su progetto e prompt. Leggi metriche di progetto, serie storiche di visibilità, citazioni, risposte prompt, citazioni prompt e competitor per prompt.
- Azioni di ottimizzazione. Elenca azioni, controlla i dettagli e aggiorna lo stato quando sono disponibili permessi di scrittura.
- Contesto analytics. Usa tool basati su GA4 per overview, conversioni, landing page, referral ed eventi quando connesso.
03 · Protocollo e sicurezza
Basato su MCP e JSON-RPC con scope prevedibile.
Il server implementa Model Context Protocol su HTTP con JSON-RPC 2.0. L’autenticazione avviene prima delle tool call e ogni operazione progetto usa project_id.
- Protocollo MCP. Supporta initialize, tools/list, tools/call, ping e notifiche su un solo endpoint HTTP.
- Autenticazione workspace. Usa X-Api-Key o Authorization bearer con la tua API key workspace Ceyo.
- Livelli di errore chiari. Errori HTTP, JSON-RPC e tool hanno forme diverse che gli agenti possono gestire.
Flusso di setup
Da API key a contesto agenti.
Crea una API key
Crea o riusa una API key workspace dalle impostazioni, le stesse credenziali della REST API.
Aggiungi l’endpoint
Configura il client MCP con l’endpoint Ceyo e passa la API key tramite un header supportato.
Elenca i progetti
Chiedi all’agente di elencare i progetti per confermare connessione e project ID disponibili.
Chiama i tools
Usa chiamate con project_id per ispezionare visibilità, prompt, azioni, competitor, fan-out query e analytics.
Server MCP FAQ.
Espone tool workspace e progetto per metriche di visibilità, prompt tracking, risposte LLM, citazioni, competitor, azioni, fan-out query, suggerimenti e analytics GA4 quando connesso.
La documentazione include setup per Cursor, Claude Desktop, n8n e client MCP generici. ChatGPT e Claude.ai remoti richiedono OAuth e sono indicati come in arrivo.
No. Usa la stessa API key workspace Ceyo della REST API, inviata con X-Api-Key o Authorization bearer.
L’endpoint è scoped al workspace tramite API key. I tool di progetto accettano project_id così una connessione MCP può lavorare su più progetti.
La maggior parte sono tool di lettura, ma esistono alcuni tool di scrittura, come creare progetti, creare prompt e aggiornare stati azione, in base a permessi e piano.
Accesso dati per agenti
Porta i dati Ceyo nei tuoi tool AI.
Scopri come il server MCP permette agli agenti di ispezionare visibilità, prompt, competitor, azioni e analytics senza tornare alla dashboard.