A análise de servidores MCP oferece aos proprietários de projetos e administradores visibilidade sobre como sua base de conhecimento está sendo acessada pelo servidor Model Context Protocol (MCP). Você pode acompanhar volumes de chamadas, taxas de sucesso e fracasso, uso de ferramentas, usuários ativos, distribuição de clientes e atividade de busca a partir de um único painel. Use-o para medir o valor da integração do seu MCP e entender como assistentes de IA e membros da equipe estão interagindo com sua base de conhecimento.
Por que usar análise de servidores MCP
- Use-o para confirmar que o MCP está sendo ativamente usado após a configuração e identificar se a adoção é ampla ou limitada a poucos usuários.
- Use-o para investigar picos de falha e identificar se os problemas estão concentrados em operações de leitura ou escrita.
- Use-o para entender quais ferramentas MCP e clientes de IA são mais usados, assim você pode otimizar a configuração de acesso e planejar a habilitação.
Como acessar análises de servidores MCP
No portal da base de conhecimento, navegue até Analytics () na barra de navegação esquerda, depois clique no servidor MCP no painel de navegação esquerdo.
Qualquer membro da equipe com permissão de visualização de análises pode acessar o painel.
O painel se abre mostrando dados dos últimos 7 dias por padrão. Clique no menu suspenso do filtro de data e selecione Semana Passada, Mês Passado ou Data Personalizada para ajustar o intervalo de datas.
Visão geral do painel
O topo do painel mostra quatro cartões de KPI resumindo a atividade do período selecionado:
| Métrica | Descrição | Como isso ajuda |
|---|---|---|
| Total de chamadas | Número total de chamadas MCP feitas no período selecionado. | Mostra se o MCP está sendo ativamente usado. Se as chamadas forem menores do que o esperado, verifique se os assistentes MCP estão conectados corretamente e se os usuários sabem que o acesso MCP está disponível. |
| Taxa de sucesso | Percentual e contagem de chamadas MCP concluídas com sucesso. | Mostra se clientes MCP conectados podem recuperar ou executar ações com sucesso. Uma queda na taxa de sucesso pode indicar problemas de autenticação, restrições de permissão ou falhas de solicitação do cliente conectado. |
| Taxa de falha | Percentual e contagem de falhas em chamadas MCP. | Destaca se as solicitações MCP estão falhando repetidamente. Se as falhas forem altas, use o gráfico operacional das ferramentas MCP para identificar se as falhas estão concentradas em operações de Leitura ou Escrita, então revise a configuração do cliente, permissões e limites de taxa. |
| Usuários ativos | Número de usuários únicos que fizeram pelo menos uma chamada MCP no período selecionado. | Mostra se o uso do MCP está distribuído entre a equipe ou concentrado entre alguns usuários. Se o total de chamadas for alto, mas os usuários ativos forem baixos, considere capacitações ou treinamentos mais amplos. |
O painel de análise do servidor MCP permanece acessível mesmo que o MCP esteja desativado nas configurações de IA, desde que existam dados para o intervalo de datas selecionado. Desabilitar o MCP impede que novos dados sejam coletados, mas não remove análises existentes. Por exemplo, se o MCP foi ativado no mês passado e depois desativado, você ainda pode selecionar o mês passado no filtro de data para revisar chamadas, usuários, clientes e uso da ferramenta desse período.
Paradas
A seção de Gráficos fornece uma análise detalhada das tendências de uso do MCP em volume de chamadas, desempenho de ferramentas, atividade do usuário, distribuição de clientes e atividade de busca.
O volume de chamadas MCP mostra a atividade diária de chamadas MCP em todos os usuários. Passe o mouse sobre qualquer ponto para ver o total de chamadas, número de sucesso, número de falhas e taxa de sucesso daquele dia.
A operação das ferramentas MCP mostra a distribuição das chamadas MCP por tipo de operação (Leitura e Escrita), segmentadas por número de sucessos e falhas. Use isso para entender se seu uso de MCP é principalmente de leitura (recuperação de conteúdo) ou de escrita (criação e edição de conteúdo). Clique em Todos, Sucesso ou Falho para filtrar a visualização.
Chamadas de ferramentas MCP por uso mostram com que frequência cada ferramenta MCP foi chamada durante o período selecionado, ordenadas por volume. Passe o mouse sobre qualquer barra para ver o total de chamadas, número de sucesso, número de falhas e taxa de sucesso dessa ferramenta. Para saber o que cada ferramenta faz, veja Ferramentas MCP suportadas.
Os principais usuários exibem os principais usuários classificados pelo volume de chamadas do MCP. Os 5 melhores são mostrados por padrão. Passe o mouse sobre qualquer barra para ver as estatísticas de chamadas daquele usuário. Clique em Ver tudo para ver a lista completa, onde você pode ordenar por volume de chamadas ou buscar por um usuário específico.
Os principais clientes MCP exibem os principais assistentes de IA conectados ao seu servidor MCP, classificados pelo volume de chamadas. Os 5 melhores são mostrados por padrão. Passe o mouse sobre qualquer barra para ver as estatísticas de chamadas. Clique em Ver tudo para ver a lista completa.
A ferramenta de busca MCP mostra o número de consultas diárias feitas especificamente pela ferramenta de Busca, separadamente das chamadas mais amplas da ferramenta MCP. Use isso para entender com que frequência os assistentes de IA pesquisam sua base de conhecimento e se o volume de buscas está crescendo com o tempo.
Todos os gráficos podem ser exportados como imagem PNG usando o ícone de exportação () no canto superior direito de cada gráfico. O gráfico da ferramenta de busca MCP também suporta exportação CSV, que inclui a consulta de busca, carimbo de data e status para cada entrada.
Melhores práticas
- Monitore a taxa de falha após qualquer alteração na configuração do MCP. Um aumento repentino nas falhas após uma alteração em permissões, tokens ou configurações do cliente é um forte sinal de que a mudança introduziu um problema.
- Use o gráfico operacional das ferramentas MCP para triagem de falhas. Se as falhas se concentrarem em operações de escrita, o problema provavelmente é uma restrição de permissões ou de função de conteúdo. Se as falhas de leitura forem altas, verifique os limites de autenticação e taxa.
- Compare o total de chamadas com usuários ativos. Um alto volume de chamadas com poucos usuários ativos sugere que o MCP é muito usado por um grupo pequeno. Considere se uma capacitação mais ampla da equipe agregaria valor.
- Revise o gráfico dos principais clientes MCP após a integração de novos assistentes de IA. Confirmar que um novo cliente aparece no prontuário é uma forma rápida de verificar se a conexão está funcionando corretamente.
- Exporte os dados da ferramenta de busca MCP como CSV para análise mais profunda. As colunas de consulta de busca e status permitem identificar quais consultas estão falhando, para melhorar a cobertura da base de conhecimento desses tópicos.
FAQ
Por que ainda consigo ver o painel de análise do servidor MCP depois de desativar o MCP?
O painel exibe dados históricos independentemente de o MCP estar ativado atualmente. Desabilitar o MCP impede que novos dados sejam coletados, mas não remove análises existentes.
O que causa falhas nas chamadas MCP?
As razões comuns para falhas nas chamadas MCP incluem:
- Limite de tokens ultrapassado (plano): O assistente de IA atingiu seu limite de tokens em nível de plano, impedindo novas chamadas de ferramentas MCP.
- Limite de tokens ultrapassado (sessão): O limite atual de tokens de sessão está no máximo. Novas chamadas são bloqueadas até que uma nova sessão seja iniciada, mesmo que os créditos totais ainda estejam disponíveis.
- Limitação de taxa: Muitos pedidos estão sendo feitos além da taxa permitida pelo plano.
- Interrupção de rede: Um problema de conectividade no meio da sessão causou a falha da chamada.