Sentry MCP — Сценарии использования, Установка & Живое демо

Name: Sentry MCP MCP Server
Author: getsentry

Зачем использовать

Ключевые функции

Поиск проблем с синтаксисом запросов Sentry
Получение полного payload события: stack trace, хлебные крошки, запрос, теги
Здоровье релизов: обнаружение регрессий, adoption, crash-free rate
Трейсы производительности с разбивкой по span-ам
Метаданные проектов и команд для кросс-проектных запросов

Живое демо

Как выглядит на практике

sentry-mcp-getsentry.replay ▶ готово

0/0

Установка

Выберите клиент

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

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "sentry-mcp-getsentry",
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "sentry-mcp-getsentry": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@sentry/mcp-server"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add sentry-mcp-getsentry -- npx -y @sentry/mcp-server

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Sentry MCP

Полная отладка продакшн-ошибки без выхода из Claude

👤 Разработчики, обрабатывающие дежурные алерты ⏱ ~20 min intermediate

Когда использовать: Sentry прислал алерт; нужна корневая причина прямо сейчас.

Предварительные требования

Auth token для Sentry — User Settings → Auth Tokens → создайте с правами 'project:read', 'event:read', 'org:read'
Токен в переменных окружения — Задайте SENTRY_AUTH_TOKEN и SENTRY_HOST (sentry.io или self-hosted)

Поток

Найти проблему

Use sentry-mcp. Find the most-firing issue in project 'web' from the last 6 hours.✓ Скопировано

→ ID проблемы + количество + первое/последнее появление
Получить полный контекст

Get the latest event for that issue — stack trace, breadcrumbs, request data.✓ Скопировано

→ Полный payload события с фреймами + историей действий пользователя
Связать с деплоем

What release was running when this first appeared? List the commits in that release.✓ Скопировано

→ Тег релиза + список коммитов
Предложить исправление

Looking at the stack and the commits — which commit likely caused this? Draft a fix in the relevant file.✓ Скопировано

→ Конкретный файл и строка; готовый патч

Итог: От алерта до кандидата на исправление за минуты, с полной цепочкой доказательств.

Подводные камни

Source maps отсутствуют — фреймы стека бесполезны — Проверьте загрузку source maps в ваших релизах Sentry; без них минифицированные фреймы ничего не дают Claude

Сочетать с: github

Предполётная проверка перед продвижением релиза

👤 Релиз-инженеры, хранители деплоев ⏱ ~15 min intermediate

Когда использовать: Готовитесь продвинуть canary-релиз на 100%.

Поток

Сравнить здоровье релизов

Use sentry-mcp. Compare crash-free rate of release 1.4.0 vs 1.3.9 over their respective canary windows.✓ Скопировано

→ Crash-free % на каждый релиз, adoption, количество регрессий
Проверить новые ошибки

List any issues unique to 1.4.0 (not seen in 1.3.9 or earlier).✓ Скопировано

→ Список новых проблем с количеством
Дать рекомендацию

Given crash-free is X% and N net-new errors, recommend ship/halt with reason.✓ Скопировано

→ Чёткая рекомендация с указанием порогов

Итог: Решение о продвижении или остановке, основанное на данных, а не на интуиции.

Подводные камни

Слишком низкий adoption для статистической значимости — Claude должен отмечать окна с низким adoption как неопределённые — не делать вид, что знает

Расследование регрессии производительности по трейсам транзакций

👤 Бэкенд-инженеры, охотящиеся за latency ⏱ ~25 min advanced

Когда использовать: p95 latency для /checkout вырос после последнего деплоя.

Поток

Получить недавний медленный трейс

Use sentry-mcp. Get a trace for transaction 'POST /checkout' with duration > 2s from the last hour.✓ Скопировано

→ Трейс с разбивкой по span-ам
Найти новый span

Compare span list to a similar trace from last week. Which spans are new or longer?✓ Скопировано

→ Разница: новый DB-запрос 'SELECT cart_items', avg 1.4s
Привязать к коду

What commit added that query? Suggest an index or a query rewrite.✓ Скопировано

→ Коммит + конкретное предложение по исправлению

Итог: Корневая причина регрессии производительности с предложением исправления на уровне кода.

Подводные камни

Слишком низкий sampling rate — медленный трейс не поймали — Временно увеличьте sample rate или попросите Claude использовать stats-эндпоинты

Сочетать с: github

Комбинации

Сочетайте с другими MCP — эффект x10

sentry-mcp-getsentry + github

Из фрейма Sentry напрямую к черновику PR

Pull issue X from Sentry, find the offending commit via GitHub, draft a fix as a new branch + PR.✓ Скопировано

sentry-mcp-getsentry + linear

Автоматическое создание инженерных тикетов из регрессий

For each new release-blocking issue in Sentry, create a Linear ticket with the stack + suggested owner.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
search_issues	project, query, statsPeriod?	Фильтрация проблем по запросу Sentry	1 Sentry API call
get_issue	issue_id	Верхнеуровневый взгляд на одну проблему	1 API call
get_event	event_id or 'latest'	Получить конкретное вхождение с полным контекстом	1 API call
list_releases	project, version?	Сравнение релизов	1 API call
get_trace	trace_id	Расследование производительности	1 API call

Стоимость и лимиты

Во что обходится

Квота API: Стандартные rate limit Sentry API — пики могут вызвать 429
Токенов на вызов: Payload события может занимать 5–20k токенов — запрашивайте избирательно
Деньги: Бесплатно для Sentry developer plan; платные планы имеют более высокие rate limit
Совет: Сначала используйте search_issues для сужения; вызывайте get_event только для кандидатов — не для всего списка

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: project:read event:read org:read

Хранение учётных данных: Переменная окружения SENTRY_AUTH_TOKEN (используйте scoped токен, привязанный к проекту)

Исходящий трафик: Все вызовы на ваш Sentry-хост (sentry.io или self-hosted)

Никогда не давайте: project:write или org:write чат-управляемому агенту

Данные событий могут содержать PII (тела запросов, user ID) — применяйте правила data-scrubbing в Sentry upstream

Устранение неполадок

Частые ошибки и исправления

401 Unauthorized

Токен истёк или неверный scope — создайте новый с перечисленными read-scopes

Проверить: curl -H 'Authorization: Bearer $SENTRY_AUTH_TOKEN' $SENTRY_HOST/api/0/projects/

Stack trace показывает только минифицированные фреймы

Проверьте загрузку source maps в pipeline вашего релиза; без них Claude не может анализировать фреймы

Проверить: Sentry UI → Release → Artifacts

404 на известной проблеме

Проблема находится в проекте, который не охватывает токен — пересоздайте токен с нужным проектом

Self-hosted Sentry — connection refused

Явно задайте SENTRY_HOST с URL вашего экземпляра и протоколом

Проверить: curl $SENTRY_HOST/api/0/

Альтернативы

Sentry MCP в сравнении

Альтернатива	Когда использовать	Компромисс
Datadog MCP	Ваша команда использует Datadog APM/error tracking	Другой охват; APM-ориентированный, меньше фокуса на проблемах
Honeycomb MCP	Вы работаете в observability-first подходе с событиями, а не со stack traces	Нет первоклассной группировки проблем; ориентирован на трейсы

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills