🔭 Сервер Raygun MCP

Исследуйте ошибки и производительность в Raygun с помощью AI-ассистентов

Удалённый сервер Model Context Protocol (MCP), который подключает AI-ассистентов к 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 откройте Settings > MCP servers, выберите Add server, укажите Streamable HTTP и введите адрес Raygun. Сохраните настройки и перезапустите приложение, затем выберите Authenticate для Raygun.

Веб-версия ChatGPT использует удалённые инструменты MCP через Plugins и не читает локальную конфигурацию Codex MCP. Отдельно опубликованный плагин Raygun можно будет установить из каталога Plugins.

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"
      }
    }
  }
}

💬 Первый запрос

После настройки попробуйте задать AI-ассистенту один из следующих вопросов:

«Найди ошибки, которые впервые появились после последнего развёртывания моего приложения для оформления заказов».
«Исследуй наиболее часто возникающую ошибку в рабочей среде и покажи пример трассировки стека».
«Какие методы серверной части или запросы к базе данных занимали больше всего времени за последние 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 Protected Resource Metadata, а совместимые клиенты регистрируются автоматически с помощью Client ID Metadata Documents или Dynamic Client Registration.

Доступ связан с пользователем Raygun, его планом и разрешениями, одобренными на экране согласия. Совместимые клиенты безопасно хранят и обновляют собственные токены.

Каждое OAuth-подключение предоставляет доступ к одному плану Raygun. Чтобы работать с другим планом, добавьте ещё одну конфигурацию Raygun MCP и отдельно авторизуйте её.

Безопасность и доступ

OAuth не предоставляет клиенту больше прав, чем уже есть у вошедшего в систему пользователя Raygun.
Доступ на чтение и запись определяется разрешениями, одобренными при OAuth-аутентификации или заданными для PAT.
Некоторые инструменты могут изменять данные Raygun, в том числе статусы ошибок, развёртывания, приглашения, комментарии и ключи API для приёма данных. Перед подтверждением таких действий проверьте их в MCP-клиенте.
Инструменты для работы с приложениями могут возвращать ключи API для приёма данных или заменять их. Считайте возвращённые ключи учётными данными: после замены ключа предыдущий сразу становится недействительным.
Результаты работы инструментов могут включаться в диалоги, обрабатываемые выбранным AI-клиентом или поставщиком модели. При передаче диагностических данных и данных о клиентах соблюдайте правила вашей организации.

Получение Personal Access Token

PAT доступны, если OAuth не подходит:

Перейдите на страницу Personal Access Tokens в Raygun
Нажмите Create New Token
Присвойте токену понятное название, например «Доступ к MCP-серверу»
Выберите разрешения, необходимые для вашего сценария использования
Скопируйте созданный токен и передавайте его в заголовке Authorization: Bearer YOUR_PAT_TOKEN

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

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

📖 О проекте

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

🔗 Ресурсы

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