在 MCP 服务器中使用 Orchestrator 资产

MCP 服务器通常需要密码（API 密钥、数据库凭据、服务令牌）才能连接到外部系统。您可以使用%ASSETS/AssetName%语法引用Orchestrator 资产，而不是将这些值硬编码到 MCP 服务器配置中。在运行时，机器人会解析这些引用，并将实际资产值作为环境变量注入。

命令和编码 MCP 服务器的机制相同。两者之间仅配置环境变量的位置不同。

在 Orchestrator 中创建资产

在“Orchestrator”中转到您的文件夹> “资产” > “创建资产” 。例如：

• 名称：MyApiKey
• 类型：Secret（对于用户名/密码对，则为 Credential）
• 值： sk-abc123...

资产必须与 MCP 服务器位于同一文件夹中。

在 MCP 服务器环境变量中引用资产

不同服务器类型的资产引用语法相同。环境变量的位置不同：

服务器类型	配置环境变量的位置
命令 MCP 服务器	直接在 MCP 服务器上，在 Orchestrator 中“创建”或“编辑”表单的“环境变量”字段中。
编码 MCP 服务器	在 Orchestrator 中的流程上：设置>环境变量。

在这两种情况下，条目都采用KEY=VALUE形式，其中%ASSETS/AssetName%作为值：

API_KEY=%ASSETS/MyApiKey%
DATABASE_URL=%ASSETS/MyDatabaseUrl%
REGION=us-east-1

可以混合使用资产引用和纯值。每个变量占自己的行。

读取服务器代码中的变量

Orchestrator 将原始环境变量（包括%ASSETS/...%占位符）存储在数据库中，并在静态时加密。会话启动时，Orchestrator 会将其转发到 Serverless Runtime，后者将资产引用解析为实际值，然后再将资产传递给 MCP 服务器流程。

在 MCP 服务器代码中，变量可用作标准环境变量。例如：

import os
api_key = os.environ.get("API_KEY")  # Resolved to the asset value at runtime

备注：

以下行为适用于 MCP 服务器中的资产推理：

• 资产名称在%ASSETS/...%语法中不区分大小写。
• 环境变量键决定用户界面中的密码掩码。与API_KEY 、 SECRET 、 PASSWORD 、 TOKEN或Authorization等模式匹配的键会自动使用****进行掩码。%ASSETS/...%引用本身始终可见（未掩码）。
• 如果资产不存在或机器人没有访问权限，则系统不会解析环境变量，服务器将接收原始%ASSETS/...%字符串。