Agent 平台与企业 Control MCP

接入 Agent 平台与企业 Control MCP

Token360 提供两类相互隔离的 Agent 接入方式:普通用户使用推理 Key调用模型;企业主账号还可以使用带 scope 的控制 Key连接托管 Control MCP,管理子账号、模型权限和子账号推理 Key。

不要把控制 Key 配成模型供应商 Key。控制 Key 会被推理端点拒绝,并且应只授予自动化任务真正需要的最小 scope。

个人账号:接入模型路由

在 API Keys 页面创建普通 API Key,将它保存到密钥管理器或环境变量,然后在 Agent 平台中新增 OpenAI-compatible 供应商:

供应商类型OpenAI compatible
Base URLhttps://api.token360.ai/v1
API Key推理 Key(sk-...)
ModelToken360 模型目录中可见的模型名称

如果 Agent 可以修改自己的配置,可以直接给它以下指令:

text
1新增一个名为 token360 的 OpenAI-compatible 供应商。
2从 TOKEN360_API_KEY 环境变量读取 API Key,不要把密钥写入代码仓库。
3Base URL 使用 https://api.token360.ai/v1。
4模型名称保持可配置,并通过列出模型或发送最小聊天请求验证接入。

通用配置示例:

JSON
1{
2  "provider": "openai-compatible",
3  "baseUrl": "https://api.token360.ai/v1",
4  "apiKeyEnv": "TOKEN360_API_KEY",
5  "model": "your-token360-model-name"
6}

不同平台的字段名称可能不同,但都需要 Base URL、推理 Key 和模型名称。如果平台要求选择协议,请按 Agent 的能力选择:

  • OpenAI Chat Completions:/v1/chat/completions
  • OpenAI Responses:/v1/responses
  • Anthropic Messages:/v1/messages
  • Gemini 原生接口:/v1beta/models/{model}:generateContent

企业账号:接入托管 Control MCP

企业主账号先使用已登录的用户会话创建 Management 或 Provisioning Key,并只选择自动化所需的 scope。控制 Key 明文只在创建响应中返回一次:

Shell
1curl https://api.token360.ai/enterprise/control-keys \
2  -H "Authorization: Bearer <enterprise-owner-session-token>" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "name": "provisioning-agent",
6    "keyType": "PROVISIONING",
7    "scopes": [
8      "tenant:members:read", "tenant:members:write",
9      "tenant:keys:read", "tenant:keys:write"
10    ]
11  }'

然后配置远程 Streamable HTTP MCP:

MCP URLhttps://api.token360.ai/enterprise/mcp
TransportStreamable HTTP
身份认证Authorization: Bearer <control-key>

通用 MCP 配置:

JSON
1{
2  "mcpServers": {
3    "token360-enterprise": {
4      "url": "https://api.token360.ai/enterprise/mcp",
5      "headers": {
6        "Authorization": "Bearer ${TOKEN360_CONTROL_KEY}"
7      }
8    }
9  }
10}

请使用 Agent 平台的密钥存储或环境变量插值。如果平台不支持在远程 MCP Header 中引用环境变量,应使用平台提供的安全凭证界面,不要把 Key 提交到配置文件或代码仓库。

工具与 scope

list_sub_accountstenant:members:read
create_sub_account、set_sub_account_status、delete_sub_accounttenant:members:write
get_sub_account_model_accesstenant:policies:read
set_sub_account_model_accesstenant:policies:write
list_sub_account_api_keystenant:keys:read
create_sub_account_api_key、update_sub_account_api_key、delete_sub_account_api_keytenant:keys:write

创建 Key 和创建子账号的工具可能返回一次性秘密。Agent 应直接写入目标密钥管理器,不得在聊天、日志或工单中复述。删除类工具已标记为 destructive;允许自主 Agent 调用前应要求人工确认。

验证接入

  1. 使用带有所需 scope 的控制 Key,将 Agent 平台连接到托管 MCP。
  2. 使用具备 tenant:members:read scope 的 Key 调用 list_sub_accounts,确认访问成功。
  3. 如果工具返回 API_KEY_SCOPE_DENIED,请检查 Key 的 scope,并仅授予自动化所需的权限。
  4. 使用推理 Key 发送一次最小模型请求,单独验证模型访问权限。

安全建议

  • 仅做账号和 Key 生命周期自动化时优先使用 Provisioning Key;只有需要策略、账单只读或审计只读 scope 时才使用 Management Key。
  • 为无人值守自动化设置过期时间和 IP/CIDR allowlist。
  • 不同 Agent、不同环境分别创建 Key,以便独立撤销。
  • 怀疑 Key 泄露时立即轮换。Token360 不会再次返回已有 Key 的明文。
此页面对您有帮助吗?
Agent 平台与企业 Control MCP · Token360