API ВЕГА
English

Сервер MCP Rius

Rius — платформа наблюдаемости за AI-агентами, созданная GlassFlow. Сервер MCP Rius позволяет задавать вопросы на обычном языке о трассировках, ошибках, расходах и оповещениях ваших агентов через помощника для программирования в VS Code (GitHub Copilot), Claude Code, Cursor, Codex и любом другом клиенте MCP.

В этом репозитории находятся общедоступный README для размещённого сервера и справочная копия файла server.json. Актуальная запись в реестре публикуется в рамках конвейера выпуска сервера, поэтому её version может быть новее, чем в копии здесь. Сам сервер работает как управляемый сервис: устанавливать его или размещать самостоятельно не нужно.

  • Конечная точка: https://mcp.eu.console.rius-glassflow.com/mcp

  • Транспорт: Streamable HTTP

  • Аутентификация: вход через браузер с помощью OAuth 2.1 или ключ API Rius для работы без браузера

  • Имя в реестре MCP: ai.glassflow/rius

  • Документация: https://docs.glassflow.ai/rius/mcp

О чём можно спрашивать

После подключения задавайте вопросы об агентах прямо в чате:

  • «У каких моих агентов было больше всего ошибок за последние 24 часа и какие группы ошибок встречались чаще всего?»

  • «Покажи сегодняшние неудачные запуски support-agent и подробно разбери самый проблемный».

  • «Сравни стоимость и задержку версий 1.4.0 и 1.5.0 агента support-agent».

  • «Какие конечные пользователи обходятся дороже всего на этой неделе?»

  • «Перечисли открытые оповещения и объясни, что вызвало каждое из них».

  • «Создай оповещение, которое срабатывает, если доля ошибок checkout-agent превышает 5%».

Требования

Рабочая область Rius с трассировками агентов. Зарегистрируйтесь и выполните инструкции из краткого руководства, чтобы отправить первые трассировки с помощью Rius SDK или любого экспортёра OpenTelemetry.

Подключение

Во всех приведённых ниже клиентах используется имя сервера rius. При первом подключении клиент выполнит вход в Rius через браузер; некоторым клиентам для этого требуется команда — подробности приведены в инструкциях для каждого клиента. Сервер поддерживает динамическую регистрацию клиентов и документы с метаданными client ID, поэтому настраивать client ID не нужно.

VS Code (GitHub Copilot)

Добавьте сервер в файл .vscode/mcp.json рабочей области или в пользовательский mcp.json. Обратите внимание: ключ верхнего уровня — servers.

{
  "servers": {
    "rius": {
      "type": "http",
      "url": "https://mcp.eu.console.rius-glassflow.com/mcp"
    }
  }
}

Запустите сервер с помощью действия Start над его записью в mcp.json или выполните команду MCP: List Servers, затем подтвердите вход. После этого откройте Copilot Chat, переключитесь в режим Agent и выберите инструменты rius.

Claude Code

claude mcp add --transport http rius https://mcp.eu.console.rius-glassflow.com/mcp

Чтобы выполнить вход, запустите /mcp в Claude Code.

Cursor

Добавьте конфигурацию в ~/.cursor/mcp.json или в файл .cursor/mcp.json проекта:

{
  "mcpServers": {
    "rius": {
      "url": "https://mcp.eu.console.rius-glassflow.com/mcp"
    }
  }
}

Затем подтвердите подключение сервера в разделе Settings → MCP.

Codex

codex mcp add rius --url https://mcp.eu.console.rius-glassflow.com/mcp

Другие клиенты

Большинство клиентов принимают JSON-блок такого вида:

{
  "mcpServers": {
    "rius": {
      "type": "http",
      "url": "https://mcp.eu.console.rius-glassflow.com/mcp"
    }
  }
}

Клиенты, поддерживающие только stdio, можно подключить через mcp-remote:

npx mcp-remote https://mcp.eu.console.rius-glassflow.com/mcp

Инструкции для отдельных клиентов (Claude Desktop, Windsurf, Cline, Zed, Gemini CLI, opencode) приведены в документации сервера MCP.

Работа без браузера с ключом API

Для заданий CI, скриптов и удалённых агентов, которые не могут открыть браузер, вместо входа передавайте ключ API Rius как bearer-токен. Создайте ключ с разрешением Query data на странице MCP в консоли («Connect an agent») или в диалоговом окне Create API key.

export RIUS_API_KEY=...
claude mcp add --transport http rius https://mcp.eu.console.rius-glassflow.com/mcp \
  --header "Authorization: Bearer ${RIUS_API_KEY}"

В VS Code один раз введите ключ по запросу — он будет сохранён в защищённом виде:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "rius-key",
      "description": "Rius API key",
      "password": true
    }
  ],
  "servers": {
    "rius": {
      "type": "http",
      "url": "https://mcp.eu.console.rius-glassflow.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:rius-key}"
      }
    }
  }
}

В других JSON-конфигурациях добавьте блок headers. Не все клиенты подставляют значения переменных окружения, поэтому используйте синтаксис переменных, поддерживаемый вашим клиентом, или вставьте ключ напрямую:

{
  "mcpServers": {
    "rius": {
      "type": "http",
      "url": "https://mcp.eu.console.rius-glassflow.com/mcp",
      "headers": {
        "Authorization": "Bearer ${RIUS_API_KEY}"
      }
    }
  }
}

В Codex добавьте bearer_token_env_var = "RIUS_API_KEY" в запись сервера в ~/.codex/config.toml.

Инструменты

Основные инструменты перечислены ниже. Полный актуальный справочник с параметрами доступен по ссылке https://docs.glassflow.ai/rius/mcp/tools.

ОбластьИнструменты
Рабочая область и учётные записиget_me, list_workspaces, list_users, user_activity_summary
Агентыlist_agents, agent_versions, compare_agent_versions, agent_lifecycle_events
Трассировки и спаныagent_traces_summary, list_agent_traces, get_agent_trace, list_spans, describe_search_catalog
Ошибки и метрикиagent_error_groups, workspace_metrics_overview, list_metrics_catalog
Оповещения (чтение)list_alerts, get_alert, list_alert_rules, list_alert_channels, describe_alert_catalog
Оповещения (изменение)create_alert_rule, update_alert_rule, delete_alert_rule, create_alert_channel, update_alert_channel, delete_alert_channel, ack_alert
Ключи (изменение)create_api_key

Инструменты, помеченные как инструменты изменения данных, вносят изменения. Если вызов недоступен, сервер сообщит помощнику причину, а не завершит работу без объяснения:

  • Выполнен вход: инструменты чтения и ack_alert доступны всем участникам. Для работы с инструментами правил и каналов оповещений, а также с list_alert_channels и create_api_key, нужны права администратора организации.

  • При использовании ключа API: ключ доступен только для чтения, если при его создании не были указаны разрешения alerts:manage (для инструментов управления правилами оповещений) или channels:manage (для инструментов управления каналами оповещений, включая list_alert_channels). ack_alert и create_api_key нельзя использовать с ключом.

Ссылки

Лицензия

Содержимое этого репозитория распространяется по условиям лицензии MIT. На сервис Rius распространяются собственные условия использования.