Sentry MCP Server

Un servidor MCP para interactuar con la plataforma de seguimiento de errores y monitoreo de rendimiento Sentry.

Documentación

Nota - Esto ha sido en gran medida superado por el Remote-MCP Server que soporta muchas más capacidades (autenticación, mejores herramientas, etc...). Este existe con fines educativos como un servidor MCP independiente; pero con toda probabilidad querrás usar el remoto. Puedes verlo en vivo en https://mcp.sentry.dev

Sentry MCP Server

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con Sentry. Este servidor MCP proporciona herramientas para interactuar con la API de Sentry, permitiendo a los asistentes de IA recuperar y analizar datos de errores, gestionar proyectos y monitorear el rendimiento de las aplicaciones.

Requisitos

  • Node.js (v14 o superior)
  • npm o yarn
  • Cuenta de Sentry con acceso a la API
  • Token de autenticación de Sentry con los permisos adecuados

Configuración

  1. Instala las dependencias:
    npm install
    

Uso dentro de un IDE

Este MCP ha sido verificado para funcionar con Cursor, Codeium Windsurf y Claude Desktop.

Uso con Claude

Para usar este servidor MCP con Claude, añade la siguiente configuración a tus ajustes de Claude:

{
    "mcpServers": {
        "sentry": {
            "command": "npx",
            "args": ["ts-node", "/Users/<your-user-directory>/sentry-mcp-ts/index.ts"],
            "env": {
                "SENTRY_AUTH": "<YOUR_AUTH_TOKEN>"
            }
        }
    }
}
  • Actualiza con la ruta de tu directorio en el campo args.
  • Reemplaza <YOUR_AUTH_TOKEN> con tu token de autenticación de Sentry.

Herramientas disponibles

list_projects

Lista todos los proyectos de Sentry accesibles para una organización determinada.

Parámetros:

  • organization_slug (string, required): El slug de la organización de la que listar proyectos
  • view (string, optional): Tipo de vista, ya sea "summary" o "detailed" (por defecto: "detailed")
  • format (string, optional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

resolve_short_id

Recupera detalles sobre un problema usando su ID corto.

Parámetros:

  • organization_slug (string, required): El slug de la organización a la que pertenece el problema
  • short_id (string, required): El ID corto del problema a resolver (p. ej., PROJECT-123)
  • format (string, optional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

get_sentry_event

Recupera y analiza un evento específico de Sentry de un problema.

Parámetros:

  • issue_id_or_url (string, required): Ya sea una URL completa del problema de Sentry o solo el ID numérico del problema
  • event_id (string, required): El ID de evento específico a recuperar
  • view (string, optional): Tipo de vista, ya sea "summary" o "detailed" (por defecto: "detailed")
  • format (string, optional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

list_error_events_in_project

Lista eventos de error de un proyecto específico de Sentry.

Parámetros:

  • organization_slug (string, required): El slug de la organización a la que pertenece el proyecto
  • project_slug (string, required): El slug del proyecto del que listar eventos
  • view (string, optional): Tipo de vista, ya sea "summary" o "detailed" (por defecto: "detailed")
  • format (string, optional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

create_project

Crea un nuevo proyecto en Sentry y recupera sus claves de cliente.

Parámetros:

  • organization_slug (string, required): El slug de la organización en la que crear el proyecto
  • team_slug (string, required): El slug del equipo al que asignar el proyecto
  • name (string, required): El nombre del nuevo proyecto
  • platform (string, optional): La plataforma para el nuevo proyecto
  • view (string, optional): Tipo de vista, ya sea "summary" o "detailed" (por defecto: "detailed")
  • format (string, optional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

list_project_issues

Lista problemas de un proyecto específico de Sentry.

Parámetros:

  • organization_slug (string, required): El slug de la organización a la que pertenece el proyecto
  • project_slug (string, required): El slug del proyecto del que listar problemas
  • view (string, optional): Tipo de vista, ya sea "summary" o "detailed" (por defecto: "detailed")
  • format (string, optional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

list_issue_events

Lista eventos para un problema específico de Sentry.

Parámetros:

  • organization_slug (string, required): El slug de la organización a la que pertenece el problema
  • issue_id (string, required): El ID del problema del que listar eventos
  • view (string, optional): Tipo de vista, ya sea "summary" o "detailed" (por defecto: "detailed")
  • format (string, optional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

get_sentry_issue

Recupera y analiza un problema de Sentry.

Parámetros:

  • issue_id_or_url (string, required): Ya sea una URL completa del problema de Sentry o solo el ID numérico del problema
  • view (string, optional): Tipo de vista, ya sea "summary" o "detailed" (por defecto: "detailed")
  • format (string, optional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

list_organization_replays

Lista repeticiones de una organización específica de Sentry.

Parámetros:

  • organization_slug (string, required): El slug de la organización de la que listar repeticiones
  • project_ids (string[], optional): Lista de IDs de proyecto para filtrar repeticiones
  • environment (string, optional): Entorno para filtrar repeticiones
  • stats_period (string, optional): Período de tiempo para estadísticas (p. ej., "24h", "7d")
  • start (string, optional): Fecha de inicio para filtrar repeticiones
  • end (string, optional): Fecha de fin para filtrar repeticiones
  • sort (string, optional): Campo por el que ordenar repeticiones
  • query (string, optional): Consulta de búsqueda para filtrar repeticiones
  • per_page (number, optional): Número de repeticiones por página
  • cursor (string, optional): Cursor para la paginación
  • view (string, optional): Tipo de vista, ya sea "summary" o "detailed" (por defecto: "detailed")
  • format (string, optional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

Ejecutar el servidor

npx ts-node index.ts

Autenticación

Esta herramienta requiere un token de autenticación de Sentry con los permisos adecuados para acceder a la API de Sentry. Puedes generar un token en la configuración de tu cuenta de Sentry en Settings -> User Settings -> Auth Tokens.