Visión general

El servidor MCP (Protocolo de Colaboración Multijugador) de Rootly le permite resolver incidentes de producción rápidamente dentro de entornos IDE como Cursor, Windsurf y Claude. Esta herramienta de código abierto genera dinámicamente recursos MCP a partir de la especificación OpenAPI de Rootly, proporcionando capacidades de gestión de incidentes sin problemas dentro de su flujo de trabajo de desarrollo.

Este es un prototipo desarrollado por Rootly AI Labs y no está destinado para uso en producción.

Características

  • Generación dinámica de recursos: Genera automáticamente recursos MCP a partir de la especificación OpenAPI de Rootly
  • Paginación predeterminada: Proporciona paginación incorporada (10 elementos) para endpoints de incidentes
  • Optimización de seguridad y contexto: Limita las rutas de API expuestas para mejorar la seguridad y la gestión del contexto
  • Integración con IDE: Funciona con entornos de desarrollo populares

Endpoints soportados

El servidor proporciona acceso a aproximadamente 20-25 endpoints de API en lista blanca, incluyendo:

  • Incidentes: Acceder y gestionar incidentes
  • Alertas: Gestionar alertas para incidentes específicos
  • Severidades: Acceder a configuraciones de severidad
  • Equipos: Gestionar información de equipos
  • Servicios: Acceder a configuraciones de servicios
  • Y endpoints adicionales para una gestión integral de incidentes

Requisitos previos

  • Python 3.12 o superior
  • uvpip
  • Token de API de Rootly válido

Instalación

Opción 1: Instalar vía PyPI (Recomendado)

pip install rootly-mcp-server

Opción 2: Conectar al servidor MCP alojado

Conéctese directamente al servidor MCP alojado de Rootly sin ninguna instalación local:

{
  "mcpServers": {
    "rootly": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.rootly.com/sse",
        "--header",
        "Authorization:${ROOTLY_AUTH_HEADER}"
      ],
      "env": {
        "ROOTLY_AUTH_HEADER": "Bearer <YOUR_ROOTLY_API_TOKEN>"
      }
    }
  }
}

Esta opción proporciona:

  • Cero instalación y mantenimiento
  • Siempre actualizado con las últimas características
  • Infraestructura y fiabilidad gestionadas
  • Acceso inmediato sin configuración local

Opción 3: Despliegue autogestionado

Para organizaciones que requieren control total sobre su despliegue:

git clone https://github.com/Rootly-AI-Labs/Rootly-MCP-server
cd Rootly-MCP-server
uv pip install .

Esta opción le permite:

  • Alojar el servidor MCP en su propia infraestructura
  • Personalizar la configuración del servidor y los endpoints
  • Asegurar el cumplimiento de las políticas de seguridad internas
  • Controlar el flujo de datos y los patrones de acceso a la API

Configuración

Para la instalación de PyPI (Opción 1)

Agregue la siguiente configuración a su archivo de configuración del cliente MCP:

{
  "mcpServers": {
    "rootly": {
      "command": "uvx",
      "args": [
        "--from",
        "rootly-mcp-server",
        "rootly-mcp-server"
      ],
      "env": {
        "ROOTLY_API_TOKEN": "<YOUR_ROOTLY_API_TOKEN>"
      }
    }
  }
}

Obtener su token de API

Para todas las opciones de instalación, necesitará un token de API de Rootly. Genere uno en Account > Manage API keys > Generate New API Key.

  • Para Opción 1 y 3: Use el token directamente como ROOTLY_API_TOKEN
  • Para Opción 2: Use el token con el prefijo Bearer en ROOTLY_AUTH_HEADER

Configuración del Desarrollador

Para propósitos de desarrollo y pruebas:

  1. Instalar dependencias:

    uv pip install .
  2. Crear entorno virtual:

    uv venv .venv
    source .venv/bin/activate  # On Windows: .venv\Scripts\activate
  3. Ejecutar cliente de prueba:

    python test_mcp_client.py

Personalización

Puedes personalizar qué rutas de API están expuestas modificando la configuración en src/rootly_mcp_server/server.py. Esto te permite controlar qué endpoints de la API de Rootly están disponibles a través del servidor MCP.

Soporte

Esta integración es desarrollada y mantenida por Rootly AI Labs como un proyecto de código abierto bajo la licencia Apache-2.0. El proyecto se enfoca en la confiabilidad del sistema y la excelencia operativa, y da la bienvenida a las contribuciones y comentarios de la comunidad.

Para preguntas o problemas:

Documentación Relacionada