メインコンテンツへスキップ
プラグインには MCP サーバー (例えば issue トラッカーなど) を含めることができます。これにより、プラグインをインストールしたすべてのユーザーが、一から設定しなくても同じサーバー設定を利用できます。インストール後に、APIキーや OAuth サインインなど、サーバーに必要な認証情報を指定します。接続が個人用になるか共有になるかは、プラグインのインストール先と、インストールの アクセス 設定によって決まります。

宣言

サーバーは、ルートにある .mcp.json で mcpServers マップとして宣言します。マニフェストのインライン mcpServers フィールドには、このラッパーを省いた同じマップを指定します。
プレースホルダー。 url または headers 内の ${NAME} には、インストールするユーザーがサーバーの Connect シートで値を入力します。${NAME:-default} は、値が保存されていない場合のフォールバックを指定します。プラグインのサーバーが読み取るのはそのインストールに保存された値のみで、同名のセッションシークレットは参照しません。宣言には実際のトークンを絶対に記述しないでください。記述した内容がそのまま保存されます。 代わりに、サーバーでローカルコマンド (command、args、env) を run することもできます。その場合、上記の HTTP 認証情報フィールドは使用できません。
スタンドアロンサーバー用の Customize フォームについては、MCPサーバーページを参照してください。プラグインのサーバーでは上記のフィールド名を使用し、URL、トランスポート、ヘッダーはインストール済みの行に read-only で表示されます。

認証情報の保持者

セットアップ

各セットアップは、上記の宣言にある項目のいずれか 1 つと、プラグインのインストール先および配布方法を組み合わせたものです。必須 (Required) ではスコープ内の全員にインストールされ、Offered では各組織またはメンバーが任意でインストールできます。どちらも Customize でプラグインごとに設定します。

  1. 全員にユーザーごとの OAuth を適用する

OAuth をサポートするサーバーの場合は、example-mcp 項目を利用し、エンタープライズまたは組織でプラグインを 必須 としてインストールします。 tokenScope: "user" を指定するとアクセスのデフォルトが 個人 になるため、各メンバーは Customize → MCPs から、またはその MCP を必要とする最初のセッションで、一度だけサインインすれば済みます。

  1. 組織で 1 つのサービスアカウントを共有する

example-mcp-service-account 項目を利用し、組織にプラグインをインストールします。
  • Authorization ヘッダーにはプレースホルダーが設定されているため、行には Connect と表示されます。トークンは org 管理者が入力し、メンバーには表示されません。
  • サーバーがトークンを拒否した場合 (401)、行には Check the credential と表示されます。サーバーが OAuth にも対応している場合は、Sign in with OAuth instead も表示されます。
  • OAuth でサインインするサービスアカウントの場合は、ヘッダーを削除して tokenScope: "org" を設定し、そのアカウントのログインを接続します。

  1. 組織ごとに1つのキーを使用

example-mcp-service-account 項目をエンタープライズプラグインに追加し、Offered to organizations に設定します。
  • インストールは、それを行った各組織が所有します。そのため、各組織の管理者が ${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN} に自組織のキーを入力します。
  • エンタープライズ側では何も接続されず、どの組織も他の組織のキーを参照できません。
  • 一方、必須 のエンタープライズプラグインの場合は、エンタープライズが所有するインストールが1つだけ作成され、すべての組織で1つのキーを共有します。

  1. 1つのプラグインで両方を提供する

上記の宣言のように両方の項目を含めたうえで、プラグインを提供します。プラグインをインストールした各組織には2つの行が作成されます。1つはメンバーがサインインする行、もう1つは org 管理者が接続する行です。サーバー名を別々にしておけば、プラグインのスキル内で利用するサーバーを指定できます。