リモート MCP

同じエンドポイント https://ecommercedataapi.com/mcp で、45 個の個別業務ツールと 従来の 4 個の汎用ツール、計 49 個のツール、および 1 個の MCP Prompt を提供します。 通信には Streamable HTTP を使用します。WorkBuddy などの対応クライアントでは ブラウザ OAuth を推奨します。API キーによる直接接続も引き続き利用できます。

JSON 設定と接続確認は WorkBuddy の設定手順を参照してください。

ツールと Prompt

業務ツールは MCP のツール一覧に個別に表示されます。名前は API の正規 URL に基づきます。

各ツールは独自の入力スキーマを公開します。クライアントに表示されるパラメーターを使用してください。 操作の詳細は API カタログで確認できます。 OCR のファイルアップロードは当面 REST のみで利用でき、45 個の業務ツールには含まれません。

従来のワークフロー向けに、以下の汎用ツールも残ります。

例：「amazon_asin_detail で Amazon US の ASIN B08CK5Z5Q1 の価格と評価を調べてください」。 このデータ取得にはクレジットを消費します。

MCP Prompt の名前は ecommerce-data-api、タイトルは Ecommerce Data API です。 任意の task 引数は最大 4,000 文字です。選択すると指示が読み込まれるだけで、 データ取得や課金は行われません。スラッシュメニューへの表示はクライアントに依存します。 Prompt を選択せず、自然言語でツールを呼び出すこともできます。

ブラウザ OAuth で接続する

1. 本番 URL を HTTP / Streamable HTTP サーバーとして追加します。WorkBuddy では type: "http" と url のみを設定し、Authorization、Client ID、Client Secret は入力しません。
2. 対応クライアントではブラウザ認可が自動で開きます。Ecommerce Data API にログインします。
3. 有効な既存 API キーを選んで認可を確認するか、認可画面で明示的に作成して認可を選びます。
4. 既存キーが 1 個の場合は選択済みになりますが、確認操作は必要です。認可後にクライアントへ戻ります。

OAuth では API キーの値をクライアントへ渡しません。 MCP 設定で接続を確認・取り消せます。 WorkBuddy の旧設定に固定の Authorization ヘッダーがある場合は、 このサービスの該当ヘッダーだけを削除して再接続してください。 必要に応じて、この接続だけの古い認可キャッシュを削除します。他の MCP 設定は維持してください。

クレジットとキーのライフサイクル

MCP と REST はアカウント残高を共有します。各データ取得は API カタログに記載された クレジットを消費し、1 回の依頼で複数の課金対象クエリが実行される場合があります。 キーごとの独立した予算、権限、レート制限はありません。

選択したキーをリセット・削除した場合や期限切れになった場合、アクセスは無効になります。 OAuth のキー変更には再認可が必要です。MCP 接続を取り消しても REST API キーは 削除・無効化されず、そのキーによる直接接続も停止しません。 直接接続を止めるにはキーをリセットまたは削除してください。失敗した有料リクエストは自動再試行されません。

その他の接続方法

直接接続では Authorization: Bearer <api-key> を使用します。 クライアントがキーを保存し、ブラウザ OAuth は開始しません。キーを URL に含めないでください。

ローカル stdio は引き続き API キーを使い、OAuth 接続には変わりません。 更新されたツール一覧には CLI 0.2.2 以降を使用してください。 設定はプラットフォーム別ガイドを参照してください。

OAuth クライアントには OAuth 2.1 と PKCE S256 の対応が必要です。 接続は Ecommerce Data API の MCP リソースに対して ecommerce:tools offline_access を要求します。