Como medir um servidor MCP: chamadas, ferramentas e erros

Quem publica um servidor MCP geralmente não sabe se alguém o usa nem quais ferramentas são chamadas. O Analytics tem um tipo de site para servidores MCP: cada chamada de ferramenta vira um registro, com o cliente, a sessão, a latência e o código de erro, se houver.

Por que um servidor MCP não é medido como um site

Num site, o visitante carrega uma página no navegador e o script registra a visualização. Um servidor MCP não tem navegador: quem o chama é um cliente de IA, como o Claude Code, o Cursor ou outro agente, e a chamada chega como uma requisição de protocolo. Por isso o Analytics não usa o script de uma linha. Ele usa um pacote que fica dentro do próprio servidor e envia cada chamada de ferramenta ao worker.

Também não há país: um servidor remoto é chamado da plataforma do cliente, e o IP indicaria o data center, não a pessoa. Por isso o relatório de MCP troca a dimensão geográfica pelo cliente, pela faixa de latência e pelo resultado.

Como instalar

Há dois caminhos, e os dois terminam com a mesma coisa: o servidor enviando um registro por chamada.

Pelo painel. Em Novo site, escolha Servidor MCP e informe o endereço público do servidor, por exemplo api.meusite.com/mcp. A criação devolve uma chave de servidor, que começa com ask_ e também aparece em Configurações.

Pelo comando. Na pasta do projeto do servidor, rode:

npx @ciromaciel/analytics mcp init --key ask_...

O comando localiza onde o servidor é criado, instala o pacote com o gerenciador do projeto, guarda a chave onde o servidor roda e mostra a mudança antes de salvar. Pode ser rodado de novo sem duplicar nada.

Se preferir fazer à mão, o envolvimento é uma linha, feita logo depois de criar o servidor e antes de registrar as ferramentas:

import { withAnalytics } from '@ciromaciel/analytics/mcp'

const server = withAnalytics(new McpServer({ name: 'meu-mcp', version: '1.0.0' }))

Em ambientes sem process.env, como o Cloudflare Workers, a chave é passada explicitamente. O envio é feito em segundo plano: a resposta da ferramenta não espera pela gravação, e se o Analytics estiver fora do ar, o servidor não percebe.

O que o relatório mostra

O relatório de um servidor MCP responde às perguntas que o publicador faz de fato.

As chamadas ficam guardadas por 90 dias, e os filtros do relatório se combinam: é possível ver só as chamadas com erro de uma ferramenta, ou só as de um cliente específico.

Uma meta pode ser registrada dentro da ferramenta, com o contexto que ela já recebe, para marcar um resultado. O relatório mostra a taxa de sessões que chegaram a essa meta.

O que a medição não faz

A medição de MCP é de leitura e de registro. Ela conta o que aconteceu e não interfere no que o servidor responde. O pacote envia a sessão já em hash, e o servidor faz um segundo hash com um sal diário, de modo que o valor original não sai do seu ambiente.

Ela não mede o conteúdo que a ferramenta devolve, nem o que o usuário pediu ao agente, nem identifica a pessoa por trás da sessão. Se o cliente não informa quem é, a chamada aparece como não informado, sem adivinhação.

Perguntas frequentes

Preciso mudar o código das ferramentas?

Não. O pacote envolve o servidor e as ferramentas continuam registradas do mesmo jeito. A única mudança é a linha que cria o servidor com a medição, feita antes do registro das ferramentas.

A medição atrasa a resposta do servidor?

Não de forma perceptível. O registro é enviado em segundo plano, depois que a ferramenta já respondeu. Se o envio falhar, a chamada do usuário segue normalmente.

Consigo medir um servidor em outra linguagem?

Sim. Basta fazer um POST por chamada para /collect/server, com a chave ask_ no cabeçalho Authorization e os campos da chamada no corpo. O pacote é a forma mais simples.

Quem pode ver o relatório?

Somente a conta que criou o site do MCP. A chave de servidor só grava chamadas; quem só lê os números usa o painel, o MCP de leitura com OAuth ou a chave de leitura.

Para continuar lendo

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

• Perguntar ao seu analytics por um agente de IA

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

Medir o que o seu servidor faz

Com a medição instalada e o relatório mostrando as chamadas, a pergunta "alguém usa isso?" passa a ter resposta. Conhecer o Analytics

Fontes

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

• Página do Analytics