控制台 · MCP 连接
把平台的 330+ 工具目录安全地接给外部 AI Agent，连接侧的管理都在设置 → MCP 集成 下：服务、客户端、连接、工具四个子页；调用审计则在设置 → 审计 → MCP 审计（与身份审计同组）。协议与安全模型（OAuth 2.1 + PKCE、三层工具可见性、HIGH 风险两阶段确认）见 AI Agent / MCP——这里只讲界面怎么转。
你在这里：要让 Claude Desktop / VS Code / Cursor 或自研 Agent 通过 MCP 调平台工具。协议细节与 curl 流程看 MCP 页；此处讲控制台上要配什么。
四个子页各管什么
| 子页 | 管什么 | 典型动作 |
|---|---|---|
| MCP 服务 | 平台对外的 /mcp 端点形态（网关上的 MCP Resource Server） | 查看服务状态 |
| MCP 连接 | 一条已建立的 Agent 连接：绑定了哪个客户端、开了什么工具白名单 | 新建连接、管理工具、查看权限范围 |
| MCP 客户端 | 已注册的 OAuth 客户端（/oauth2/register 动态注册的落库处） | 注册客户端、查看 clientId/secret |
| MCP 工具 | 工具目录（330+ 工具的清单、风险级别与来源） | 浏览工具目录、刷新工具目录 |
工具目录刷新是管理员手动动作（经网关为 POST /api/v3/auth/mcp/tool/catalog/refresh，刷新按钮就在 MCP 工具子页）：新增了 HTTP 接口后目录不会自动更新——在这页点一次刷新（或用 curl 触发），新工具才会出现在 tools/list。注意网关根路径只有 JSON-RPC 的 POST /mcp，没有 /mcp/** 转发路由，curl 一定要走 /api/v3/auth/mcp/... 前缀。
建一条 Agent 连接的全流程
- 注册客户端：MCP 客户端页新增（或 Agent 走
/oauth2/register自助注册——该端点是公开的，可匿名注册；携带登录态X-Auth-Principal头时注册结果归属该主体，未携带则为全局无主，生产环境应关注匿名注册面）； - 拿令牌：客户端用 OAuth 2.1 + PKCE（S256 强制）换 15 分钟短时 JWT（刷新令牌 30 天，支持轮换）；
- 建连接：MCP 连接页新建，选择客户端、配置工具白名单；
- Agent 调用：
tools/list返回的 = 主体 RBAC 权限 ∩ 连接白名单 ∩ 风险策略（HIGH 默认隐藏，需显式开启）——三层交集决定 Agent 看得见什么； - HIGH 风险操作：调用先返回
CONFIRM_REQUIRED+confirmId，二次确认（5 分钟内、参数摘要一致、单次消费）才真正执行。
调用审计
设置 → 审计 → MCP 审计页（dc3_mcp_audit_log）记录每一次工具调用：谁（principal/连接）、调了什么（tool_id）、风险级别、耗时、来源 IP；HIGH 风险调用连同确认票据信息一并落审计。"Agent 到底干了什么"在这里回溯。
界面动作与 API 的对应
| 界面动作 | API（经网关） | 语义 |
|---|---|---|
| 注册客户端 | POST …/oauth2/register | 公开端点，可匿名；带 X-Auth-Principal 时归属该主体 |
| 刷新工具目录 | POST …/auth/mcp/tool/catalog/refresh（完整路径 /api/v3/auth/mcp/tool/catalog/refresh） | 管理员手动，新增接口后必跑；按钮在 MCP 工具子页 |
| 连接管理 / 工具白名单 | MCP 连接 CRUD | 决定三层过滤的中间层 |
| 审计查询 | tools/call 逐次落 dc3_mcp_audit_log | 全量留痕 |
延伸阅读
- AI Agent / MCP — 协议、OAuth 流程、风险分级的完整参考
- Agentic 中心 — 平台内置的对话式 AI（与 MCP 互补的另一种接入）
- 鉴权 · 租户 · RBAC — 三层过滤里 RBAC 层的实现