Raygun
официальныйВзаимодействуйте с данными отчётов о сбоях и мониторинга реального времени в вашей учётной записи Raygun
Что можно делать с Raygun MCP?
- Исследование групп ошибок — Запросите поиск и анализ групп ошибок с помощью
error_groups_searchиerror_group_investigate, чтобы получить стек-трейсы и контекст. - Отслеживание развертываний — Используйте
deployment_get_latestилиdeployment_investigate, чтобы сопоставить новые ошибки с последними релизами. - Анализ производительности — Запросите
metrics_website_performance_analyzeилиapm_hotspots_search, чтобы найти медленные методы, запросы к базе данных или регрессии времени загрузки страниц. - Изучение сессий клиентов — Найдите активность пользователей с помощью
customers_searchиsession_investigate, чтобы увидеть, где произошли сбои в работе. - Управление статусами ошибок — Обновляйте состояния решения или добавляйте комментарии через
error_group_update_statusиerror_group_add_comment. - Просмотр приглашений команды — Список, отправка или отзыв приглашений с помощью
invitations_manage,invitation_sendиinvitation_revoke.
Документация
🔭 Raygun MCP Server
Исследуйте ошибки и производительность в Raygun с помощью ИИ-ассистентов
Удалённый сервер Model Context Protocol (MCP), который подключает ИИ-ассистентов к Raygun Crash Reporting, Real User Monitoring и Application Performance Monitoring.
📘 Руководство по настройке • 📚 Справочник инструментов • 🚀 Быстрый старт
✨ Ключевые возможности
- 🐛 Управление ошибками — расследуйте, устраняйте и отслеживайте ошибки приложений и сбои с полными стек-трейсами и контекстом
- 🚀 Отслеживание развёртываний — контролируйте релизы и сопоставляйте ошибки с развёртываниями, чтобы выявлять проблемные изменения
- ⚡ Анализ производительности — анализируйте время загрузки страниц, пользовательские метрики и тренды производительности с течением времени
- 🔬 Расследование APM — находите серверные узкие места, повторяющиеся проблемы производительности и медленные трассировки
- 👥 Мониторинг пользователей — отслеживайте сеансы клиентов, паттерны поведения и выявляйте затронутых пользователей
- 🤝 Командное взаимодействие — управляйте приглашениями и координируйте устранение ошибок в вашей команде
- 📊 Метрики и аналитика — анализ временных рядов и гистограммы распределения для ошибок и производительности
📋 Требования
- Учётная запись Raygun с активной подпиской
- MCP-клиент с поддержкой OAuth или личный токен доступа Raygun
🚀 Начало работы
Сервер Raygun MCP размещён по адресу:
https://api.raygun.com/v3/mcp
Raygun размещает и обновляет сервис, поэтому устанавливать пакет или локальный сервер не требуется.
OAuth (рекомендуется)
Добавьте URL как Streamable HTTP сервер без заголовка Authorization. При первом подключении ваш MCP-клиент откроет Raygun в браузере, чтобы вы могли войти, выбрать план, просмотреть запрашиваемые разрешения и авторизовать доступ.
Вам не нужно указывать OAuth client ID или client secret. Raygun поддерживает автоматическую регистрацию клиентов.
Codex и настольное приложение ChatGPT
codex mcp add raygun --url https://api.raygun.com/v3/mcp
codex mcp login raygun
Эта конфигурация используется совместно Codex CLI, расширением Codex IDE и настольным приложением ChatGPT на одном хосте Codex.
В настольном приложении ChatGPT откройте Настройки > MCP-серверы, выберите Добавить сервер, выберите Streamable HTTP и введите конечную точку Raygun. Сохраните и перезапустите приложение, затем выберите Аутентификация для Raygun.
ChatGPT в вебе использует удалённые MCP-инструменты через плагины и не читает вашу локальную конфигурацию MCP Codex. Отдельно опубликованный плагин Raygun устанавливался бы из каталога плагинов.
Claude Code
claude mcp add --transport http raygun https://api.raygun.com/v3/mcp
Запустите /mcp в Claude Code и следуйте процессу аутентификации в браузере.
Cursor
{
"mcpServers": {
"raygun": {
"url": "https://api.raygun.com/v3/mcp"
}
}
}
Cursor предложит вам пройти аутентификацию при подключении.
VS Code
{
"servers": {
"raygun": {
"type": "http",
"url": "https://api.raygun.com/v3/mcp"
}
}
}
VS Code предложит вам пройти аутентификацию при подключении.
Личный токен доступа
Аутентификация через PAT по-прежнему поддерживается для клиентов без поддержки MCP OAuth и для автоматизации. В следующем примере используется формат конфигурации Cursor; другие клиенты используют тот же заголовок Authorization в своей конфигурации HTTP-сервера:
{
"mcpServers": {
"raygun": {
"url": "https://api.raygun.com/v3/mcp",
"headers": {
"Authorization": "Bearer YOUR_PAT_TOKEN"
}
}
}
}
💬 Ваш первый запрос
После настройки попробуйте спросить вашего ИИ-ассистента:
- «Найди ошибки, которые впервые появились после последнего развёртывания моего приложения для оформления заказов».
- «Расследуй наиболее часто возникающую производственную ошибку и покажи репрезентативный стек-трейс».
- «Какие серверные методы или запросы к базе данных заняли больше всего времени за последние 24 часа?»
- «Покажи последний сеанс для клиента
user@example.comи объясни, где их опыт потерпел неудачу». - «Сравни производительность страниц по p95 за последние семь дней и определи наибольшую регрессию».
🛠️ Инструменты
Сервер Raygun MCP предоставляет следующие категории инструментов:
📱 Приложения
applications_list— список всех приложений в вашей учётной записи Raygunapplications_search— поиск приложений по имениapplication_get_details— получение подробной информации о приложенииapplication_regenerate_api_key— генерация нового ключа API для приложения
🐛 Управление ошибками
error_groups_list— список групп ошибок в приложенииerror_groups_search— поиск вхождений по ошибке, стек-трейсу, URL, версии, пользователю, тегам или пользовательским даннымerror_group_investigate— получение полных сведений о конкретной группе ошибокerror_group_update_status— изменение статуса группы ошибок (решена, игнорируется, активна)error_group_add_comment— добавление заметок к расследованию в группу ошибокerror_group_read_comments— просмотр существующих заметок к расследованиюerror_group_instances_list— список вхождений в группе ошибокerror_instance_get— получение полного стек-трейса и контекста для вхождения
🚀 Развёртывания
deployments_list— список развёртываний для приложенияdeployment_create— создание новой записи о развёртыванииdeployment_get_latest— получение последнего развёртывания с анализом ошибокdeployment_investigate— получение исчерпывающей информации о развёртыванииdeployment_manage— обновление или удаление развёртывания
👥 Клиенты и сеансы
customers_search— поиск клиентов по имени, электронной почте или идентификаторуcustomer_investigate— получение профиля клиента, недавних групп ошибок и сеансовsessions_list— список пользовательских сеансов с данными об окружении и устройствеsession_investigate— проверка окружения, ошибок и просмотров страниц сеанса
🔬 Мониторинг производительности приложений
apm_issues_search— поиск повторяющихся серверных проблем производительности и анти-паттерновapm_issue_investigate— проверка метрик проблемы и затронутых трассировокapm_traces_search— поиск медленных или неудачных серверных запросовapm_trace_investigate— проверка потоков профилировщика и значимых вызовов в трассировкеapm_hotspots_search— ранжирование медленных методов, запросов к базе данных и внешних вызовов
📊 Производительность и метрики
pages_list— список отслеживаемых страниц в приложенииpage_investigate— получение сведений о странице для запросов метрикmetrics_website_performance_analyze— отслеживание трендов производительности с течением времениmetrics_performance_distribution_analyze— понимание изменчивости производительностиmetrics_error_trends_analyze— отслеживание частоты ошибок и паттернов
🤝 Управление командой
invitations_manage— список и просмотр приглашений в командуinvitation_send— отправка нового приглашения в командуinvitation_revoke— отмена ожидающего приглашения
Подробную документацию по каждому инструменту см. в Справочнике инструментов.
🔐 Аутентификация
OAuth
Raygun реализует поток авторизации MCP для HTTP-клиентов. Сервер объявляет свой сервер авторизации через метаданные защищённого ресурса OAuth, а совместимые клиенты автоматически регистрируются с помощью документов метаданных Client ID или динамической регистрации клиентов.
Доступ привязан к пользователю Raygun, плану и областям, одобренным на экране согласия. Совместимые клиенты безопасно хранят и обновляют свои собственные токены.
Каждое OAuth-подключение предоставляет доступ к одному плану Raygun. Добавьте ещё одну конфигурацию Raygun MCP и авторизуйте её отдельно, если вам нужно работать с другим планом.
Безопасность и доступ
- OAuth никогда не предоставляет клиенту больше доступа, чем уже есть у вошедшего пользователя Raygun.
- Доступ на чтение и запись контролируется областями, одобренными во время OAuth или назначенными PAT.
- Некоторые инструменты могут изменять данные Raygun, включая статусы ошибок, развёртывания, приглашения, комментарии и ключи API приёма данных. Проверяйте действия на запись перед их одобрением в вашем MCP-клиенте.
- Инструменты приложений могут возвращать или ротировать ключи API приёма данных. Относитесь к возвращённым ключам как к учётным данным; ротация ключа немедленно аннулирует предыдущий.
- Результаты инструментов могут включаться в разговоры, обрабатываемые выбранным вами ИИ-клиентом или поставщиком моделей. Следуйте политикам вашей организации в отношении обмена диагностическими и клиентскими данными.
Получение личного токена доступа
PAT остаются доступными, когда OAuth не подходит:
- Перейдите к Личным токенам доступа Raygun
- Нажмите Создать новый токен
- Дайте токену описательное имя (например, «Доступ к MCP-серверу»)
- Выберите соответствующие разрешения для вашего случая использования
- Скопируйте сгенерированный токен и отправьте его как
Authorization: Bearer YOUR_PAT_TOKEN
Храните PAT в безопасности и никогда не фиксируйте их в системе контроля версий.
Подробнее см. в документации API Raygun.
📖 О проекте
Сервер Raygun MCP позволяет ИИ-ассистентам расследовать данные Crash Reporting, RUM и APM; отслеживать развёртывания; анализировать производительность и управлять мониторингом приложений через разговоры на естественном языке.
🔗 Ресурсы
- 📚 Документация Raygun
- 📘 Руководство по настройке Raygun MCP
- 🔌 Справочник API Raygun
- 🤖 Model Context Protocol
- 🐛 Сообщить о проблеме
Создано с ❤️ компанией Raygun