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 URL | https://api.token360.ai/v1 |
| API Key | 推理 Key(sk-...) |
| Model | Token360 模型目录中可见的模型名称 |
如果 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 URL | https://api.token360.ai/enterprise/mcp |
| Transport | Streamable 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_accounts | tenant:members:read |
create_sub_account、set_sub_account_status、delete_sub_account | tenant:members:write |
get_sub_account_model_access | tenant:policies:read |
set_sub_account_model_access | tenant:policies:write |
list_sub_account_api_keys | tenant:keys:read |
create_sub_account_api_key、update_sub_account_api_key、delete_sub_account_api_key | tenant:keys:write |
创建 Key 和创建子账号的工具可能返回一次性秘密。Agent 应直接写入目标密钥管理器,不得在聊天、日志或工单中复述。删除类工具已标记为 destructive;允许自主 Agent 调用前应要求人工确认。
验证接入
- 使用带有所需 scope 的控制 Key,将 Agent 平台连接到托管 MCP。
- 使用具备
tenant:members:readscope 的 Key 调用list_sub_accounts,确认访问成功。 - 如果工具返回
API_KEY_SCOPE_DENIED,请检查 Key 的 scope,并仅授予自动化所需的权限。 - 使用推理 Key 发送一次最小模型请求,单独验证模型访问权限。
安全建议
- 仅做账号和 Key 生命周期自动化时优先使用 Provisioning Key;只有需要策略、账单只读或审计只读 scope 时才使用 Management Key。
- 为无人值守自动化设置过期时间和 IP/CIDR allowlist。
- 不同 Agent、不同环境分别创建 Key,以便独立撤销。
- 怀疑 Key 泄露时立即轮换。Token360 不会再次返回已有 Key 的明文。
此页面对您有帮助吗?