Funcionamiento de la herramienta MCP

La verificación monitorea que el servidor MCP, del que tu agente obtiene herramientas, responda y que la herramienta necesaria esté en su lugar. El servidor generalmente funciona: más a menudo cambia su contenido — la herramienta fue renombrada o removida de la lista. Una verificación HTTP normal verá la dirección funcionando y no notará nada de esto.

Qué verificar exactamente

Se elige un nivel, no un conjunto de casillas: están anidados — "la herramienta existe" sin "el servidor responde" no sucede. Los primeros dos niveles no ejecutan nada en el servidor y cuestan lo mismo, así que tiene sentido comenzar con el segundo: es por eso que se crea la verificación.

Nivel Qué se verifica Precio
El servidor responde El servidor aceptó la solicitud y se analizó la respuesta. Detecta servidores no disponibles, direcciones incorrectas y tokens rechazados, y con una versión de protocolo explícitamente seleccionada — y migración del servidor a otra. Gratis
El servidor tiene la herramienta La herramienta especificada está en la lista de herramientas del servidor. Detecta herramientas renombradas, removidas de la lista u ocultas por permisos — lo que sucede notablemente más frecuente que la caída del servidor en sí. Gratis
La herramienta se ejecuta La herramienta se invoca con los argumentos especificados y responde sin error. Detecta lo que la lista no ve: la herramienta está en su lugar, pero está roto lo que la herramienta accede — base de datos, API externa, permisos. Llamada real en cada verificación
El tercer nivel invoca la herramienta de verdad. Una invocación de herramienta es una acción. Un monitoreo que cada cinco minutos envía un correo o crea un ticket causará una catástrofe silenciosa, y el monitoreo en sí estará "funcionando". Por eso el nivel está deshabilitado por defecto, y deberías seleccionarlo solo para una herramienta de lectura — búsqueda, lectura, referencia. No podemos distinguir una herramienta de lectura de una que cambia cosas por su descripción, así que la elección te corresponde a ti.
Versión de protocolo — automáticamente o la tuya. Por defecto determinamos la versión nosotros mismos en cada verificación: cualquiera que el servidor tenga es válida. Esto es suficiente si te importa que la herramienta responda. Pero la determinación automática sigue silenciosamente al servidor: migró a una nueva revisión, la verificación se adaptó y muestra "funciona" — pero tu aplicación, diseñada para la versión anterior, ya está rota en ese momento. Si tu código está vinculado a una versión específica, selecciónala: entonces la migración del servidor será un fallo, sobre el que serás notificado. Si no admite la versión seleccionada, el servidor listará las suyas, y las mostraremos en la razón de la verificación.
Solo monitoreamos HTTP. Los servidores MCP pueden ser locales — aquellos que un editor o agente inicia en tu máquina y habla con ellos a través de entrada/salida estándar. Nadie desde fuera puede llegar a ese servidor, incluyéndonos nosotros. Puedes monitorear solo un servidor accesible por dirección desde internet.
El transporte obsoleto no es soportado. La primera revisión del protocolo, 2024-11-05, funcionaba de manera diferente: el servidor mantenía un flujo de eventos separado y una dirección separada para mensajes. Se declaró obsoleto a principios de 2025, y no está en la lista de versiones. Si tu dirección responde por él, la verificación te lo dirá claramente — la dirección no acepta solicitudes normales de MCP.

Campos del formulario

Campo Significa Qué ingresar Ejemplo
Nombre Nombre de la verificación. Indica qué servidor es y por qué es importante para ti. MCP búsqueda de base de datos
Grupo Permite asignar la tarea a un proyecto o sección. Selecciona un grupo si quieres mantener las tareas del proyecto juntas. Proyecto principal
Dirección del servidor La dirección del endpoint MCP — la misma que especificas en la configuración del agente. Ingresa la dirección completa, con la ruta. Generalmente la ruta termina en /mcp, pero puede ser cualquiera. https://example.com/mcp
Versión del protocolo La revisión de MCP a la que está diseñado tu código, o "Automáticamente" — cualquiera que el servidor tenga. Deja "Automáticamente" si solo te importa que la herramienta responda. Selecciona la misma versión que declara tu cliente si quieres ser notificado sobre la migración del servidor a otra. Automáticamente
Token Token Bearer, si el servidor está protegido por autorización. Deja vacío si el servidor está abierto. Al editar una tarea, un campo vacío significa "mantener el token anterior"; al cambiar de host, el token anterior no se transferirá — no lo enviaremos al nuevo destino. Token de configuración del servidor
Qué verificar El nivel de verificación de los descritos arriba. Elige el segundo: no ejecuta nada en el servidor, como el primero, y responde la pregunta por la que se crea la verificación. El tercero — solo para una herramienta de lectura. El servidor tiene la herramienta
Herramienta Nombre de la herramienta que monitoreamos. Se pregunta desde el segundo nivel. Especifícalo exactamente como el servidor lo devuelve en la lista de herramientas: la verificación es estricta. Es el mismo nombre con el que se invoca la herramienta, no su descripción. search_documents
Argumentos Con qué invocar la herramienta. Se pregunta solo en el tercer nivel. Un objeto JSON de la forma que la herramienta espera los argumentos. Elige una solicitud inofensiva a la que la herramienta seguramente responderá. Un campo vacío — invocación sin argumentos. {"query": "test"}
Tiempo de espera Cuánto tiempo se asigna para toda la verificación, en cualquier nivel. Una verificación más larga que el tiempo especificado se considera un fallo: un servidor que responde pero lentamente también está roto. Oriéntate en cuánto tarda el servidor en responder normalmente para ti, con un margen. 30 segundos
Intervalo Con qué frecuencia ejecutar la verificación. En los primeros dos niveles — como prefieras, una frecuencia razonable es cinco minutos. En el tercero — 15 minutos o más: cada verificación invoca la herramienta. 5 minutos
Canales de notificación Dónde enviar mensajes sobre problemas y recuperación. Marca los canales donde realmente lees notificaciones. Telegram y correo
Reportes Resúmenes periódicos de la tarea. Activa si quieres recibir una descripción general sin entrar manualmente en el panel. Reporte semanal

Cuándo llega una alerta

Una alerta llega si la verificación seleccionada no pasa:

  • el servidor no está disponible, respondió con error o rechazó el token;
  • el servidor no admite la versión de protocolo seleccionada — en la razón se listarán las que admite;
  • a la dirección responde algo que no es un servidor MCP o un servidor en transporte obsoleto;
  • la herramienta especificada no está en la lista — en los niveles segundo y tercero;
  • la herramienta se ejecutó con error o pidió entrada en lugar de un resultado — en el tercer nivel;
  • toda la verificación tardó más que el tiempo de espera — en cualquier nivel.

Cuándo se salta la verificación

Si el servidor pidió ser consultado con menos frecuencia, la tarea no cae ni sube — la verificación se salta y el estado permanece igual. Este es el único caso así: la limitación de frecuencia habla de nuestra propia insistencia, no de tu servidor. Todo lo demás — red silenciosa, error del servidor, token rechazado — para esta tarea significa que la herramienta no puede ser usada ahora.

Una tarea — una herramienta

Monitorear tres herramientas de un servidor son tres tareas. Así cada una tiene su propio uptime y su propio historial: si mezclas varias preguntas en una tarea, obtendrás un uptime del que no está claro de quién es. Si las herramientas son igualmente importantes, agrupa las tareas.

Configuración de notificaciones

Para cada canal de notificación en la tarea, puedes configurar parámetros adicionales. Funcionan solo para eventos DOWN.

Parámetro Qué hace
Habilitado Permite o prohíbe enviar notificaciones a través de este canal para esta tarea.
Posponer hasta PRO Retrasa la primera notificación sobre DOWN el tiempo seleccionado (hasta 12 horas). Útil para no recibir alertas sobre fallos transitorios.
Repetir cada PRO Repite periódicamente la notificación mientras la tarea permanece en estado DOWN (hasta 1 hora entre repeticiones). Útil cuando es importante no perderse una falla prolongada.
Los parámetros "Posponer" y "Repetir" no afectan los eventos UP ni las notificaciones de recuperación.
Volver a lista de tipos de tareas