Sentry MCP

Что такое Sentry MCP?

Sentry MCP – это открытый MCP сервер, предназначенный для безопасного и структурированного доступа к вашим данным и действиям Sentry через стандартизованный Протокол Контекста Модели. Он позволяет хост-приложениям, таким как Claude Desktop или IDE, взаимодействовать с Sentry программным образом через инструменты и конечные точки, совместимые с MCP. Поддерживаются как удаленные, так и локальные (stdio) передачи, что делает его гибким для облачных и локально хостингованных установок Sentry.

Как настроить

1. Промышленное использование:
   Просто получите доступ к развернутой службе по адресу https://mcp.sentry.dev.

2. Локальная установка Sentry (Stdio Транспорт):

   • Создайте токен аутентификации пользователя Sentry с соответствующими правами:

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

   • Запустите сервер MCP:

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

   • Или настройте с помощью переменных окружения:

     SENTRY_ACCESS_TOKEN=
     SENTRY_HOST=
     

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

   • Создайте OAuth приложение в Sentry с http://localhost:5173 в качестве URL главной страницы и URI перенаправления.
   • Добавьте свои учетные данные в .dev.vars в packages/mcp-cloudflare/:

     SENTRY_CLIENT_ID=ваш_client_id
     SENTRY_CLIENT_SECRET=ваш_client_secret
     COOKIE_SECRET=мой-супер-секретный-cookie
     

   • Запустите сервер локально:

     pnpm dev
     

Как использовать

1. Посетите https://mcp.sentry.dev для хостинга, или запустите вашу локальную/stdio инстанцию, как описано выше.
2. Используйте MCP Inspector:
   • Введите URL вашего сервера (например, http://localhost:5173) и подключитесь.
   • Аутентифицируйтесь по запросу (OAuth или токен доступа).
   • Узнайте доступные инструменты через функцию "Список инструментов".
   • Вызывайте необходимые конечные точки инструментов (например, получение проблем, список проектов) напрямую из Inspector или через клиент, поддерживающий LLM.
3. Для локально хостингованного Sentry используйте соответствующие токены и подключайтесь в режиме "stdio".
4. Запустите тесты с помощью pnpm test и оценку на основе LLM с помощью pnpm eval (после задания OPENAI_API_KEY).

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

• Интеграция с Sentry через протокол, совместимый с MCP, позволяя доступ LLM/агентов к данным об ошибках и операциям
• Поддержка как удаленных HTTP(S), так и локальных stdio транспортов для гибкости в развертывании
• Аутентификация на основе OAuth и токенов для безопасного доступа к ресурсам Sentry
• Предустановленный набор обнаруживаемых исполняемых инструментов (действий/конечных точек) для автоматизации и извлечения данных
• Расширяемый и открытый для локальной разработки и вклада
• Включает встроенный инструмент Inspector для интерактивного исследования и тестирования

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

• Позволяет агентам или помощникам на основе LLM мониторить, извлекать или анализировать инциденты Sentry в IDE или унифицированных настольных средах
• Автоматизирует рутинные действия в Sentry, такие как присвоение проблем, изменения статусов или уведомления, инициируемые рабочими процессами ИИ
• Интегрирует данные наблюдаемости Sentry в собственные панели мониторинга или инструменты отчетности на базе языковых моделей
• Обеспечивает администрирование Sentry без касаний или анализирование через безопасный, стандартизированный API без ручного скриптования

Часто задаваемые вопросы

Q1: Могу ли я использовать Sentry MCP с локальными инстанциями Sentry?
Да, Sentry MCP поддерживает локальные инстанции через режим stdio. Вам нужно будет предоставить токен аутентификации пользователя с необходимыми разрешениями и настроить хост соответствующим образом.

Q2: Нужно ли мне создавать OAuth приложение для тестирования Sentry MCP локально?
Для локальной разработки и тестирования вам нужно будет зарегистрировать OAuth приложение в вашей учетной записи Sentry и предоставить его учетные данные в конфигурационных файлах проекта.

Q3: Могут ли LLM изменять мои данные Sentry через инструменты MCP?
Да, инструменты, доступные через MCP, могут как читать, так и изменять данные в Sentry, в зависимости от инструмента и прав вашего токена. Всегда ограничивайте предоставленные токены только необходимыми объемами.

Q4: Как я могу тестировать интеграции моего сервера MCP?
Используйте встроенный инструмент Inspector, подключившись к URL вашего сервера MCP. Это позволяет вам аутентифицироваться, обнаруживать и вызывать инструменты интерактивно для легкой проверки.

Q5: Какие методы аутентификации поддерживаются?
Sentry MCP поддерживает как OAuth (для удаленного сервера), так и аутентификацию на основе токенов (для локального/stdio) потока.