Um endpoint de workspace
Um único endpoint MCP cobre o workspace. Cada ferramenta de projeto usa project_id para limitar a chamada.
Recursos · Servidor MCP
Conecte agentes de IA aos seus dados da Ceyo .
Conecte ferramentas IA compatíveis com MCP a visibilidade, prompts, ações, concorrentes e analytics da Ceyo.
MCP endpoint Ceyo MCP
Mesma API key
POST /mcp MCP
JSON-RPC 2.0
O que MCP libera
Dê aos agentes o contexto para agir.
Ceyo MCP permite que ferramentas IA leiam e usem o mesmo estado de projeto da plataforma, com API key de workspace e project_id.
A mesma API key
O servidor MCP usa a mesma API key da Ceyo que a REST API, por headers X-Api-Key ou Authorization bearer.
Contexto completo de visibilidade
Exponha métricas, prompts, respostas LLM, citações, concorrentes, ações, fan-out queries e analytics.
Workflows prontos para agentes
Conecte Cursor, Claude Desktop, n8n ou cliente MCP genérico para agentes inspecionarem dados da Ceyo diretamente.
01 · Clientes
Conecte as ferramentas IA que sua equipe já usa.
A documentação MCP inclui caminhos de configuração para Cursor, Claude Desktop, n8n e clientes MCP genéricos. Clientes remotos OAuth aparecem como em breve.
- Deeplink Cursor. Instale a entrada do servidor MCP da Ceyo no Cursor e troque o placeholder da API key por uma key do workspace.
- Claude Desktop. A configuração local manual já está disponível com mcp-remote e o endpoint MCP da Ceyo.
- n8n e clientes genéricos. Use o node MCP Client ou copie endpoint e header X-Api-Key para qualquer cliente compatível.
02 · Cobertura de tools
Exponha o estado de projeto que agentes GEO precisam.
O servidor MCP não é só um endpoint de métricas. Ele dá acesso estruturado a dados de workspace, projeto, prompts, ações, concorrentes, sugestões, fan-out e analytics.
- Inteligência de projeto e prompts. Leia métricas de projeto, séries de visibilidade, citações, respostas de prompts, citações de prompts e concorrentes por prompt.
- Ações de otimização. Liste ações, veja detalhes e atualize status quando permissões de escrita estiverem disponíveis.
- Contexto de analytics. Use ferramentas GA4 para overview, conversões, landing pages, referências e eventos quando conectado.
03 · Protocolo e segurança
Criado em MCP e JSON-RPC com escopo previsível.
O servidor implementa Model Context Protocol via HTTP com JSON-RPC 2.0. A autenticação vem antes das tool calls e cada operação de projeto usa project_id.
- Protocolo MCP. Suporta initialize, tools/list, tools/call, ping e notificações em um único endpoint HTTP.
- Autenticação de workspace. Use X-Api-Key ou Authorization bearer com sua API key de workspace da Ceyo.
- Camadas de erro claras. Erros HTTP, JSON-RPC e de tools têm formatos distintos para agentes lidarem.
Fluxo de configuração
De API key a contexto para agentes.
Crie uma API key
Crie ou reutilize uma API key de workspace em Settings, as mesmas credenciais da REST API.
Adicione o endpoint
Configure o cliente MCP com o endpoint da Ceyo e envie a API key por um header aceito.
Liste projetos
Peça ao agente para listar projetos e confirmar a conexão e os project IDs disponíveis.
Chame tools
Use chamadas com project_id para revisar visibilidade, prompts, ações, concorrentes, fan-out queries e analytics.
Servidor MCP FAQ.
Expõe ferramentas de workspace e projeto para métricas de visibilidade, prompt tracking, respostas LLM, citações, concorrentes, ações, fan-out queries, sugestões e analytics GA4 quando conectado.
A documentação inclui setup para Cursor, Claude Desktop, n8n e clientes MCP genéricos. ChatGPT e Claude.ai remotos exigem OAuth e aparecem como em breve.
Não. Usa a mesma API key de workspace da Ceyo que a REST API, enviada com X-Api-Key ou Authorization bearer.
O endpoint é scoped ao workspace pela API key. Ferramentas de projeto aceitam project_id para a mesma conexão MCP trabalhar em vários projetos.
A maioria são ferramentas de leitura, mas algumas ferramentas de escrita existem, como criar projetos, criar prompts e atualizar status de ações, conforme permissões e plano.
Acesso a dados para agentes
Leve dados da Ceyo para suas ferramentas IA.
Veja como o servidor MCP permite que agentes inspecionem visibilidade, prompts, concorrentes, ações e analytics sem voltar ao dashboard.