Operação da ferramenta MCP

A verificação monitora se o servidor MCP do qual seu agente obtém ferramentas responde e a ferramenta necessária está lá. O servidor geralmente está vivo: mais frequentemente seu conteúdo muda — a ferramenta foi renomeada ou removida da lista. Uma verificação HTTP comum veria um endereço funcionando e não notaria nada.

O que verificar exatamente

Um nível é selecionado, não um conjunto de marcas: eles são aninhados — "ferramenta existe" sem "servidor responde" não acontece. Os dois primeiros níveis não executam nada no servidor e custam igual, portanto começa com o segundo: é para o qual a verificação é feita.

Nível O que é verificado Preço
O servidor responde O servidor aceitou a solicitação e a resposta foi analisada. Detecta servidor inacessível, endereço incorreto e token rejeitado, ou com versão de protocolo explícita — e a mudança do servidor para outra. Grátis
A ferramenta está no servidor A lista de ferramentas contém a que você especificou. Detecta ferramenta renomeada, removida da lista ou ocultada por permissões — algo que acontece muito mais frequentemente que o servidor cair. Grátis
A ferramenta é executada A ferramenta é chamada com seus argumentos e responde sem erro. Detecta o que a lista não vê: ferramenta lá, mas quebrado o que ela acessa — banco de dados, API externa, direitos. Chamada real em cada verificação
O terceiro nível chama a ferramenta para valer. Chamar uma ferramenta é uma ação. Monitoramento que envia um email ou cria um ticket a cada cinco minutos será uma catástrofe silenciosa, e parecerá que está funcionando. Por isso o nível é desativado por padrão, e deve ser selecionado apenas para ferramentas de leitura — pesquisa, leitura, referência. Não conseguimos diferenciar uma ferramenta de leitura de uma que muda pelo seu descritor, então a escolha é sua.
Versão do protocolo — automaticamente ou sua. Por padrão, definimos a versão nós mesmos em cada verificação: qualquer uma que o servidor suporte funciona. Bastante, se você só precisa que a ferramenta responda. Mas autodeterminação rastreia silenciosamente o servidor: ele foi para a nova revisão, a verificação se ajustou e mostra "funciona" — e seu aplicativo, esperando a versão antiga, já está quebrado. Se seu código está vinculado a uma versão específica, escolha-a: então a migração do servidor se torna uma falha que você conhecerá. Sem suporte da versão escolhida, o servidor nomeará as dele e as mostraremos no motivo da verificação.
Monitoramos apenas HTTP. Servidores MCP são locais — o editor ou agente lança na sua máquina e conversa através de stdin/stdout. Ninguém pode alcançar tal servidor de fora, incluindo nós. Você pode monitorar o servidor acessível pelo endereço da internet.
Transporte obsoleto não é suportado. A primeira revisão do protocolo, 2024-11-05, funcionava diferente: o servidor segurou um fluxo de eventos separado e um endereço separado para mensagens. Foi marcado como obsoleto na primavera de 2025 e não está na lista de versões. Se seu endereço responder por ele, a verificação dirá — o endereço não aceita solicitações normais de MCP.

Campos do formulário

Campo O que significa O que indicar Exemplo
Nome Nome da verificação. Especifique qual servidor e por que é importante. Busca MCP no banco de dados
Grupo Permite atribuir a tarefa a um projeto ou seção. Selecione um grupo se quiser manter as tarefas do projeto juntas. Projeto principal
Endereço do servidor Endereço do endpoint MCP — aquele que você escreve nas configurações do agente. Digite o endereço completo, com caminho. Geralmente o caminho termina em /mcp, mas pode ser qualquer um. https://example.com/mcp
Versão do protocolo Revisão de MCP para a qual seu código é projetado, ou "Automaticamente" — qualquer uma que o servidor suporte. Deixe "Automaticamente" se você só precisa que a ferramenta responda. Escolha a mesma que seu cliente declara se quiser saber sobre a migração do servidor para outra. Automaticamente
Símbolo Token Bearer se o servidor for protegido por autorização. Deixe em branco se o servidor estiver aberto. Ao alterar a tarefa, campo vazio significa "manter o token anterior"; ao mudar para outro host, o token antigo não é transferido — não o enviaremos ao novo destinatário. Token das configurações do servidor
O que verificar Nível de verificação dos descritos acima. Pegue o segundo: não executa nada no servidor, como o primeiro, e responde à pergunta pela qual a verificação é feita. Terceiro — apenas para ferramenta de leitura. A ferramenta está no servidor
Ferramenta Nome da ferramenta que você acompanha. Solicitado a partir do segundo nível. Especifique-o exatamente como o servidor fornece na lista de ferramentas: a comparação é rigorosa. É o nome com o qual a ferramenta é chamada, não sua descrição. search_documents
Argumentos Com o que chamar a ferramenta. Solicitado apenas no terceiro nível. Objeto JSON como a ferramenta espera argumentos. Escolha uma solicitação segura que a ferramenta certamente responderá. Campo vazio — chamada sem argumentos. {"query": "test"}
Tempo de espera Quanto tempo é alocado para toda a verificação, em qualquer nível. Uma verificação mais longa que o tempo especificado é considerada uma falha: um servidor que responde, mas lentamente, também é defeituoso. Oriente-se por quanto tempo o servidor normalmente responde de você, com margem. 30 segundos
Intervalo Com que frequência fazer a verificação. Nos dois primeiros níveis — como você desejar, uma frequência razoável é cinco minutos. No terceiro — a partir de 15 minutos: cada verificação chama a ferramenta. 5 minutos
Canais de notificação Para onde enviar mensagens sobre problemas e recuperação. Marque os canais onde você realmente lê notificações. Telegram e email
Relatórios Resumos periódicos da tarefa. Ative se desejar receber uma visão geral sem entrar manualmente no painel. Relatório semanal

Quando o alarme soa

O alarme soa se a verificação selecionada falhar:

  • servidor inacessível, respondeu com erro ou rejeitou o token;
  • servidor não suporta versão de protocolo selecionada — a razão listará as que suporta;
  • há um servidor não-MCP no endereço ou um servidor com transporte obsoleto;
  • nenhuma ferramenta especificada na lista — nos segundo e terceiro níveis;
  • ferramenta executada com erro ou pediu entrada em vez de resultado — no terceiro nível;
  • verificação inteira levou mais tempo que o permitido — em qualquer nível.

Quando a verificação é ignorada

Se o servidor solicitou verificações menos frequentes, a tarefa não cai e não sobe — a verificação é ignorada e o status permanece o mesmo. Este é o único caso: uma limitação de frequência diz sobre nossa própria intrusão, não sobre seu servidor. Tudo o mais — rede silenciosa, erro de servidor, token rejeitado — para esta tarefa significa que a ferramenta não pode ser usada agora.

Uma tarefa — uma ferramenta

Monitorar três ferramentas de um servidor são três tarefas. Assim cada uma tem seu próprio uptime e seu próprio histórico: misturando várias perguntas em uma tarefa, você obtém um uptime sobre o qual não está claro de quem é. Se as ferramentas são igualmente importantes, agrupar as tarefas.

Configuração de notificações

Para cada canal de notificação na tarefa, é possível definir parâmetros adicionais. Eles valem apenas para eventos DOWN.

Parâmetro O que faz
Ativado Permite ou proíbe notificações neste canal para esta tarefa.
Atrasar por PRO Atrasa a primeira notificação de DOWN pelo tempo selecionado (até 12 horas). Útil para não receber alertas sobre falhas temporárias.
Repetir a cada PRO Repete periodicamente a notificação enquanto a tarefa permanece em DOWN (até 1 hora entre repetições). Adequado quando é importante não perder um downtime prolongado.
Os parâmetros "Atrasar" e "Repetir" não afetam eventos UP e notificações de recuperação.
Para a lista de tipos de tarefas