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 |
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. |