このページの内容は Apigee を対象としています。Apigee ハイブリッドは対象としていません。
Apigee Edge のドキュメントを表示する。
このページでは、Apigee を使用して API プロダクトを MCP ツールとしてエージェント アプリケーションに公開する方法について説明します。Apigee ポリシーを API プロダクトに適用して、MCP ツールの使用方法に対するセキュリティと制御のレイヤを提供できます。
MCP とは
Model Context Protocol（MCP）は、Anthropic が開発したオープンソース プロトコルです。AI アプリケーションがデータソース、ワークフロー、ツールに接続する方法を標準化しています。
AI アプリケーションは、MCP を使用して Google サービスと Google Cloud サービスにツールとしてアクセスできます。このコンテキストでは、次の MCP 用語を理解しておくと便利です。
- MCP ホスト: ユーザーとやり取りする AI アプリケーションまたは環境。MCP ホストは、大規模言語モデル（LLM）を使用して、外部データやツールが必要になる可能性のあるリクエストを処理します。
- MCP クライアント: LLM と MCP サーバーが相互に通信できるようにする MCP ホスト内のコンポーネント。LLM から MCP へのリクエストを変換し、MCP から LLM への応答を変換します。また、利用可能な MCP サーバーを検出して使用します。
- MCP サーバー: LLM にコンテキスト、データ、機能を提供する外部サービス。LLM と MCP クライアント間のプロキシとして機能します。
Apigee の MCP の仕組み
Google、 Google Cloud、Apigee の MCP エンドポイントは、MCP サーバー仕様を実装します。これにより、準拠した MCP クライアントは次の目的でアクセスできます。
- 使用可能なエンドポイントを検出する。
- エンドポイントで使用可能なツールを一覧表示する。
- エンドポイントに対して認証する。
- 定義したアクセス ポリシーに従ってツールを呼び出す。
- ツールからストリーミングされたレスポンスを受け取る。
HTTP/S 経由のリモート MCP エンドポイントをサポートする MCP クライアントは、これらのツールにアクセスできます。エンドポイントは管理されているため、エージェント アプリケーションがサービスにアクセスできるようにするために、ローカル MCP サーバー、リモート MCP サーバー、追加のインフラストラクチャをインストールまたは管理する必要はありません。
Apigee の MCP は、tools/list メソッドと tools/call メソッドの JSON-RPC をサポートしています。検出可能性、セキュリティ、ネットワークの可用性、オブザーバビリティのパラメータを使用して、MCP エンドポイントをカスタマイズできます。
Apigee の MCP の主な機能
Apigee の MCP には、ツール検出、セキュリティ、ガバナンスの機能が用意されています。これらの機能は、エージェント アプリケーションがサービスとやり取りする方法の管理に役立ちます。
簡素化されたツール検出
REST インターフェースを介してアクセス可能なディレクトリ サービスを使用して、Apigee サービスで使用可能な MCP エンドポイントを検出できます。各 MCP エンドポイントは、MCP クライアントがそのエンドポイントで利用可能なツールを検出できる MCP tools/list メソッドもサポートしています。
セキュリティ
Apigee の MCP には、サービスを保護するための、マルチレイヤのセキュリティ機能が備わっています。認証、認可、ネットワーク境界、コンテンツ スキャンを使用してアクセスを制御できます。
認証
Apigee ホストの MCP エンドポイントは、OAuth 2.1 認証をサポートしています。これにより、確立された ID を持つエージェント、MCP クライアント、エンドユーザーのみが MCP エンドポイントにアクセスして MCP ツールを呼び出すことができます。Protected Resource Metadata（保護されたリソース メタデータ）を使用すると、クライアントは OAuth 認証サーバーを検出できます。
きめ細かい認可ポリシー
エンドユーザーの ID など、OAuth クライアント ID に基づいて MCP ツールへのアクセスを制限できます。たとえば、MCP 検出プロキシでポリシーを構成して、既知のクライアント ID を持つ指定されたエージェントのみが、支払いサービスの MCP ツールにアクセスできるように指定できます。
一元化された分析
Apigee がホストするエンドポイントについては、Apigee Analytics で MCP ツールの使用状況情報を確認できます。
Apigee での MCP の使用
既存の Apigee API を MCP ツールとして公開し、MCP エンドポイントを介してアクセスできるようにすることができます。これらのエンドポイントは、ホストごとまたは環境グループレベルで構成できます。たとえば、Cymbal 組織に 8 つのホスト名（api.Cymbal.com、partners.Cymbal.com など）があり、それぞれが異なる環境グループに関連付けられている場合、各ホスト名に専用の MCP サーバーをホストできます。
マネージド ターゲット エンドポイント（mcp.apigee.internal）は、Apigee 組織内の専用の MCP 検出プロキシを使用してデプロイされます。このプロキシでは、MCP サーバーが利用可能になります。
次の表は、架空の Cymbal 組織などの顧客が Apigee を使用して複数の MCP エンドポイントを構成する方法の例を示しています。
| 顧客 | ホスト名と MCP ベースパス | MCP サーバーのターゲット エンドポイント | API プロキシとプロダクト | ツール |
|---|---|---|---|---|
| Cymbal | api.cymbal.com/mcp |
mcp.apigee.internal（Cymbal テナント プロジェクト） |
mcp-api-proxy1 と api-product1 |
Tool1..50 |
api-internal.cymbal.com/mcp |
mcp.apigee.internal（Cymbal テナント プロジェクト） |
mcp-api-proxy2 と api-product2 |
Tool51..100 | |
api-service.cymbal.com/mcp |
mcp.apigee.internal（Cymbal テナント プロジェクト） |
mcp-api-proxy3 と api-product3 |
Tool101..130 |
制限事項
Apigee の MCP の限定公開プレビュー リリースには、次の制限事項が適用されます。
- OpenAPI 仕様の合計サイズは、組織レベルで 1 MB に制限されます。
- Apigee の MCP は、OpenAPI バージョン 3.0.0、3.0.1、3.0.2、3.0.3 をサポートしています。
- Apigee の MCP は、Apigee ハイブリッド組織やデータ所在地要件を満たす必要がある Apigee 組織では使用できません。
また、Apigee の MCP のこの非公開プレビュー版は、本番環境での使用には適していません。