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 с помощью ИИ-ассистентов

MCP API Status Docs

Удалённый сервер Model Context Protocol (MCP), который подключает ИИ-ассистентов к Raygun Crash Reporting, Real User Monitoring и Application Performance Monitoring.

📘 Руководство по настройке📚 Справочник инструментов🚀 Быстрый старт


✨ Ключевые возможности

  • 🐛 Управление ошибками — расследуйте, устраняйте и отслеживайте ошибки приложений и сбои с полными стек-трейсами и контекстом
  • 🚀 Отслеживание развёртываний — контролируйте релизы и сопоставляйте ошибки с развёртываниями, чтобы выявлять проблемные изменения
  • Анализ производительности — анализируйте время загрузки страниц, пользовательские метрики и тренды производительности с течением времени
  • 🔬 Расследование APM — находите серверные узкие места, повторяющиеся проблемы производительности и медленные трассировки
  • 👥 Мониторинг пользователей — отслеживайте сеансы клиентов, паттерны поведения и выявляйте затронутых пользователей
  • 🤝 Командное взаимодействие — управляйте приглашениями и координируйте устранение ошибок в вашей команде
  • 📊 Метрики и аналитика — анализ временных рядов и гистограммы распределения для ошибок и производительности

📋 Требования

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

Сервер Raygun MCP размещён по адресу:

https://api.raygun.com/v3/mcp

Raygun размещает и обновляет сервис, поэтому устанавливать пакет или локальный сервер не требуется.

Install in Cursor Install in VS Code

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 — список всех приложений в вашей учётной записи Raygun
  • applications_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 не подходит:

  1. Перейдите к Личным токенам доступа Raygun
  2. Нажмите Создать новый токен
  3. Дайте токену описательное имя (например, «Доступ к MCP-серверу»)
  4. Выберите соответствующие разрешения для вашего случая использования
  5. Скопируйте сгенерированный токен и отправьте его как Authorization: Bearer YOUR_PAT_TOKEN

Храните PAT в безопасности и никогда не фиксируйте их в системе контроля версий.

Подробнее см. в документации API Raygun.


📖 О проекте

Сервер Raygun MCP позволяет ИИ-ассистентам расследовать данные Crash Reporting, RUM и APM; отслеживать развёртывания; анализировать производительность и управлять мониторингом приложений через разговоры на естественном языке.

🔗 Ресурсы


Создано с ❤️ компанией Raygun

Raygun