sentry-mcp

Сервис MCP от Sentry в первую очередь предназначен для агентов кодирования с участием человека (human-in-the-loop). Наш выбор инструментов и приоритеты сосредоточены на рабочих процессах разработчиков и сценариях отладки, а не на предоставлении MCP-сервера общего назначения для всей функциональности Sentry.

Этот удаленный MCP-сервер выступает в качестве промежуточного звена для вышестоящего API Sentry, оптимизированного для помощников по программированию, таких как Cursor, Claude Code и аналогичных инструментов разработки. Он основан на работе Cloudflare по созданию удаленных MCP.

Начало работы

Вы найдете всю необходимую информацию, посетив развернутый сервис в рабочей среде:

https://mcp.sentry.dev

Если вы хотите внести свой вклад, узнать, как это работает, или запустить это для self-hosted версии Sentry, продолжайте чтение ниже.

Плагин Claude Code

Установите как плагин Claude Code для автоматического делегирования субагентам:

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

Это предоставляет субагент sentry-mcp, которому Claude автоматически делегирует задачи, когда вы спрашиваете об ошибках, инцидентах, трассировках или производительности в Sentry.

Для перспективных вариантов инструментов и функций:

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

Stdio против Remote

Хотя этот репозиторий ориентирован на работу в качестве MCP-сервиса, мы также поддерживаем транспорт stdio. Это все еще находится в стадии разработки, но является самым простым способом адаптировать и запустить MCP для self-hosted установки Sentry.

Примечание: Инструменты поиска на базе ИИ (search_events, search_issues и т. д.) требуют провайдера LLM (OpenAI или Anthropic). Эти инструменты используют обработку естественного языка для перевода запросов в синтаксис запросов Sentry. Без настроенного провайдера эти конкретные инструменты будут недоступны, но все остальные инструменты будут функционировать нормально.

Чтобы использовать транспорт stdio, вам нужно создать токен аутентификации пользователя (User Auth Token) в Sentry с необходимыми областями доступа (scopes). На момент написания это:

org:read
project:read
project:write
team:read
team:write
event:write

Запустите транспорт:

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

Нужно подключиться к self-hosted развертыванию? Добавьте --host (только имя хоста, например, --host=sentry.example.com) при выполнении команды.

Некоторые функции (например, Seer) могут быть недоступны в self-hosted экземплярах. Вы можете отключить определенные навыки, чтобы предотвратить отображение неподдерживаемых инструментов:

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

Переменные окружения

SENTRY_ACCESS_TOKEN= # Required: Your Sentry auth token

# LLM Provider Configuration (required for AI-powered search tools)
EMBEDDED_AGENT_PROVIDER= # Required: 'openai' or 'anthropic'
OPENAI_API_KEY= # Required if using OpenAI
ANTHROPIC_API_KEY= # Required if using Anthropic

# Optional overrides
SENTRY_HOST= # For self-hosted deployments
MCP_DISABLE_SKILLS= # Disable specific skills (comma-separated, e.g. 'seer')

Важно: Всегда устанавливайте EMBEDDED_AGENT_PROVIDER, чтобы явно указать вашего провайдера LLM. Автоматическое определение только на основе ключей API является устаревшим и будет удалено в будущих выпусках. См. docs/embedded-agents.md для получения подробных параметров конфигурации.

Пример конфигурации MCP

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

Если вы оставите переменную хоста не установленной, CLI автоматически нацеливается на SaaS-сервис Sentry. Устанавливайте переопределение только при работе с self-hosted Sentry.

Для self-hosted экземпляров, которые не поддерживают Seer:

{
 "mcpServers": {
 "sentry": {
 "command": "npx",
 "args": ["@sentry/mcp-server"],
 "env": {
 "SENTRY_ACCESS_TOKEN": "your-token",
 "SENTRY_HOST": "sentry.example.com",
 "MCP_DISABLE_SKILLS": "seer"
 }
 }
 }
}

Инспектор MCP

MCP включает Инспектор для легкого тестирования сервиса:

pnpm inspector

Введите URL-адрес MCP-сервера (http://localhost:5173) и нажмите «connect». Это должно запустить для вас процесс аутентификации.

Примечание: Если у вас возникли проблемы с потоком OAuth при доступе к инспектору на 127.0.0.1, попробуйте использовать localhost, посетив http://localhost:6274.

Related MCP server: Sentry MCP Server

Локальная разработка

Чтобы внести изменения, вам нужно настроить локальную среду:

1. Настройка среды и навыков агента:

   make setup-env # Creates .env files and installs shared agent skills

   Это также запускает npx @sentry/dotagents install для установки общих навыков из getsentry/skills в .agents/skills/ (символические ссылки в .claude/skills и .cursor/skills). Если вам нужно обновить навыки позже, запустите это напрямую:

   npx @sentry/dotagents install

2. Создайте OAuth-приложение в Sentry (Настройки => API => Приложения):

   • URL домашней страницы: http://localhost:5173

   • Авторизованные URI перенаправления: http://localhost:5173/oauth/callback

   • Запишите свой Client ID и сгенерируйте Client secret

3. Настройте свои учетные данные:

   • Отредактируйте .env в корневом каталоге и добавьте свой OPENAI_API_KEY

   • Отредактируйте packages/mcp-cloudflare/.env и добавьте:

     • SENTRY_CLIENT_ID=ваш_клиентский_id_для_разработки

     • SENTRY_CLIENT_SECRET=ваш_клиентский_секрет_для_разработки

     • COOKIE_SECRET=мой-супер-секретный-cookie

4. Запустите сервер разработки:

   pnpm dev

Проверка

Запустите сервер локально, чтобы сделать его доступным по адресу http://localhost:5173

pnpm dev

Чтобы протестировать локальный сервер, введите http://localhost:5173/mcp в Инспекторе и нажмите «connect». Как только вы выполните инструкции, вы сможете «List Tools» (перечислить инструменты).

Тесты

Включены три набора тестов: модульные тесты, оценки (evals) и ручное тестирование.

Модульные тесты можно запустить с помощью:

pnpm test

Оценки требуют наличия файла .env в корне проекта с некоторой конфигурацией:

# .env (in project root)
OPENAI_API_KEY= # Also required for AI-powered search tools in production

Примечание: Корневой файл .env предоставляет значения по умолчанию для всех пакетов. Отдельные пакеты могут иметь свои собственные файлы .env для переопределения этих значений во время разработки.

Как только это будет сделано, вы можете запустить их с помощью:

pnpm eval

Ручное тестирование (предпочтительно для тестирования изменений MCP):

# Test with local dev server (default: http://localhost:5173)
pnpm -w run cli "who am I?"

# Test agent mode (use_sentry tool only)
pnpm -w run cli --agent "who am I?"

# Test against production
pnpm -w run cli --mcp-host=https://mcp.sentry.dev "query"

# Test with local stdio mode (requires SENTRY_ACCESS_TOKEN)
pnpm -w run cli --access-token=TOKEN "query"

Примечание: CLI по умолчанию использует http://localhost:5173. Переопределите с помощью --mcp-host или установите переменную окружения MCP_URL.

Комплексные руководства по тестированию:

• Тестирование Stdio: См. docs/testing-stdio.md для получения полного руководства по сборке, запуску и тестированию реализации stdio (IDE, MCP Inspector)

• Удаленное тестирование: См. docs/testing-remote.md для получения полного руководства по тестированию удаленного сервера (OAuth, веб-интерфейс, CLI-клиент)

Примечания по разработке

Автоматизированный обзор кода

Этот репозиторий использует инструменты автоматизированного обзора кода (например, Cursor BugBot), чтобы помочь выявить потенциальные проблемы в запросах на слияние (pull requests). Эти инструменты предоставляют полезные отзывы и предложения, но мы не рекомендуем делать эти проверки обязательными, так как точность все еще развивается и может давать ложные срабатывания.

Автоматизированные обзоры следует рассматривать как:

• ✅ Полезные предложения, которые стоит учесть при обзоре кода

• ✅ Отправные точки для обсуждения и улучшения

• ❌ Не блокирующие требования для слияния PR

• ❌ Не замена человеческому обзору кода

При работе с автоматизированными отзывами сосредоточьтесь на основных проблемах, а не на строгом выполнении каждого предложения.

Документация для участников

Хотите внести свой вклад или изучить полную карту документации? См. CLAUDE.md (также доступен как AGENTS.md) для рабочих процессов участников и полного индекса документации. Папка docs/ содержит тематические руководства и файлы .md, интегрированные с инструментами.

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• create_projectB
• create_teamB
• get_error_detailsA
• list_organizationsB
• list_projectsB
• list_teamsA
• search_errors_in_fileA