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. Отдельные события с метками времени: 'журналы ошибок за последний час' Наборы данных: - errors: События-исключения/падения с трассировками стека, обычно группируются в проблемы - logs: Записи журнала приложения, включая сообщения журнала с уровнем ошибки - spans: Сырые события трассировки/спанов для производительности, AI/LLM-вызовов, запросов и операций - metrics: Строки метрик и агрегаты: счётчики, датчики, распределения, значения - profiles: Результаты профилирования транзакций/непрерывного профилирования, ID профилей, профилированные транзакции - replays: Результаты повторных сессий: злые клики, мёртвые клики, посещённые страницы, пользователи повторных сессий Если пользователь говорит 'logs', 'log messages', 'error logs' или 'warning logs', выбирайте logs вместо errors. Поиск повторных сессий возвращает только списки повторных сессий; replay 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', query='level:error') search_events(organizationSlug='my-org', dataset='errors', fields=['issue', 'count()'], sort='-count()') 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>. - Разбирайте нотацию org/project напрямую, без вызова find_organizations или find_projects. - Используйте поля с агрегатными функциями, такими как count(), avg(), sum() для статистики - Сортируйте по -count() для наиболее… </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', 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: user:ID или team:ID_OR_SLUG. - Используйте execute_sentry_tool(name='whoami', arguments={}), чтобы узнать свой ID пользователя для самоназначения. - Значения статуса: resolved, resolvedInNextRelease, unresolved, ignored. - status='ignored' по умолчанию устанавливает ignoreMode='untilEscalating'. - Режимы игнорирования: untilEscalating, forever, forDuration, untilOccurrenceCount, untilUserCount. - Соответствующие параметры игнорирования: ignoreDurationMinutes, ignoreCount + опционально ignoreWindowMinutes или ignoreUserCount + опционально ignoreUserWindowMinutes. - Чтобы переключить уже проигнорированную проблему между режимами untilEscalating, forever и условным игнорированием, сначала установите status='unresolved', затем снова игнорируйте её с новым правилом. - reason — необязателен. Если указан, он будет опубликован как комментарий в ленте активности проблемы с пояснением причины действия. </hints>