UptimeObserver

Monitoreo de disponibilidad

Ver en uptimeobserver.com

Documentación

MCP

Resumen

Las claves de API de MCP (Model Context Protocol) te permiten acceder programáticamente a los datos de monitoreo de UptimeObserver a través de nuestra API. Usa estas claves para integrar UptimeObserver con asistentes de IA, herramientas de automatización y aplicaciones personalizadas.

Consulta disponibilidad de planes y límites de claves. Las claves MCP son para acceso de automatización, no para alertas de notificación.

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árdala de forma segura
  • Puede rotarse para generar una nueva clave sin tiempo de inactividad
  • Puede revocarse para deshabilitar el acceso inmediatamente

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/mcp solo 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

  1. Ve a UptimeObserver e inicia sesión en tu cuenta.
  2. Navega a la sección de Integraciones desde tu panel de control.
  3. Elige MCP de la lista de integraciones disponibles.
  4. Haz clic en Crear Clave.

[!warning] Visualización Única La clave generada se muestra solo una vez en un diálogo modal. Cópiala y guárdala de forma segura antes de cerrar el modal. Si pierdes la clave, deberás rotarla para obtener una nueva.

  1. Copia la clave y guárdala en un lugar seguro (gestor de contraseñas, variables de entorno o gestor de secretos).

Uso del Endpoint de 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. Usa la rotación para actualizaciones rutinarias de claves sin interrupción del servicio:

  1. Navega a Integraciones → MCP en tu panel de control.
  2. Haz clic en Rotar junto a la clave que deseas reemplazar.
  3. Se genera una nueva clave. Cópiala y guárdala de forma segura.
  4. Actualiza tus aplicaciones para usar la nueva clave.
  5. La clave anterior sigue siendo válida hasta que la revoques 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:

  1. Navega a Integraciones → MCP en tu panel de control.
  2. Haz clic en Revocar junto a la clave que deseas deshabilitar.
  3. Confirma la revocación en el diálogo.

[!danger] Irreversible Las claves revocadas no se pueden recuperar. Deberás crear una nueva clave si deseas restaurar el acceso.

Buenas Prácticas de Seguridad

  • Almacena las claves de forma segura — Usa un gestor de contraseñas, variables de entorno o un gestor de secretos. Nunca subas claves al control de versiones
  • Rota regularmente — Rota las claves periódicamente como parte de tu higiene de seguridad
  • Revoca inmediatamente las claves comprometidas — Si una clave queda expuesta, revócala y crea una nueva
  • Usa claves separadas por aplicación — Crea claves distintas para diferentes herramientas o entornos
  • Aplica el principio de mínimo privilegio — Solo comparte claves con aplicaciones que las necesiten

Casos de Uso

  • Integración con Asistentes de IA — Conecta datos de monitoreo a herramientas de observabilidad impulsadas por IA mediante el protocolo MCP
  • Paneles Personalizados — Crea paneles de estado internos que obtengan datos de monitoreo en tiempo real
  • Flujos de Automatización — Activa respuestas automatizadas basadas en cambios de estado del monitor
  • Integración CI/CD — Verifica la salud del servicio como parte de tu pipeline de despliegue

Solución de Problemas

401 No Autorizado

  • Verifica que la clave de API sea correcta y no haya sido revocada
  • Asegúrate de usar la cabecera X-API-Key o la cabecera Authorization: Bearer (no ambas)
  • Comprueba que el prefijo de clave uo_ esté incluido
  • Los tokens JWT no se aceptan en el endpoint de MCP

403 Prohibido

  • La clave de API puede haber sido revocada. Consulta el panel de MCP para ver el estado de la clave
  • Tu cuenta puede no tener permiso para acceder al endpoint de MCP

Clave Perdida u Olvidada

  • Las claves de MCP se muestran solo una vez al crearse
  • Si pierdes una clave, rótala para generar una nueva y luego actualiza tus aplicaciones

[!info] ¿Necesitas Ayuda? Si necesitas asistencia con las claves de API de MCP, comunícate usando el botón "¿Necesitas Ayuda?" en la esquina inferior derecha o envíanos un correo a support@uptimeobserver.com.