Как подключить Rollbar к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Rollbar, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Rollbar + Gemini

Мониторинг ошибок Rollbar в любом AI-агенте: items с историей и occurrences, полные стек-трейсы, самые активные items и отчёты по occurrences, Metrics API, деплои, окружения и версии кода, запросы RQL, а также проекты, пользователи и команды аккаунта. Он также закрывает, заглушает, назначает и откладывает items, комментирует их и регистрирует деплои.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

ROLLBAR_ACCESS_TOKEN

Шаг 1 — Получите учётные данные

Настройка занимает около 3 минут. Нужен аккаунт Rollbar и один access token. От типа токена зависит, к чему получит доступ коннектор:

1. Один проект: в проекте откройте Settings, Project Access Tokens и создайте или скопируйте project access token. Дайте ему scope read для чтения, write для изменения items и post_server_item для регистрации деплоев. Токен проекта всегда работает со своим проектом, но не может выводить списки проектов, пользователей и команд.
2. Весь аккаунт: вместо этого создайте account access token. Service token (Settings аккаунта, API Access Tokens, вкладка Service) открывает все проекты; personal access token (User Settings, Personal access tokens) может только то, что может его пользователь. Их scopes: read и write. С токеном аккаунта AI передаёт project_id (из rollbar_list_projects) в инструменты проекта, а rollbar_list_items ищет во всех проектах, которые токен может читать, если вы не укажете project_ids.
3. Вставьте токен в ROLLBAR_ACCESS_TOKEN. Он отправляется в заголовке X-Rollbar-Access-Token на https://api.rollbar.com/api/1.
4. Установите коннектор и запустите rollbar_list_items, чтобы проверить токен.

Комментировать items может только personal access token, а регистрировать деплои только токен проекта с post_server_item.

Что сломано прямо сейчас: rollbar_get_top_active_items показывает items с наибольшим числом occurrences за последние часы (от 1 до 168, по умолчанию 24) с почасовыми счётчиками, как Top 10 на дашборде проекта. rollbar_list_items выводит и ищет items (сгруппированные ошибки и сообщения) по статусу, уровню, окружению, фреймворку, ответственному, состоянию откладывания или по тому же тексту поиска, что и страница Items. rollbar_get_item читает один item. Число в URL Rollbar (#123) это counter проекта, а не id item: rollbar_get_item_by_counter находит item по counter или по UUID одного из его occurrences.

Расследование: rollbar_list_item_occurrences выводит отдельные события одного item, а rollbar_list_occurrences последние события всего проекта, каждое со временем, версией кода и payload. rollbar_get_occurrence возвращает полный payload, как в представлении Raw JSON: класс и сообщение исключения, фреймы стек-трейса, запрос, person, сервер, клиент, пользовательские данные и телеметрию. rollbar_list_item_events показывает, кто комментировал, менял, назначал, откладывал или объединял item.

Разбор: rollbar_update_item закрывает item (при желании с resolved_in_version, например git SHA), заглушает или снова активирует его, меняет уровень или заголовок, назначает пользователю или команде (id из rollbar_list_users и rollbar_list_teams) или откладывает на заданное число секунд (откладывание доступно на платных тарифах). rollbar_add_item_comment добавляет комментарий в Markdown в ленту item. Для этого нужен scope write.

Тренды и метрики: rollbar_get_occurrence_counts даёт число occurrences по минутам, часам или дням, rollbar_get_activated_item_counts новые и повторно активированные items по дням, а rollbar_get_item_metrics число occurrences с первым и последним occurrence для списка items. На тарифе Advanced rollbar_query_occurrence_metrics обращается к Metrics API с фильтрами, группировкой и агрегатами (например, occurrences по окружениям и дням или самые частые браузеры одного item), а rollbar_get_resolution_time_metrics даёт время до закрытия items (медиана, среднее, минимум или максимум) по периодам.

Релизы: rollbar_list_deploys, rollbar_get_deploy и rollbar_list_environments читают деплои и окружения. rollbar_report_deploy регистрирует деплой ревизии в окружение, а rollbar_update_deploy завершает деплой, зарегистрированный как начатый (succeeded, failed или timed_out). Чтобы понять, что сломал релиз, rollbar_get_version считает новые, повторно активированные, повторяющиеся и закрытые items одной версии кода в одном окружении, а rollbar_list_version_items с event: new выводит items, впервые появившиеся в этой версии.

RQL: для разового анализа AI запускает запрос на SQL-подобном языке Rollbar через rollbar_create_rql_job (таблицы item_occurrence и deploy), опрашивает rollbar_get_rql_job, пока status не станет success, и читает строки через rollbar_get_rql_job_result. rollbar_list_rql_jobs и rollbar_cancel_rql_job управляют прошлыми и запущенными задачами. RQL не меняет данные.

Аккаунт: с токеном аккаунта rollbar_list_projects, rollbar_get_project, rollbar_list_users, rollbar_get_user и rollbar_list_teams.

Отключено при установке: rollbar_request_person_deletion, который стирает отслеживаемого person (конечного пользователя, привязанного к occurrences) из всех проектов аккаунта, например по запросу по GDPR. Отменить это нельзя, поэтому администратор workspace включает инструмент, когда он нужен; затем rollbar_get_person_deletion_status отслеживает задачу.

Форматы данных: каждый ответ имеет вид {"err": 0, "result": ...}; err: 1 приходит вместе с message. rollbar_report_deploy отвечает {"data": {"deploy_id": ...}}. Все временные метки это Unix-секунды в GMT, а графики отчётов это пары [timestamp, count]. status item: active, resolved, muted или archived; level: debug, info, warning, error или critical. Списки occurrences не содержат заголовков запроса, cookies и данных notifier; полный payload из rollbar_get_occurrence может содержать персональные данные ваших конечных пользователей.

Постраничный вывод: items приходят по 100 на страницу; occurrences, деплои, окружения и события items по умолчанию по 20, с limit до 5000, где он есть. Передавайте page начиная с 1; списки occurrences листаются и через last_id. В проектах, где больше 100 000 items, total_count равен null.

Ограничения: у каждого токена свой лимит запросов в Rollbar; остаток показывает X-Rate-Limit-Remaining. Инструментам Metrics API нужен тариф Advanced.

Частые ошибки: 401 означает отсутствующий или неверно сформированный токен. 403 означает, что токен отключён, у него нет нужного scope, это токен проекта в инструменте аккаунта или (Requires project access) токен аккаунта без подходящего project_id. 404 это неизвестный id или id другого аккаунта, 422 недопустимые параметры, 429 лимит запросов токена.

Коннектор не отправляет ошибки в Rollbar (это делает Rollbar SDK в вашем приложении), не удаляет items и не создаёт проекты, команды, пользователей или access tokens.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Rollbar.

Доступные инструменты

Примеры запросов

• «Какие ошибки чаще всего возникали в production за последние 24 часа и какие из них новые?»
• «Покажи полный стек-трейс последнего occurrence item #482 в Rollbar.»
• «Какие items впервые появились в версии 3f9c2ab в production? Сгруппируй их по уровню.»
• «Закрой item TimeoutError как исправленный в версии 1.8.3 и назначь NullPointerException команде бэкенда.»
• «Сколько occurrences уровня error и critical было по дням на этой неделе по сравнению с прошлой?»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse
• Подключить к Microsoft Copilot