Ligar um assistente de IA (MCP)

O Model Context Protocol (MCP) permite que assistentes de IA utilizem os seus dados do Statsdot. Uma vez ligado, pode fazer perguntas como "Que páginas trouxeram mais visitantes do Google na semana passada?" ou "Compare setembro com agosto para shop.example.com" e o assistente lê os números do Statsdot.

O endereço do servidor é https://statsdot.com/api/mcp. O Claude e o ChatGPT ligam-se através de OAuth: inicia sessão no Statsdot e aprova a ligação. Ferramentas de desenvolvimento como o Claude Code, Cursor e Codex utilizam os mesmos tokens de acesso pessoal da API REST.

Claude e ChatGPT (OAuth)

Claude

No Claude (web, desktop ou móvel), abra Settings > Connectors, escolha Add custom connector e introduza https://statsdot.com/api/mcp. O Claude abre uma página do Statsdot: inicie sessão se necessário e escolha Allow.

ChatGPT

No ChatGPT, abra Settings > Apps and connectors, ative o modo de programador em Advanced se o seu plano o exigir, crie um conector com o URL https://statsdot.com/api/mcp e escolha OAuth como autenticação. Aprove a ligação na página do Statsdot que se abre.

As ligações feitas desta forma são apenas de leitura: o assistente pode consultar as suas estatísticas, mas não pode alterar sites, objetivos, notas ou a sua equipa. Estas aparecem em Connected assistants na página API and MCP, onde as pode desligar. Uma ligação não utilizada expira após 30 dias.

Ferramentas de desenvolvimento (token de acesso)

1. Criar um token

Na página API and MCP da sua conta, crie um token. Read only é suficiente para fazer perguntas. Escolha read and write apenas se pretender que o assistente adicione sites, objetivos ou membros da equipa.

2. Ligar o seu assistente

Claude Code

claude mcp add --transport http statsdot https://statsdot.com/api/mcp \
  --header "Authorization: Bearer 12|your-token"

Cursor

Em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "statsdot": {
      "url": "https://statsdot.com/api/mcp",
      "headers": { "Authorization": "Bearer 12|your-token" }
    }
  }
}

Codex

Em ~/.codex/config.toml:

[mcp_servers.statsdot]
url = "https://statsdot.com/api/mcp"
http_headers = { "Authorization" = "Bearer 12|your-token" }

Outros clientes que suportam servidores MCP remotos via HTTP com um cabeçalho personalizado funcionam da mesma forma.

Ferramentas

Ferramenta	O que faz
get-account	O seu plano, eventos utilizados e incluídos, limites
list-sites	Sites que pode ver, com os respetivos IDs
get-overview	Visitantes, visualizações de página, taxa de rejeição e duração da visita, comparados com o período anterior
get-timeseries	Visitantes e visualizações de página por dia ou mês
get-breakdown	Principais páginas, páginas de entrada e saída, referenciadores, campanhas, países, dispositivos, navegadores, sistemas, eventos
get-goal-results	Objetivos com conversões e taxa de conversão
get-realtime	Visitantes nos últimos cinco minutos
get-bot-traffic	Crawlers de IA que leem o site e as páginas que solicitaram
list-funnels, get-funnel-results, create-funnel, delete-funnel	Funis e os visitantes em cada etapa
create-site, update-site, delete-site	Gerir sites, incluindo alertas e o objetivo principal (tokens de escrita)
create-goal, delete-goal	Gerir objetivos (tokens de escrita)
list-notes, create-note, delete-note	Notas no gráfico que explicam alterações no tráfego
list-team, invite-team-member, remove-team-member	Gerir a sua equipa (tokens de escrita)

As ferramentas de leitura estão marcadas como apenas de leitura e as ferramentas que eliminam estão marcadas como destrutivas, pelo que os assistentes pedem confirmação antes de as utilizar. Os intervalos e filtros funcionam como na API.

Privacidade

O assistente vê as mesmas estatísticas agregadas que o seu painel de controlo. O Statsdot não armazena dados pessoais sobre os seus visitantes, pelo que não existem dados para partilhar. Revogue o token ou desligue o assistente na página API and MCP para terminar a ligação a qualquer momento.