MCP サーバーで Orchestrator アセットを使用する

MCP サーバーは、多くの場合、外部システムに接続するためにシークレット (API キー、データベース資格情報、サービス トークン) を必要とします。これらの値を MCP サーバー構成にハードコーディングする代わりに、%ASSETS/AssetName% 構文を使用して Orchestrator アセットを参照できます。実行時に、ロボットはこれらの参照を解決し、実際のアセット値を環境変数として挿入します。

このメカニズムは、コマンドサーバーとコード化されたMCPサーバーで同じです。環境変数が設定されている場所だけが、この 2 つで異なります。

Orchestrator でアセットを作成する

Orchestrator 内のフォルダーに移動し、[アセット>アセット] >アセットを作成します。例えば：

• Name (名前): MyApiKey
• 種類: シークレット (ユーザー名/パスワードのペアの場合は [資格情報])
• 値: 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 ランタイムに転送し、ランタイムはアセット参照を実際の値に解決してから MCP サーバー プロセスに渡します。

MCP サーバー コードでは、変数を標準の環境変数として使用できます。例えば：

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

注:

次の動作は、MCP サーバーの資産推論に適用されます。

• %ASSETS/...% 構文では、アセット名で大文字と小文字が区別されません。
• 環境変数キーは、UI でのシークレット マスキングを決定します。API_KEY、SECRET、PASSWORD、TOKEN、Authorization などのパターンに一致するキーは、****で自動的にマスクされます。%ASSETS/...%参照自体は常に表示されます (マスクされません)。
• アセットが存在しない場合、またはロボットがアクセス権を持っていない場合、環境変数は解決されず、サーバーは生の %ASSETS/...% 文字列を受け取ります。