快速接入
服务地址、访问凭据，以及第一次不修改数据的调用。
接入信息
| 项目 | 值 |
|---|---|
| 环境 | Dev，调用写工具会修改真实的开发环境数据 |
| MCP 地址 | https://mcp.viivo.djagon.com/mcp/ |
| 传输方式 | Streamable HTTP |
| 鉴权 | Authorization: Bearer <MCP_TOKEN> |
| 调试入口 | MCP Bearer 调试台 |
向管理员领取 MCP 访问凭据，以及允许使用的项目、工作区和委托身份信息。当前 MCP 接受服务 Bearer Token，不接受 Facade 用户登录 Cookie 或用户登录 Token。文档站不保存或分发凭据。
配置 MCP 客户端
在支持 Streamable HTTP 的客户端中填写服务 URL，并配置 Authorization 请求头。不同客户端的配置文件结构不同，以下是连接信息示意，不能直接套用为所有客户端的配置文件：
{
"url": "https://mcp.viivo.djagon.com/mcp/",
"transport": "streamable-http",
"headers": {
"Authorization": "Bearer <由管理员提供的 MCP_TOKEN>"
}
}标准 MCP 客户端会处理初始化和协议协商。手工调试时可使用下面的请求。
第一次请求：列出能力
先在本机安全地设置环境变量 MCP_TOKEN，不要把真实 Token 写进共享文档或仓库。
curl https://mcp.viivo.djagon.com/mcp/ \
-H "Authorization: Bearer $MCP_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-06-18" \
--data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'tools/list 只返回工具说明及输入 Schema，不执行项目操作。如果返回 401，先确认使用的是 MCP Token，并且请求头只有一个 Bearer 前缀。
读取画布
由管理员提供可访问的 project_id 和 canvas_id，参照 读取画布 的参数及完整调用示例发送请求。不要把显示名称当成 ID。
HTTP 入口是 /mcp/，能力名称放在 params.name，参数放在 params.arguments。服务注册表可能包含未在此目录发布的工具；对外接入以本文档的发布范围为准。
身份和对象权限
持有 Token 只表示通过 MCP 服务鉴权，不会绕过 Facade 的项目、工作区和对象权限检查。若管理员要求委托身份，请使用其提供的 X-Viivo-Actor-Subject、X-Viivo-Actor-Issuer 和相关范围请求头，不自行猜测身份。
画布编辑授权
新增、修改和删除节点还需要有效的画布编辑授权。通过 Agent 调用时，X-AgentOS-Run-Id 应为管理员或应用提供的真实画布聊天运行标识，Facade 使用该运行保存的授权。它与业务参数中的节点 run_id 不同。不要自行编造运行 ID；单独设置 Bearer Token 不会自动取得编辑权。