宣言
サーバーは、ルートにある.mcp.json で mcpServers マップとして宣言します。マニフェストのインライン mcpServers フィールドには、このラッパーを省いた同じマップを指定します。
プレースホルダー。
url または headers 内の ${NAME} には、インストールするユーザーがサーバーの Connect シートで値を入力します。${NAME:-default} は、値が保存されていない場合のフォールバックを指定します。プラグインのサーバーが読み取るのはそのインストールに保存された値のみで、同名のセッションシークレットは参照しません。宣言には実際のトークンを絶対に記述しないでください。記述した内容がそのまま保存されます。
代わりに、サーバーでローカルコマンド (command、args、env) を run することもできます。その場合、上記の HTTP 認証情報フィールドは使用できません。
スタンドアロンサーバー用の Customize フォームについては、MCPサーバーページを参照してください。プラグインのサーバーでは上記のフィールド名を使用し、URL、トランスポート、ヘッダーはインストール済みの行に read-only で表示されます。
認証情報の保持者
セットアップ
各セットアップは、上記の宣言にある項目のいずれか 1 つと、プラグインのインストール先および配布方法を組み合わせたものです。必須 (Required) ではスコープ内の全員にインストールされ、Offered では各組織またはメンバーが任意でインストールできます。どちらも Customize でプラグインごとに設定します。
- 全員にユーザーごとの OAuth を適用する
OAuth をサポートするサーバーの場合は、example-mcp 項目を利用し、エンタープライズまたは組織でプラグインを 必須 としてインストールします。
tokenScope: "user" を指定するとアクセスのデフォルトが 個人 になるため、各メンバーは Customize → MCPs から、またはその MCP を必要とする最初のセッションで、一度だけサインインすれば済みます。
- 組織で 1 つのサービスアカウントを共有する
example-mcp-service-account 項目を利用し、組織にプラグインをインストールします。
Authorizationヘッダーにはプレースホルダーが設定されているため、行には Connect と表示されます。トークンは org 管理者が入力し、メンバーには表示されません。- サーバーがトークンを拒否した場合 (401)、行には Check the credential と表示されます。サーバーが OAuth にも対応している場合は、Sign in with OAuth instead も表示されます。
- OAuth でサインインするサービスアカウントの場合は、ヘッダーを削除して
tokenScope: "org"を設定し、そのアカウントのログインを接続します。
- 組織ごとに1つのキーを使用
example-mcp-service-account 項目をエンタープライズプラグインに追加し、Offered to organizations に設定します。
- インストールは、それを行った各組織が所有します。そのため、各組織の管理者が
${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}に自組織のキーを入力します。 - エンタープライズ側では何も接続されず、どの組織も他の組織のキーを参照できません。
- 一方、必須 のエンタープライズプラグインの場合は、エンタープライズが所有するインストールが1つだけ作成され、すべての組織で1つのキーを共有します。

