Sentry MCP

Используй Seer для анализа ошибок в продакшне и получения подробного анализа первопричин с конкретными исправлениями кода. Используй этот инструмент, когда: - Пользователь явно просит анализ первопричин, анализ Seer или помощь в исправлении/отладке проблемы. - Ты не можешь точно определить первопричину только по деталям проблемы. НЕ вызывай этот инструмент автоматически следом за get_sentry_resource. Что даёт инструмент: - Анализ первопричины с объяснением на уровне кода. - Конкретные пути к файлам и номера строк, где происходят ошибки. - Конкретные исправления кода, которые можно применить. - Пошаговое руководство по внедрению. Этот инструмент автоматически: 1. Проверяет, существует ли уже анализ (результат мгновенный). 2. Запускает новый AI-анализ, если нужно (около 2-5 минут). 3. Возвращает готовые рекомендации по исправлению. <examples> ### Пользователь: «Запусти Seer для этой проблемы» analyze_issue_with_seer(issueUrl='https://my-org.sentry.io/issues/PROJECT-1Z43') ### Пользователь: «Проанализируй эту проблему и предложи исправление» analyze_issue_with_seer(organizationSlug='my-organization', issueId='ERROR-456') </examples> <hints> - Используй, только когда пользователь явно запрашивает анализ или ты не можешь определить первопричину только из деталей проблемы. - Seer Autofix не поддерживает проблемы с метрическими оповещениями (issueCategory: metric); вместо этого используй get_issue_details и search_events. - Если пользователь предоставил issueUrl, извлеки его и используй только этот параметр. - Анализ включает реальные фрагменты кода и исправления, а не только описания ошибок. - Результаты кешируются — последующие вызовы возвращают результат мгновенно. </hints>

Выполняет доступный инструмент Sentry MCP, найденный через search_sentry_tools. Используй этот инструмент, когда нужно: - Вызвать операцию Sentry, возвращённую search_sentry_tools. - Выполнить инструмент по имени, передав аргументы, соответствующие его схеме. <examples> execute_sentry_tool(name='find_projects', arguments={ organizationSlug: 'my-org' }) execute_sentry_tool(name='whoami', arguments={}) </examples> <hints> - Сначала используй search_sentry_tools, если не уверен, какое имя или аргументы передавать. - Аргументы проверяются по схеме целевого инструмента перед выполнением. - Активные ограничения организации, проекта и региона подставляются автоматически. </hints>

Находит организации, к которым у пользователя есть доступ в Sentry. Используйте этот инструмент, когда нужно: - Просмотреть организации в Sentry - Найти slug организации, чтобы использовать его в других запросах инструментов - Искать конкретные организации по имени или slug Возвращает до 25 результатов. Если вы достигли этого предела, используйте параметр запроса, чтобы сузить результаты.

Находит проекты в Sentry. Используйте этот инструмент, когда вам нужно: - Просмотреть проекты в организации Sentry - Найти slug проекта, чтобы использовать его в других запросах - Поискать конкретные проекты по имени или slug Возвращает до 25 результатов. Если hasMore равен true, используйте параметр query, чтобы сузить результаты.

Получает ресурс Sentry по URL или по типу ресурса плюс идентификатору ресурса. Передавайте URL Sentry напрямую, когда это возможно; тип ресурса определяется автоматически. Поддерживаются issues, events, traces, spans, agent conversations, replays, monitors, preprod snapshots и snapshot images. По умолчанию поиск по trace возвращает сжатую сводку. Agent Conversations: разговор — это набор spans, объединённых общим gen_ai.conversation.id. Используйте resourceType='ai_conversation' с идентификатором разговора или передавайте URL разговора Sentry, чтобы получить стенограмму и детали. Чтобы найти или вывести список разговоров, используйте search_agent_conversations. Разговоры — это НЕ issues — не используйте search_issues для запросов о разговорах. Для preprod snapshot URL (соответствующих 'sentry.io/preprod/snapshots/'): - Без ?selectedSnapshot=: возвращает сводку изменений snapshot (добавленные, изменённые, удалённые изображения) - С ?selectedSnapshot=<имя_файла_изображения>: возвращает предпросмотр изображения и метаданные. Используйте инструмент Sentry get_snapshot_image для получения полных байтов изображения. Идентификаторы ресурсов: - monitor: <slug_монитора> - snapshot: <id_снимка> <examples> get_sentry_resource(url='https://sentry.io/issues/PROJECT-123/') get_sentry_resource(resourceType='issue', organizationSlug='my-org', resourceId='PROJECT-123') get_sentry_resource(resourceType='ai_conversation', organizationSlug='my-org', resourceId='conversation-123') get_sentry_resource(url='https://sentry.sentry.io/preprod/snapshots/123/') get_sentry_resource(url='https://sentry.sentry.io/preprod/snapshots/123/?selectedSnapshot=login_screen.png') </examples>

Ищет события и повторы Sentry. Используется для подсчёта событий и статистики. query — это запрос на естественном языке или поисковый синтаксис Sentry; настроенный агент определяет набор данных, поля и сортировку. Поддерживает ТРИ типа запросов: 1. АГРЕГАЦИИ (количество, суммы, средние): «сколько ошибок», «всего токенов» 2. Отдельные события с временными метками: «журналы ошибок за последний час» 3. ВРЕМЕННЫЕ РЯДЫ (метрика во времени): «ошибки в час», «тренд ошибок во времени» Наборы данных: - errors: события исключений/сбоев с трассировками стека, обычно сгруппированные в проблемы - logs: записи журнала приложения, включая сообщения журнала уровня ошибок - spans: необработанные события трассировок/спанов для производительности, вызовов AI/LLM, запросов и операций - metrics: строки метрик и агрегаты: счётчики, датчики, распределения, значения - profiles: результаты профилирования транзакций/непрерывного профилирования, идентификаторы профилей, профилированные транзакции - replays: результаты повторов сессий: клики в ярости, мёртвые клики, посещённые страницы, пользователи повторов Если пользователь говорит «журналы», «сообщения журнала», «журналы ошибок» или «журналы предупреждений», выбирайте набор logs, а не errors. Поиск по повторам возвращает только списки повторов; count()/avg()/sum() для повторов не поддерживаются. НЕ для сгруппированных списков проблем (используйте search_issues) или скриншотов/изображений приложения (используйте get_latest_base_snapshot). <examples> search_events(organizationSlug='my-org', query='how many errors today') search_events(organizationSlug='my-org', dataset='errors', fields=['issue', 'count()'], sort='-count()') search_events(organizationSlug='my-org', query='errors per hour last 24h') search_events(organizationSlug='my-org', dataset='spans', query='span.op:db', sort='-span.duration') search_events(organizationSlug='my-org', dataset='replays', query='count_errors:>0', sort='-count_errors') </examples> <hints> - Обозначение name/otherName означает <organizationSlug>/<projectSlug>; разбирайте его напрямую, не вызывайте find_organizations/find_projects. - Используйте поля с агрегатными функциями, такими как count(), avg(), sum(), для статистики. - Сортируйте по -count() для самых частых, по -timestamp для самых новых. </hints>

Ищет сгруппированные проблемы/ошибки в Sentry — возвращает СПИСОК проблем, а не подсчёты или агрегации. Передавайте query на естественном языке или в синтаксисе поиска проблем Sentry. Если настроен встроенный агент, он исправляет запрос и сортировку перед выполнением, сохраняя явный синтаксис поиска Sentry. Возвращает сгруппированные проблемы с метаданными: заголовок, статус, количество пользователей. Распространённый синтаксис запросов: - is:unresolved / is:resolved / is:ignored / is:for_review / is:new / is:regressed / is:escalating - level:error / level:warning - firstSeen:-24h / lastSeen:-7d - assigned:me / assigned_or_suggested:me - release:latest - issue.category:feedback - issue.priority:high - environment:production - userCount:>100 НЕ ИСПОЛЬЗОВАТЬ ДЛЯ ПОДСЧЁТОВ/АГРЕГАЦИЙ → используйте search_events НЕ ИСПОЛЬЗОВАТЬ ДЛЯ отдельных событий с временными метками → используйте search_events НЕ ИСПОЛЬЗОВАТЬ ДЛЯ подробностей о конкретной проблеме → используйте get_sentry_resource <examples> search_issues(organizationSlug='my-org', query='критические баги за последнюю неделю') search_issues(organizationSlug='my-org', query='is:unresolved is:unassigned', sort='freq') search_issues(organizationSlug='my-org', query='level:error firstSeen:-24h', projectSlugOrId='my-project') </examples> <hints> - Если пользователь передаёт параметр в формате name/otherName, скорее всего это формат <organizationSlug>/<projectSlugOrId>. - Разбирайте нотацию org/project напрямую, без вызова find_organizations или find_projects. - Параметр projectSlugOrId принимает как slug проекта (например, 'my-project'), так и числовой ID (например, '123456'). </hints>

Ищет в каталоге доступных инструментов Sentry MCP по названию и описанию. Многие операции Sentry намеренно не вынесены в отдельные инструменты верхнего уровня. Используйте этот инструмент для любой задачи, связанной с Sentry, если под рукой нет очевидного прямого инструмента: например, для детального анализа, управления проектами, поиска по документации, снапшотов препродакшена, вложений, DSN, релизов, команд и переключения контекста по конкретному issue. Применяйте этот инструмент, когда нужно: - Найти подходящую операцию Sentry для задачи - Обнаружить инструменты каталога и их схемы для задачи - Просмотреть исполняемую JSON-схему ввода для доступного инструмента <examples> search_sentry_tools(query='list projects') search_sentry_tools(query='issue details') search_sentry_tools(query='find dsn', limit=5) search_sentry_tools(query='snapshot image') </examples> <hints> - Результаты содержат только инструменты, доступные в текущей сессии. - Если операция Sentry не указана как прямой инструмент, сначала выполните поиск здесь, прежде чем решать, что она недоступна. - Возвращаемые схемы уже учитывают ограничения активной организации, проекта и региона. - При выполнении результата из каталога используйте возвращённое название и схему. - Этот инструмент возвращает структурированный JSON. Не парсите markdown из его текстового содержимого. </hints>

Обновляет статус или назначение проблемы Sentry. Используйте это, чтобы решить, переоткрыть, назначить, снять назначение или проигнорировать проблему. <examples> update_issue(organizationSlug='my-org', issueId='PROJECT-123', status='resolved') update_issue(organizationSlug='my-org', issueId='PROJECT-123', assignedTo='user:123456') update_issue(organizationSlug='my-org', issueId='PROJECT-123', assignedTo=null) update_issue(organizationSlug='my-org', issueId='PROJECT-123', status='ignored') update_issue(organizationSlug='my-org', issueId='PROJECT-123', status='ignored', ignoreMode='forever') update_issue(organizationSlug='my-org', issueId='PROJECT-123', status='ignored', ignoreMode='untilOccurrenceCount', ignoreCount=100, ignoreWindowMinutes=60) update_issue(organizationSlug='my-org', issueId='PROJECT-123', status='ignored', reason='Ignoring because this is expected noise from the staging deploy') </examples> <hints> - Укажите issueUrl или organizationSlug + issueId. - Требуется хотя бы один из параметров status или assignedTo. - Опустите assignedTo, чтобы оставить назначение без изменений. Передайте null, чтобы снять назначение; в противном случае используйте user:ID или team:ID_OR_SLUG. - Используйте execute_sentry_tool(name='whoami', arguments={}), чтобы узнать свой идентификатор пользователя для назначения на себя. - Значения статуса: resolved, resolvedInNextRelease, unresolved, ignored. - status='ignored' по умолчанию использует ignoreMode='untilEscalating'. - Режимы игнорирования: untilEscalating, forever, forDuration, untilOccurrenceCount, untilUserCount. - Соответствующие входные параметры игнорирования: ignoreDurationMinutes, ignoreCount + необязательный ignoreWindowMinutes, или ignoreUserCount + необязательный ignoreUserWindowMinutes. - Чтобы переключить уже игнорируемую проблему между untilEscalating, forever и условными режимами игнорирования, сначала установите status='unresolved', затем снова проигнорируйте её с новым правилом. - reason необязателен. Если он указан, он будет опубликован как комментарий в ленте активности проблемы с объяснением, почему было выполнено действие. </hints>