Rius

Rius MCP 服务

Rius 是由 GlassFlow 打造的 AI Agent 可观测性平台。Rius MCP 服务可让你的编码助手通过自然语言，在 VS Code（GitHub Copilot）、Claude Code、Cursor、Codex 或任何其他 MCP 客户端中查询 Agent 的跟踪记录、错误、成本和告警。

此仓库包含托管服务的公开 README，以及其 server.json 的参考副本。实时注册表条目由服务的发布流水线发布，因此其 version 可能比此处的副本更新。服务本身以托管服务的形式运行，无需安装或自行托管。

• 端点： https://mcp.eu.console.rius-glassflow.com/mcp
• 传输方式： Streamable HTTP
• 身份验证： 在浏览器中通过 OAuth 2.1 登录，或在无头环境中使用 Rius API 密钥
• MCP 注册表名称： ai.glassflow/rius
• 文档： https://docs.glassflow.ai/rius/mcp

可以询问什么

连接后，可在聊天中询问有关 Agent 的问题：

• “过去 24 小时内，我的哪些 Agent 出错最多？主要错误分组有哪些？”
• “显示 support-agent 今天运行失败的记录，并带我逐步了解最严重的一次。”
• “比较 support-agent 的 1.4.0 和 1.5.0 版本的成本与延迟。”
• “本周哪些最终用户的成本最高？”
• “列出未解决的告警，并说明每个告警的触发原因。”
• “创建一个告警，在 checkout-agent 的错误率超过 5% 时触发。”

前提条件

需要一个包含 Agent 跟踪记录的 Rius 工作区。注册，并按照快速入门使用 Rius SDK 或任意 OpenTelemetry 导出器发送首批跟踪记录。

连接

以下所有客户端都使用服务名称 rius。首次使用时，客户端会通过浏览器引导你登录 Rius（某些客户端需要执行命令来启动；请参阅各客户端的说明）。服务支持动态客户端注册和客户端 ID 元数据文档，因此无需配置客户端 ID。

VS Code（GitHub Copilot）

将服务添加到工作区中的 .vscode/mcp.json（或用户级 mcp.json）。注意，顶层键为 servers：

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

在 mcp.json 中对应条目上方的 Start 操作启动服务（或运行 MCP: List Servers），并允许登录提示。然后打开 Copilot Chat，切换到 Agent 模式并选择 rius 工具。

Claude Code

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

在 Claude Code 中运行 /mcp 登录。

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 任务、脚本或远程 Agent，可发送 Rius API 密钥作为 bearer token，而不是登录。请在控制台的 MCP 页面（“Connect an agent”）或“Create API key”对话框中创建具有 Query data 权限的密钥。

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 中，在 ~/.codex/config.toml 的服务条目中设置 bearer_token_env_var = "RIUS_API_KEY"。

工具

主要工具如下。包含参数的完整最新参考文档请见 https://docs.glassflow.ai/rius/mcp/tools。

区域	工具
工作区和身份	get_me, list_workspaces, list_users, user_activity_summary
Agent	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 始终不可用。

链接

• Rius：https://www.glassflow.ai/rius
• 控制台：https://console.rius-glassflow.com
• MCP 服务文档：https://docs.glassflow.ai/rius/mcp
• Claude Code 插件（将你自己的 Claude Code 会话跟踪到 Rius）：https://github.com/glassflow/rius-coding-agents

许可证

本仓库的内容依据 MIT 许可证 发布。Rius 服务受其自身条款约束。