Waroom MCP

Accede a la API de Waroom a través del Protocolo de Contexto del Modelo.

GitHub
1
Prueba este MCPPatrocinado

Documentación

Waroom MCP

npm version

[!CAUTION] Este es todavía un proyecto experimental, y no se garantiza su estabilidad ni rendimiento. Tenga cuidado al usarlo.

Este proyecto es un servidor de Model Context Protocol (MCP) para interactuar con la API de Waroom. Permite obtener diversos tipos de información de Waroom mediante un protocolo estandarizado.

Resumen

El servidor Waroom MCP proporciona una forma estructurada de acceder a los endpoints de la API de Waroom. Admite diversas funciones, como la obtención de información de incidentes y de post-mortems.

Configuración

Uso con Claude Code

claude mcp add waroom-mcp --env WAROOM_API_KEY=your-api-key -- npx @topotal/waroom-mcp

[!NOTE] Si utiliza nodenv o nvm, especifique la ruta completa de npx.

Uso con Claude Desktop

Agregue lo siguiente al archivo de configuración:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "waroom-mcp": {
      "command": "npx",
      "args": ["@topotal/waroom-mcp"],
      "env": {
        "WAROOM_API_KEY": "your-api-key"
      }
    }
  }
}

Después de la configuración, reinicie Claude Desktop para poder utilizar las diversas funciones de Waroom.

Herramientas disponibles

Este servidor de Model Context Protocol proporciona las siguientes herramientas relacionadas con Waroom:

Relacionadas con incidentes

  • waroom_create_incident: Creación de incidentes (especificando nombre del servicio, título, severidad, etc.)
  • waroom_get_incidents: Lista de incidentes con paginación
  • waroom_get_incident_details: Detalle de un incidente individual por UUID
  • waroom_update_incident_severity: Actualización de la severidad de un incidente
  • waroom_update_incident_status: Actualización del estado de un incidente
  • waroom_create_incident_metrics: Creación de métricas de incidente (actualización de TTD/TTA/TTI/TTF/TTR)
  • waroom_update_incident_labels: Asignar o actualizar etiquetas a un incidente

Relacionadas con post-mortems

  • waroom_get_postmortems: Lista de post-mortems con paginación
  • waroom_create_postmortem: Creación de post-mortems
  • waroom_get_postmortem_template: Obtención de plantillas de post-mortem

Relacionadas con servicios

  • waroom_get_services: Obtención de la lista de servicios
  • waroom_get_service_architecture_context: Obtención del contexto de arquitectura de un servicio específico
  • waroom_update_service_architecture_context: Actualización del contexto de arquitectura de un servicio específico

Gestión de etiquetas

  • waroom_get_service_labels: Obtener la lista de etiquetas de un servicio específico
  • waroom_create_service_label: Crear una nueva etiqueta para un servicio específico
  • waroom_update_service_label: Actualizar una etiqueta de un servicio específico
  • waroom_delete_service_label: Eliminar una etiqueta de un servicio específico

Relacionadas con runbooks

  • waroom_get_runbooks: Lista de runbooks con paginación
  • waroom_get_runbook: Detalle de un runbook individual por namespace
  • waroom_update_runbook: Actualización de un runbook (cambios de contenido y namespace)

Relacionadas con elementos de acción

  • waroom_get_incident_action_items: Obtener la lista de elementos de acción de un incidente específico
  • waroom_create_incident_action_item: Crear un elemento de acción para un incidente específico
  • waroom_get_incident_action_item: Obtener el detalle de un elemento de acción
  • waroom_update_incident_action_item: Actualización de un elemento de acción (título, estado, responsable)
  • waroom_delete_incident_action_item: Eliminación de un elemento de acción

Relacionadas con usuarios

  • waroom_get_users: Obtener la lista de usuarios de la organización (para verificar el nickname usado al asignar responsables)

Comandos de barra (Claude Code)

En Claude Code, puede utilizar los siguientes comandos de barra para agilizar la respuesta ante incidentes.

/mcp__waroom_mcp__create

Es un comando de barra que inicia la respuesta ante un incidente y realiza un seguimiento automático del trabajo.

Cómo usarlo

# タイトル指定あり
/mcp__waroom_mcp__create "データベース接続エラー"

# タイトル指定なし（対話で質問）
/mcp__waroom_mcp__create

Funciones principales

  • Búsqueda automática de servicios: Selección interactiva desde la lista de servicios
  • Creación automática de incidentes: Se crea automáticamente con severidad unknown
  • Seguimiento automático del trabajo: Determina automáticamente la fase a partir de las declaraciones del respondedor y actualiza Waroom
    • Inicio de la investigación → investigating + registro de TTD
    • Identificación de la causa → registro de TTA
    • Inicio de la corrección → fixing + registro de TTI
    • Finalización de la corrección → resolved + registro de TTF/TTR
  • Actualización continua: Mantiene la información del incidente al día durante toda la conversación

Escenarios de uso

Cuando un respondedor avanza en el trabajo de respuesta ante un incidente (investigación de código, revisión de registros, trabajo de corrección) con Claude Code, puede actualizar automáticamente la información del incidente en Waroom y dejar un registro. Sin necesidad de instrucciones explícitas, se determina automáticamente a partir del contenido del trabajo y se actualizan el estado y las métricas adecuados.

/mcp__waroom_mcp__respond

Es un comando de barra que inicia la respuesta ante un incidente existente.

Cómo usarlo

# UUID を指定
/mcp__waroom_mcp__respond "12345678-1234-1234-1234-123456789abc"

# URL を指定（UUID は自動抽出されます）
/mcp__waroom_mcp__respond "https://app.waroom.com/incidents/12345678-1234-1234-1234-123456789abc"

Funciones principales

  • Obtención automática del incidente: Obtiene el detalle del incidente a partir del UUID o URL especificado
  • Obtención automática de información del servicio: Obtiene y presenta el contexto de arquitectura del servicio
  • Actualización automática de estado: Si es detected, se actualiza automáticamente a investigating
  • Seguimiento automático del trabajo: Igual que /create, determina automáticamente la fase a partir del contenido del trabajo y actualiza Waroom
  • Actualización continua: Mantiene la información del incidente al día durante toda la conversación

Escenarios de uso

Se utiliza cuando ya se ha creado un incidente en Waroom y se desea iniciar la respuesta ante ese incidente. Basta con pegar la URL del incidente incluida en la notificación de Slack o en el correo electrónico para comenzar de inmediato.

Diferencias con /create

  • /create: Selección de servicio → creación de incidente → inicio de la respuesta
  • /respond: Obtención del incidente → inicio de la respuesta (se omite la creación del incidente)

Recursos

waroom://about

Es una guía detallada de uso de Waroom MCP. Proporciona información completa sobre la automatización de la respuesta ante incidentes, la gestión de post-mortems, escenarios de uso reales, solución de problemas, etc.

Método de acceso

Puede consultarlo en Claude Code o Claude Desktop de la siguiente manera:

@waroom:waroom://about

Contenido incluido

  • Inicio rápido: Cómo iniciar la respuesta ante un incidente de inmediato
  • Mecanismo de seguimiento automático: Detalles de la función que determina automáticamente la fase a partir del contenido del trabajo
  • Escenarios de uso reales: Ejemplos concretos de fallos, investigación de incidentes pasados y creación de post-mortems
  • Formas útiles de uso: Instrucciones en lenguaje natural, actualizaciones en conversaciones continuas
  • Herramientas disponibles: Descripción detallada de todas las funciones
  • Configuración del entorno: Procedimiento de instalación
  • Solución de problemas: Problemas comunes y sus soluciones