Perguntar ao seu analytics por um agente de IA

Você pode perguntar ao seu analytics quantas visitas o site teve na semana, de onde elas vieram e qual página mais chamou atenção, e receber a resposta no chat onde você trabalha. O servidor MCP de leitura do Analytics faz isso: o agente de IA consulta os números e responde em linguagem comum, com os mesmos dados que aparecem no painel.

O que o agente consegue responder

O servidor expõe oito ferramentas, todas de leitura, que cobrem o que o painel mostra:

O período segue o do painel: 7, 30 ou 90 dias, podendo voltar até oito janelas. Não existe intervalo livre de datas, então "entre 3 e 9 de março" não é uma pergunta que o servidor responde. A janela fechada é o que mantém os números comparáveis entre uma consulta e outra.

Como conectar

Você adiciona o endereço do servidor no seu agente e faz o login uma vez, pelo navegador. No Claude Code, o comando é este:

claude mcp add --transport http analytics https://analytics.worker.myoperations.click/mcp

O login usa o mesmo código por e-mail dos demais painéis da linha, com a autorização feita pelo Auth da linha. Depois disso, a pergunta "quantas visitas o meusite.com.br teve nos últimos 7 dias, e de onde vieram?" vira duas consultas no próprio agente: uma para achar o site, outra para ler os números.

A conta vem do login, não de um campo que você digita. Um site de outra conta não aparece, e o agente recebe a mesma resposta de um site que não existe.

O que o agente não vê

Nenhuma consulta devolve endereço IP, hash do visitante nem a chave de servidor de um MCP. O Analytics conta visitantes distintos por dia, sem identificador no navegador, e o agente recebe só o que o painel também mostra.

Também não há escrita. Nenhuma ferramenta cria site, apaga histórico ou muda uma meta. Esse limite é deliberado: um registro de analytics que um agente pudesse reescrever deixaria de ser um registro. Cadastrar e excluir continua sendo tarefa do painel, feita por você.

Quando a pessoa não está na frente

Uma rotina agendada, como um cron ou um CI, roda sem ninguém para fazer login. Para esse caso existe a chave de leitura, criada no painel em Conta → Chaves de leitura, com um nome. Ela aparece uma única vez; depois, só o prefixo fica visível. Com ela, a rotina lê as mesmas consultas, dos sites da conta que a criou, e não consegue escrever nada, nem criar outra chave.

Guarde essa chave como segredo da rotina, nunca no HTML de uma página. Se ela vazar, revogue no mesmo lugar: a chave deixa de ser aceita.

Perguntas frequentes

Preciso programar para usar?

Não. Você precisa adicionar o endereço no seu agente e fazer o login. A conexão é a única parte técnica, e acontece uma vez.

O agente pode mudar alguma coisa no meu analytics?

Não. As oito ferramentas são de leitura. A chave de leitura também não escreve. Criar ou excluir site, meta ou chave acontece só no painel.

Qual a diferença entre o login do agente e a chave de leitura?

O login é para você, numa conversa com o agente. A chave é para uma rotina sem pessoa na frente. As duas leem os mesmos números e as duas param de funcionar quando você revoga o acesso.

Os números do agente são os mesmos do painel?

Sim. A ferramenta chama o mesmo código que o painel usa, então a resposta bate com o que você veria na tela.

Para continuar lendo

• Analytics de site sem cookie: o que dá para medir e o que não dá

• Como medir um servidor MCP: chamadas, ferramentas e erros

• Os números do site que valem olhar toda semana

Ler os números sem abrir o painel

Quando o analytics responde no mesmo lugar em que você já trabalha, a pergunta sobre o site deixa de ser uma tarefa separada. O Analytics entrega essa leitura pelo MCP e pela chave de leitura, e mantém a escrita onde deve ficar: no painel, com você.

Conhecer o Analytics

Fontes

• Referência do Analytics para pessoas e agentes (llms.txt)

• Página do Analytics