UptimeObserver
Monitoreo de disponibilidad
Documentación
MCP
Resumen
Las claves de API de MCP (Model Context Protocol) le permiten acceder programáticamente a los datos de monitoreo de UptimeObserver a través de nuestra API. Use estas claves para integrar UptimeObserver con asistentes de IA, herramientas de automatización y aplicaciones personalizadas.
Cómo Funcionan las Claves de API de MCP
Las claves de API de MCP proporcionan acceso autenticado al endpoint de la API de UptimeObserver. Cada clave:
- Tiene el prefijo
uo_para facilitar su identificación - Se muestra solo una vez al crearse — guárdela de forma segura
- Puede rotarse para generar una nueva clave sin tiempo de inactividad
- Puede revocarse para deshabilitar el acceso de inmediato
Autenticación
Las claves de API de MCP pueden enviarse en cualquiera de estos dos formatos:
Autenticación por Cabecera
X-API-Key: uo_yourkeyhere
Autenticación por Token Bearer
Authorization: Bearer uo_yourkeyhere
[!warning] JWT No Aceptado El endpoint
/api/mcpsolo acepta claves de API de MCP. Los tokens JWT estándar no son válidos para el acceso MCP.
Creación de una Clave de API de MCP
- Vaya a UptimeObserver e inicie sesión en su cuenta.
- Navegue a la sección de Integraciones desde su panel de control.
- Elija MCP de la lista de integraciones disponibles.
- Haga clic en Crear Clave.
[!warning] Visualización Única La clave generada se muestra solo una vez en un diálogo modal. Cópiela y guárdela de forma segura antes de cerrar el modal. Si pierde la clave, deberá rotarla para obtener una nueva.
- Copie la clave y guárdela en un lugar seguro (gestor de contraseñas, variables de entorno o gestor de secretos).
Uso del Endpoint MCP
Endpoint
POST https://mcp.uptimeobserver.com/mcp
Ejemplo de Solicitud
curl -X POST https://mcp.uptimeobserver.com/mcp \
-H "X-API-Key: uo_yourkeyhere" \
-H "Content-Type: application/json"
O usando autenticación Bearer:
curl -X POST https://mcp.uptimeobserver.com/mcp \
-H "Authorization: Bearer uo_yourkeyhere" \
-H "Content-Type: application/json"
Gestión de Claves de API
Rotación de una Clave
La rotación genera una nueva clave mientras mantiene la anterior activa hasta que la nueva sea confirmada. Use la rotación para actualizaciones rutinarias de claves sin interrupción del servicio:
- Navegue a Integraciones → MCP en su panel de control.
- Haga clic en Rotar junto a la clave que desea reemplazar.
- Se genera una nueva clave. Cópiela y guárdela de forma segura.
- Actualice sus aplicaciones para usar la nueva clave.
- La clave anterior sigue siendo válida hasta que la revoque explícitamente.
Revocación de una Clave
La revocación deshabilita inmediatamente una clave de API. Todas las aplicaciones que usen esa clave perderán el acceso:
- Navegue a Integraciones → MCP en su panel de control.
- Haga clic en Revocar junto a la clave que desea deshabilitar.
- Confirme la revocación en el diálogo.
[!danger] Irreversible Las claves revocadas no se pueden recuperar. Deberá crear una nueva clave si desea restaurar el acceso.
Buenas Prácticas de Seguridad
- Almacene las claves de forma segura — Use un gestor de contraseñas, variables de entorno o un gestor de secretos. Nunca confirme claves en el control de versiones
- Rote regularmente — Rote las claves periódicamente como parte de su higiene de seguridad
- Revoque inmediatamente las claves comprometidas — Si una clave queda expuesta, revóquela y cree una nueva
- Use claves separadas por aplicación — Cree claves distintas para diferentes herramientas o entornos
- Aplique el principio de menor privilegio — Solo comparta claves con las aplicaciones que las necesiten
Casos de Uso
- Integración con Asistentes de IA — Conecte datos de monitoreo a herramientas de observabilidad impulsadas por IA mediante el protocolo MCP
- Paneles Personalizados — Cree paneles de estado internos que obtengan datos de monitoreo en tiempo real
- Flujos de Automatización — Active respuestas automatizadas basadas en cambios de estado del monitor
- Integración CI/CD — Verifique la salud del servicio como parte de su pipeline de despliegue
Solución de Problemas
401 No Autorizado
- Verifique que la clave de API sea correcta y no haya sido revocada
- Asegúrese de usar la cabecera
X-API-Keyo la cabeceraAuthorization: Bearer(no ambas) - Compruebe que el prefijo de clave
uo_esté incluido - Los tokens JWT no se aceptan en el endpoint MCP
403 Prohibido
- La clave de API puede haber sido revocada. Verifique el estado de la clave en el panel de MCP
- Su cuenta puede no tener permiso para acceder al endpoint MCP
Clave Perdida u Olvidada
- Las claves MCP se muestran solo una vez al crearse
- Si pierde una clave, rótela para generar una nueva y luego actualice sus aplicaciones
[!info] ¿Necesita Ayuda? Si necesita asistencia con las claves de API de MCP, comuníquese usando el botón "¿Necesita Ayuda?" en la esquina inferior derecha o envíenos un correo a support@uptimeobserver.com.