MCP を使用した API 統合とコード アシスト ツールキット

選択したコーディング アシスタントから Merchant API に関するコンテキスト インテリジェンスを取得します。統合開発環境（IDE）内で、Model Context Protocol（MCP）サービスを使用してデベロッパー ドキュメント統合にアクセスできるようになりました。このサービスは、公式の Google API ドキュメントから信頼できるコンテキストをコーディング アシスタントに提供することで、統合と移行のワークフローの開発を加速します。

プロトコル自体の詳細については、Model Context Protocol 標準をご覧ください。

概要

Content API for Shopping から Merchant API に移行する場合や、新しい統合を構築する場合は、新しいサービス構造、リソース名、メソッドを理解する必要があります。MCP サービスは、公式ドキュメントとコードサンプルをコーディング アシスタントに提供することで、このプロセスを簡素化します。

このサービスは、高度に専門化された検索拡張生成（RAG）バックエンドを利用しています。MCP 対応の IDE コーディング アシスタントに Merchant API について質問すると、サービスは Google の公式リソースから最も関連性の高いテキストとコードのスニペットを取得し、コンテキストとしてコーディング アシスタントに返します。これにより、開発環境から離れることなく、アシスタントが正確で最新の回答を提供できるようになります。

仕組み

MCP を使用したデベロッパー ドキュメントの統合により、最新の AI 支援開発ワークフローに統合されます。

  1. MCP 対応のコーディング アシスタントまたはエージェントで質問します。これは、自然言語の質問や、Merchant API メソッドの実装に関するコードサンプルのリクエストなどです。
  2. コーディング アシスタントが MCP エンドポイントにコンテキストのリクエストを送信します。
  3. MCP サービスは、Merchant API の公式ドキュメント、ガイド、コードサンプルのインデックス付きコレクションを検索して、最も関連性の高い情報を見つけます。
  4. サービスは、これらの信頼できるスニペットをコーディング アシスタントのコンテキストとして返します。
  5. コーディング アシスタントは、この高品質のコンテキストを使用して、元の質問に対する正確で役立つ回答を生成します。

スタートガイド

MCP を使用するには、ストリーミング可能な HTTP トランスポートで Model Context Protocol をサポートする IDE またはコーディング アシスタントが必要です。

エンドポイントの構成

ツールをサービスに接続するには、提供されたリモート エンドポイントの詳細を使用します。ツールの構成によっては、直接サービス URL または MCP 定義のいずれかを入力する必要があります。

サービス URL は次のとおりです。

MCP Server Name: "MAPI Docs MCP"
MCP Server URL:  "https://merchantapi.googleapis.com/devdocs/mcp/"

使用シナリオの例

MCP は、一般的なユースケースでワークフローを高速化できます。

シナリオ 1: 以前の API 呼び出しを移行する

Content API for Shopping を使用する既存のアプリケーションがあり、更新する必要がある。特定のレガシー メソッドについて質問すると、新しい実装の詳細と関連するコードサンプルを取得できます。

ユーザー プロンプト:

「Content API for Shopping の accountstatuses.get メソッドに相当する Merchant API は何ですか？」

MCP サービスは、公式の移行ガイドとリファレンス ドキュメントからコンテキストを提供します。これにより、アシスタントは新しい API 名 accounts.issues を含む詳細な回答を返すことができます。

シナリオ 2: コードサンプルを探す

新機能を実装しており、参考になる実用的な例が必要である。

ユーザー プロンプト:

「Merchant API を使用して新しい配送サービスを追加する Python コードのサンプルを教えてください。」

MCP サービスは、公式の Google GitHub リポジトリとデベロッパー ガイドから関連するコードサンプルを取得します。アシスタントは、すぐに適応できる完全なコードブロックを提示します。

シナリオ 3: API のコンセプトを理解する

新しいコンセプトに遭遇した場合や、リソースの構造や Merchant API の全体的なパターンを理解したい場合。

ユーザー プロンプト:

「Merchant API を使用して商品の在庫を更新するにはどうすればよいですか？」

MCP サービスは、プロダクト リソースのドキュメントと関連するガイドからコンテキストを返します。アシスタントは、accounts.productInputs.insert メソッドの使用方法を説明し、更新する必要がある productId と在庫関連のフィールドのみを含む部分的な商品リソースを提供します。

「Merchant API でアプリケーション呼び出しを承認するにはどうすればよいですか？」

MCP サービスは、さまざまな認可方法を網羅した公式の認証ガイドからコンテキストを取得します。アシスタントは、サーバー間のやり取りにサービス アカウントを使用する、ユーザーの代わりに操作を行うときに OAuth 2.0 クライアント ID を使用するなど、利用可能な主なオプションを説明します。

シナリオ 4: API の変更に対応する

Merchant API には、Content API for Shopping とは異なる新しいパターン（リクエストのバッチ処理など）が導入されています。Content API for Shopping は特定の custombatch メソッドを使用しますが、Merchant API は組み込みの汎用 HTTP バッチ処理機能を使用します。

ユーザー プロンプト:

「Merchant API で products.custombatch を行う新しい方法は何ですか？」

MCP サービスは、Merchant API に専用の custombatch メソッドが存在しないことを説明する Refactor code for concurrent requests からコンテキストを取得します。代わりに、multipart の Content-Type で HTTP バッチ処理を使用する方法に関するドキュメントを提供します。アシスタントは、https://merchantapi.googleapis.com/batch/{sub-api}/v1 エンドポイントに送信される複数の API 呼び出しを含む単一の HTTP リクエストを構築する方法を説明し、マルチパート リクエストの構造化方法の例を提供します。これにより、混乱を招く可能性のある移行タスクがガイド付きプロセスに変わります。

ナレッジベースのソース

MCP サービスは、提供するコンテキストの正確性と信頼性を確保するため、公開されている公式なソースのみからナレッジベースを構築します。このサービスは、公式のデベロッパー サイトとコードサンプル リポジトリのコンテンツ全体をインデックスに登録します。これには次のものが含まれます。

前へ
Quickstart
次へ
Overview