MCP サーバーを登録する

Agent Registry は、Model Context Protocol（MCP）サーバーエンドポイントと、それらが公開する特定のツールを登録して管理することで、一元化されたカタログとして機能します。

このドキュメントでは、MCP サーバーを登録する方法と、そのツール仕様を Agent Registry 内で管理する方法について説明します。

**注:** 手動登録は、us と eu のマルチリージョンではサポートされていません。サポートされているリージョンまたは global ロケーションにリソースを登録する必要があります。詳細については、 Agent Registry のロケーションをご覧ください。。

MCP サーバーの自動検出 Google Cloud

公式の Google と Google Cloud リモート MCP サーバーは、Agent Registry に自動的に登録され取り込まれます。使用可能な Google とリモート MCP サーバーは、MCP サーバーのドキュメントのサポートされているプロダクトに記載されています。 Google Cloud Google Cloud

プロジェクトでサポートされている Google Cloud API（ Compute Engine API など）を有効にすると、対応する MCP サーバーとそのツールがすぐに登録され、Agent Registry で検出できるようになります。これらのサービスでは、ツール仕様を手動で構成またはアップロードする必要はありません。

外部 MCP サーバーを登録する

外部サービスまたはカスタム API によって提供されるツールを管理して再利用するには、MCP サーバーを明示的に登録する必要があります。

MCP サーバーを手動で登録すると、Agent Registry はエンドポイントを登録します。ただし、サーバーを自動的にイントロスペクションして、使用可能なツールを特定することはありません。ユーザーが MCP サーバーで使用可能なツールを正確に検出できるようにするには、登録時に toolspec.json ファイルをアップロードしてツール仕様を指定する必要があります。

始める前に

始める前に、Agent Registry を設定します。これらのタスクを行うには、プロジェクト ID が必要です。

このドキュメントの gcloud CLI コマンドを使用するには、Google Cloud CLI 環境を設定していることを確認してください。

必要なロール

Agent Registry で MCP サーバーを手動で登録するために必要な権限を取得するには、プロジェクトに対するAgent Registry API 編集者（roles/agentregistry.editor）IAM ロールの付与を管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

ツール仕様を準備する

サーバーが提供するツールを概説する toolspec.json ファイルを作成します。この JSON ファイルは、ツールスキーマの MCP 仕様に準拠している必要があります。例:

{
  "tools": [
    {
      "name": "get_customer_info",
      "description": "Retrieves customer details from the database.",
      "annotations": {
        "title": "Get Customer Info",
        "readOnlyHint": true,
        "idempotentHint": true
      }
    },
    {
      "name": "create_support_ticket",
      "description": "Creates a new support ticket in the issue tracking system.",
      "annotations": {
        "title": "Create Support Ticket",
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": true
      }
    }
  ]
}

詳細な構造要件については、JSON スキーマと REST リファレンスをご覧ください。

サーバーとツールを登録する

MCP サーバーを登録し、ツール定義を同時にアップロードします。

コンソール

コンソールで [Agent Registry] に移動します。 Google Cloud

Agent Registry に移動
プロジェクト選択ツールから、Agent Registry を設定した Google Cloud プロジェクトを選択します。
[MCP サーバー] タブを選択します。
[MCP サーバーを追加] をクリックします。
[MCP サーバーの詳細] パネルで、表示名、説明、地理的リージョンを入力します。
[ツール仕様] セクションで、MCP サーバーエンドポイントの URL を入力し、toolspec.json ファイルの内容を貼り付けます。このパネルで [ツールをインポート] をクリックして、URL から MCP ツールをインポートすることもできます。
[次へ] をクリックします。

[MCP ツールを選択] パネルに、MCP サーバーの名前と説明を含むツールのリストが表示されます。
含める MCP ツールをすべて選択します。リストからツールを名前または値でフィルタできます。
[保存] をクリックします。

gcloud

ツール仕様を使用して MCP サーバーを登録します。

gcloud alpha agent-registry services create SERVER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --mcp-server-spec-type=tool-spec \
  --mcp-server-spec-content=@toolspec.json \
  --interfaces=url=SERVER_URL,protocolBinding=PROTOCOL

次のように置き換えます。

SERVER_NAME: MCP サーバーに付ける名前（custom-mcp-server など）。
PROJECT_ID: プロジェクト ID。
REGION: レジストリリージョン。
DISPLAY_NAME: サーバーに付ける人間が読める名前（Custom MCP Server など）。
SERVER_URL: MCP サーバーのエンドポイント URL（https://api.example.com/mcp など）。
PROTOCOL: エンドポイントのプロトコルバインディング。有効な値は、JSONRPC、HTTP_JSON、GRPC です。MCP サーバーの場合、この値は JSONRPC であることがよくあります。

登録を確認する

新しく登録した MCP サーバーの詳細を一覧表示、フィルタ、表示します。 MCP サーバーが正常に登録されたことを確認するには、レジストリ内のサーバーを一覧表示できます。

MCP サーバーを登録する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

MCP サーバーの自動検出 Google Cloud

外部 MCP サーバーを登録する

始める前に

必要なロール

ツール仕様を準備する

サーバーとツールを登録する

コンソール

gcloud

登録を確認する

MCP サーバーを登録する