Integração MCP
A Finseo disponibiliza um servidor Model Context Protocol (MCP) que permite aos assistentes de IA consultar os seus dados de visibilidade diretamente.O que é o MCP?
O MCP (Model Context Protocol) é um standard para ligar modelos de IA a fontes de dados externas. Com o servidor MCP da Finseo, pode fazer perguntas naturais ao Claude, ChatGPT ou Cursor sobre a sua visibilidade em IA sem escrever código. Exemplo: Abra o Claude e pergunte:“Como é que a visibilidade da minha marca mudou nos últimos 30 dias? Que concorrentes estão à minha frente?”O Claude consulta automaticamente os seus dados da Finseo e fornece a análise.
Guias de configuração
- Claude (claude.ai, Desktop, Code) — OAuth, sem necessidade de API key
- ChatGPT (developer mode) — OAuth, sem necessidade de API key
- Cursor — API key via headers
Autenticação
O servidor MCP suporta dois métodos de autenticação:Ferramentas disponíveis
Todas as ferramentas são read-only — obtêm dados e nunca os modificam.
As ferramentas de analytics aceitam filtros opcionais de
model (por exemplo chatgpt, perplexity, ai_overview, gemini, grok) e tags — os mesmos filtros que o dashboard.
Definições das métricas
As ferramentas devolvem os mesmos números que o dashboard da Finseo e identificam-nos explicitamente:visibilityRatePercent— quota das respostas de IA analisadas que mencionam a sua marca (o KPI “Visibility” do dashboard)promptCoveragePercent— quota dos prompts rastreados com pelo menos uma menção (um número diferente, normalmente mais alto)ownDomainCitations.total— respostas de IA que citam o seu próprio domínio como fonte (o KPI “Citations” do dashboard)
Endpoint
initialize, tools/list e tools/call. Os pedidos não autenticados recebem um 401 com metadados de discovery OAuth de acordo com a spec de autorização do MCP (RFC 9728).