sentry-mcp — MCP-сервер для Claude Code: ошибки Sentry в чате
Подключает Sentry к ИИ-ассистенту: разбор ошибок, трейсов и производительности прямо в диалоге. Пригодится, когда баг нужно найти, не уходя из редактора.
claude mcp add --transport http sentry-mcp https://mcp.sentry.dev/mcpЧто делает sentry-mcp
Сервер работает как прослойка между ассистентом и API Sentry. Он рассчитан на сценарии отладки, где человек остаётся в цикле: ассистент смотрит ошибки, трейсы и логи, а решение принимает разработчик. В Claude ставится плагин, который добавляет субагента sentry-mcp — тот подхватывает вопросы про ошибки и производительность сам.
Есть два транспорта. Удалённый подключается по адресу https://mcp.sentry.dev/mcp и не требует локального процесса. Локальный stdio запускается через npx @sentry/mcp-server@latest и нужен в основном для self-hosted Sentry: тогда добавляют --host, а для внутренних установок без TLS ещё и --insecure-http. Токен доступа создаётся в Sentry с правами на чтение организации и проектов, запись в проекты и команды, а также event:write.
Инструменты поиска по ошибкам, трейсам и логам переводят запрос на язык Sentry через LLM. Без настроенного провайдера они просто не появятся, остальные инструменты продолжат работать. Провайдера задают переменной EMBEDDED_AGENT_PROVIDER — автоподбор по одному лишь ключу API устарел. При --host на не-sentry.io из набора выпадает скилл seer, потому что Seer в self-hosted Sentry нет; вернуть его можно через --skills=inspect,seer.
Какие задачи решает
- разобрать стектрейс из Sentry, не открывая веб-интерфейс
- найти, какие ошибки чаще всего падают в продакшене
- посмотреть трейс медленного запроса и его тайминги
- связать падение с конкретным релизом или окружением
- выгрузить список открытых issue по проекту
Примеры запросов агенту
- Покажи последние ошибки проекта из Sentry за сутки
- Найди трейс этого запроса и скажи, где он тормозит
- Какие issue в Sentry выросли после последнего релиза?
Как установить sentry-mcp
1Командой платформы: удалённый сервер
claude mcp add --transport http sentry-mcp https://mcp.sentry.dev/mcp2Командой платформы
claude mcp add --env SENTRY_ACCESS_TOKEN=<SENTRY_ACCESS_TOKEN> --transport stdio mcp-server -- npx -y @sentry/mcp-serverВместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
codex mcp add mcp-server --url https://mcp.sentry.dev/mcp2Командой платформы
codex mcp add mcp-server --env SENTRY_ACCESS_TOKEN=<SENTRY_ACCESS_TOKEN> -- npx -y @sentry/mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.sentry.dev/mcp"
}
}
}{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@sentry/mcp-server"
],
"env": {
"SENTRY_ACCESS_TOKEN": "<SENTRY_ACCESS_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp-server": {
"type": "http",
"url": "https://mcp.sentry.dev/mcp"
}
}
}{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sentry/mcp-server"
],
"env": {
"SENTRY_ACCESS_TOKEN": "<SENTRY_ACCESS_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http mcp-server https://mcp.sentry.dev/mcp2Командой платформы
gemini mcp add -e SENTRY_ACCESS_TOKEN=<SENTRY_ACCESS_TOKEN> mcp-server npx -y @sentry/mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о sentry-mcp
Как установить sentry-mcp в Claude Code?
Добавьте маркетплейс: claude plugin marketplace add getsentry/sentry-mcp, затем установите плагин: claude plugin install sentry-mcp@sentry-mcp. После этого появится субагент sentry-mcp.
Что делает sentry-mcp?
Даёт ассистенту доступ к ошибкам, issue, трейсам и логам Sentry. В Claude запросы к Sentry автоматически уходят субагенту sentry-mcp.
Почему не работают инструменты поиска по ошибкам и логам?
Им нужен LLM-провайдер: без него эти инструменты недоступны, а остальные работают как обычно. Провайдера указывают в EMBEDDED_AGENT_PROVIDER.
