DevDome Analytics

npx add-mcp 'https://analytics.devdome.com/mcp'

1URL, sem instalação

10ferramentas, de estatísticas à saúde do site

9clientes documentados abaixo

0dados armazenados do nosso lado

O servidor é um proxy sem estado sobre sua conta em https://analytics.devdome.com/mcp. Cada resposta vem diretamente dos seus dados ao vivo, limitados à sua chave de API. Os mesmos dados estão disponíveis como uma API REST simples.

01

Obtenha sua chave de API

Uma chave por conta, criada em Conta → API. Ela é exibida apenas uma vez — copie-a imediatamente. O transporte preferido é o cabeçalho Authorization: Bearer; clientes que não podem enviar cabeçalhos acrescentam ?key=YOUR_API_KEY à URL (trate essa URL como um segredo).

02

Conecte seu cliente

Escolha o seu — cada cartão é a configuração completa.

Claude Code

Terminal

Um comando no seu terminal:

claude mcp add devdome https://analytics.devdome.com/mcp \
  -t http -H "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

Arquivo de configuração

Configurações, Desenvolvedor, Editar Config. Adicione isso ao claude_desktop_config.json e reinicie o aplicativo:

{
  "mcpServers": {
    "devdome": {
      "url": "https://analytics.devdome.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude.ai (web)

No navegador

Configurações, Conectores, Adicionar conector personalizado. O diálogo não pode enviar cabeçalhos, então a chave vai na URL:

https://analytics.devdome.com/mcp?key=YOUR_API_KEY

Cursor

Arquivo de configuração

Configurações, MCP, Adicionar novo servidor MCP global (ou .cursor/mcp.json em um projeto):

{
  "mcpServers": {
    "devdome": {
      "url": "https://analytics.devdome.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Windsurf

Arquivo de configuração

Configurações, Cascade, Servidores MCP (ou ~/.codeium/windsurf/mcp_config.json — observe serverUrl):

{
  "mcpServers": {
    "devdome": {
      "serverUrl": "https://analytics.devdome.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code (Copilot)

Arquivo de configuração

Paleta de comandos, "MCP: Adicionar Servidor", HTTP — ou .vscode/mcp.json:

{
  "servers": {
    "devdome": {
      "type": "http",
      "url": "https://analytics.devdome.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

ChatGPT

No navegador

Configurações, Conectores, Avançado, Modo desenvolvedor, depois Criar conector. O ChatGPT não pode enviar cabeçalhos personalizados, então a chave vai na URL:

https://analytics.devdome.com/mcp?key=YOUR_API_KEY

Zed

Arquivo de configuração

settings.json, context_servers:

{
  "context_servers": {
    "devdome": {
      "source": "custom",
      "url": "https://analytics.devdome.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Qualquer outro cliente MCP

Terminal

HTTP streamable simples, sem OAuth, sem sessão. Prove que funciona com curl:

curl https://analytics.devdome.com/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

03

O que ele pode fazer

Dez ferramentas, cada uma mapeada 1:1 para um relatório do painel. Os argumentos de tempo usam como padrão todo o histórico que seu plano retém.

Ferramenta	Argumentos	O que responde
list_sites	none	Os sites na sua conta com status de verificação.
add_site	domain	Adicionar um site. Retorna o snippet de rastreamento; fica pendente até ser verificado.
verify_site	domain	Verificar um site pendente (snippet instalado ou registro DNS TXT).
get_stats	site, days? | from?/to?	KPIs principais em comparação com o período anterior.
get_timeseries	site, days? | from?/to?	Série diária de tráfego no fuso horário do site.
get_breakdown	site, dimension, days?, limit?	Top-N por páginas, referenciadores, países, dispositivos, navegadores, SO, datas, palavras-chave, produtos ou redirecionamentos.
get_bot_report	site, kind?, days?	Quais bots acessaram o site e por que foram sinalizados; tipo "threats" = totais por categoria de detecção.
get_realtime	site	Visitantes ativos nos últimos 5 minutos com a página atual.
get_visitors	site, days?, limit?	Visitas individuais recentes com caminhos passo a passo.
get_site_health	site	Uptime, tempos de resposta, verificações TLS/DNS e incidentes.

Perguntas para fazer

Depois de conectado, tudo isso funciona imediatamente:

• "Como foi meu tráfego esta semana comparado à semana passada?"
• "Quais páginas tiveram mais visitantes este mês, e quais delas estão quebradas?"
• "Quais bots acessaram example.com ontem, e quanto do meu tráfego é de bots?"
• "De onde vêm meus visitantes — principais referenciadores e países nos últimos 90 dias?"
• "Tem alguém no meu site agora? O que estão vendo?"
• "Adicione newsite.com à minha conta DevDome e me dê o snippet para instalar."
• "Meu site está saudável? Houve algum incidente de indisponibilidade este mês?"
• "Escreva um relatório semanal de tráfego que eu possa colar no Slack."

Solução de problemas

As quatro coisas que podem dar errado e suas correções.

• 401 chave de API inválida: a chave foi digitada errada, revogada ou rotacionada. Copie uma nova em Conta, API.
• 429 limite de taxa: 60 requisições por minuto por chave. Assistentes que fazem muitas chamadas de ferramentas podem atingir isso; é redefinido em um minuto.
• "não é seu site": o argumento do site deve ser um domínio NESTA conta, em punycode para nomes internacionais (münchen.de = xn--mnchen-3ya.de). Peça ao assistente para executar list_sites primeiro.
• Cliente não consegue conectar: o servidor responde a POST com JSON-RPC apenas — sem OAuth, sem sessão. Verifique com o exemplo de curl acima e depois confira se seu cliente usa o transporte HTTP.