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