CitedSpy

Conecte ferramentas de IA como Claude, Cursor e Codex diretamente ao seu espaço de trabalho CitedSpy com o Model Context Protocol (MCP). Uma vez conectado, seu assistente de IA pode ler suas marcas, prompts, execuções, citações e análises - e criar prompts ou acionar execuções - sem que você copie dados de um lado para o outro.

O que você pode fazer

• Peça seu painel de visibilidade de IA em linguagem simples
• Encontre seus prompts e mecanismos mais fracos
• Crie e edite prompts de rastreamento pelo chat
• Acione novas execuções em todos os mecanismos
• Traga citações, menções e relatórios para o seu fluxo de trabalho de IA

Pré-requisitos

• Uma conta CitedSpy em um plano com acesso à API (Growth ou Pro)
• Uma chave de API CitedSpy
• Um cliente de IA compatível com MCP (Claude, Cursor, Codex, etc.)

A URL do servidor MCP do CitedSpy é:

https://mcp.citedspy.com/mcp

Etapa 1 - Criar uma chave de API

1. Faça login em app.citedspy.com.
2. Vá para Configurações > Chaves de API.
3. Clique em Nova Chave de API, dê um nome (por exemplo, "Claude MCP") e copie a chave.

Sua chave começa com cspy_ e é mostrada apenas uma vez. As chaves de API estão disponíveis nos planos Growth e Pro.

Etapa 2 - Conecte sua ferramenta de IA

Escolha sua ferramenta abaixo. Cada ferramenta aponta para a mesma URL do servidor (https://mcp.citedspy.com/mcp) e termina com a mesma autorização única na Etapa 3.

Claude Code (CLI)

Execute isto no seu terminal:

claude mcp add --transport http citedspy https://mcp.citedspy.com/mcp

Em seguida, inicie o Claude Code, execute /mcp, escolha citedspy e autorize.

Claude Desktop

1. Abra Configurações > Conectores > Adicionar conector personalizado.
2. Dê o nome CitedSpy e cole a URL https://mcp.citedspy.com/mcp.
3. Clique em Adicionar e depois em Conectar para autorizar.

Gemini CLI

Execute:

gemini mcp add --transport http citedspy https://mcp.citedspy.com/mcp

Reinicie o Gemini CLI, execute /mcp e siga o prompt para autorizar citedspy. Se a sua versão não tiver o comando mcp add, adicione o servidor a ~/.gemini/settings.json em vez disso:

{
  "mcpServers": {
    "citedspy": {
      "httpUrl": "https://mcp.citedspy.com/mcp"
    }
  }
}

Codex (CLI e Desktop)

Adicione isto a ~/.codex/config.toml:

[features]
experimental_use_rmcp_client = true

[mcp_servers.citedspy]
url = "https://mcp.citedspy.com/mcp"

Em seguida, autorize pelo terminal:

codex mcp login citedspy

O recurso rmcp_client é necessário para servidores remotos que usam login (OAuth), como o CitedSpy.

Cursor

Adicione o servidor a ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto):

{
  "mcpServers": {
    "citedspy": {
      "url": "https://mcp.citedspy.com/mcp"
    }
  }
}

O Cursor abre seu navegador para autorizar na primeira vez que o servidor for usado.

Qualquer outro cliente MCP

Qualquer ferramenta que suporte servidores MCP remotos (HTTP streamable) funciona. Adicione um novo servidor com a URL https://mcp.citedspy.com/mcp e conclua a autorização na Etapa 3.

Etapa 3 - Autorizar o CitedSpy

Na primeira vez que você conectar, sua ferramenta de IA abrirá uma página de autorização do CitedSpy no seu navegador. Cole sua chave de API, confirme a conexão e volte para sua ferramenta de IA. O CitedSpy valida a chave antes que a conexão seja criada e nunca a expõe à ferramenta de IA. Você só faz isso uma vez por ferramenta.

Exemplos de prompts

List all the brands in my CitedSpy workspace.

Show the visibility dashboard for my main brand over the last 30 days.

Create a comparison prompt for my brand against its top two competitors, then trigger a run.

Ações disponíveis

Ação	O que faz
ping	Valida sua chave e mostra seu espaço de trabalho e plano
list_brands / get_brand	Lê marcas e seus concorrentes
list_prompts / get_prompt / get_prompt_report	Lê prompts e relatórios completos de análise
create_prompt / update_prompt / delete_prompt	Gerencia prompts de rastreamento
list_runs / get_run / trigger_run	Lê execuções e enfileira novas
list_competitors	Lê concorrentes de uma marca
get_dashboard	Lê métricas calculadas do painel
list_citations / list_mentions	Lê citações e menções detectadas
list_engines	Lê mecanismos e sua seleção ligado/desligado
call_citedspy_v1	Chama qualquer endpoint da API diretamente

Segurança

Sua chave de API autoriza o acesso MCP - trate-a como uma senha. O MCP pode criar, atualizar e excluir prompts e acionar execuções, então conecte apenas ferramentas de IA em que você confia. Para revogar o acesso, desconecte o servidor na sua ferramenta de IA ou exclua a chave em Configurações > Chaves de API.

Solução de problemas

"Chave de API inválida" - Copie a chave completa incluindo o prefixo cspy_, sem espaços extras.

"O plano não inclui acesso MCP" - O MCP requer o plano Growth ou Pro. Faça upgrade e reconecte.

A ferramenta de IA não consegue ver as ações do CitedSpy - Confirme se a URL é exatamente https://mcp.citedspy.com/mcp, depois desconecte e reconecte.

Precisa de ajuda? Entre em contato conosco em citedspy.com/contact.