Sentry MCP Server

Что умеет сервер

Sentry MCP выпускает сам Sentry (репозиторий getsentry, адрес сервиса mcp.sentry.dev). По описанию сервиса он связывает AI-помощника с Sentry, чтобы искать ошибки, анализировать производительность, разбирать задачи (issues), читать документацию и управлять проектами. Авторы подчёркивают, что набор инструментов рассчитан на разработчиков и отладку: сервер задуман для помощников, где человек остаётся в контуре, а не как универсальный доступ ко всему в Sentry.

Возможности разделены на группы (skills): в README встречаются inspect, triage, seer и project-management, их можно включать и отключать. Инструменты поиска (search_errors, search_traces, search_logs, search_issues и другие) переводят вопрос на обычном языке в запрос на языке Sentry.

Когда использовать

Подключайте сервер, если отладка идёт в связке с Sentry: показать свежие ошибки проекта, найти событие по описанию, посмотреть трассы и логи. Основной сценарий в README: удалённый сервер с входом через OAuth и подключением к Cursor, Claude Code и похожим инструментам. Для самостоятельно развёрнутого (self-hosted) Sentry есть локальный запуск через stdio.

Подключение можно сузить до организации или даже проекта: адрес вида mcp/{organizationSlug}/{projectSlug} подставляет их по умолчанию и скрывает лишние инструменты. Для проекта это рекомендованный вариант.

Ограничения и безопасность

Все подключения к удалённому серверу идут через OAuth, при первом входе откроется авторизация в вашем аккаунте Sentry. Если клиент поддерживает свои заголовки, можно передать токен Sentry напрямую со схемой Sentry-Bearer, тогда за срок жизни и обновление токена отвечаете вы.

В локальном режиме stdio нужен токен пользователя Sentry с правами org:read, project:read, project:write, team:read, team:write и event:write. ИИ-поиск (search_errors, search_traces и др.) требует настроенного провайдера LLM: OpenAI, Azure OpenAI, Anthropic или OpenRouter, и в README рекомендуют явно задать EMBEDDED_AGENT_PROVIDER. Без провайдера остальные инструменты работают. Для self-hosted Sentry навык seer по умолчанию исключается, потому что Seer в нём недоступен.

Claude Code (удалённый сервер)

Базовый адрес сервера: https://mcp.sentry.dev/mcp. Его можно сузить до организации (/mcp/{organizationSlug}) или проекта. Подставьте свои значения:

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp/{organizationSlug}/{projectSlug}

Затем выполните вход через OAuth. Для Claude Code есть и плагин с подагентом, который автоматически подключается при вопросах об ошибках, задачах, трассах и производительности:

claude plugin marketplace add getsentry/sentry-mcp
claude plugin install sentry-mcp@sentry-mcp

Для экспериментальных вариантов инструментов:

claude plugin install sentry-mcp@sentry-mcp-experimental

Cursor

Нажмите кнопку «Install MCP Server» на странице сервиса или добавьте в настройки MCP:

{
  "mcpServers": {
    "sentry": {
      "url": "https://mcp.sentry.dev/mcp/{organizationSlug}/{projectSlug}"
    }
  }
}

VS Code

В палитре команд выберите MCP: Add Server, затем HTTP и введите адрес:

https://mcp.sentry.dev/mcp/{organizationSlug}/{projectSlug}

Удалённый сервер с токеном Sentry

Клиенты, которые умеют передавать свои HTTP-заголовки, могут отправить токен Sentry напрямую:

{
  "mcpServers": {
    "sentry": {
      "url": "https://mcp.sentry.dev/mcp",
      "headers": {
        "Authorization": "Sentry-Bearer ${SENTRY_ACCESS_TOKEN}"
      }
    }
  }
}

Локальный запуск через stdio

Подходит, например, для Sentry на собственном сервере. Нужен пользовательский токен Sentry с правами org:read, project:read, project:write, team:read, team:write и event:write:

npx @sentry/mcp-server@latest --access-token=sentry-user-token

Для Sentry на собственном сервере добавьте имя хоста (только имя, без схемы):

npx @sentry/mcp-server@latest --access-token=TOKEN --host=sentry.example.com

Тот же запуск в виде конфигурации клиента (поиск с ИИ требует провайдера LLM):

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["@sentry/mcp-server"],
      "env": {
        "SENTRY_ACCESS_TOKEN": "your-token",
        "EMBEDDED_AGENT_PROVIDER": "openai",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}