MCP プラットフォーム設定

本番 MCP エンドポイント：

https://ecommercedataapi.com/mcp

Streamable HTTP を使用し、個別業務ツール 45 個と従来の汎用ツール 4 個、計 49 個の ツール、および 1 個の MCP Prompt を提供します。業務ツール名は正規 API URL から 派生し、例として amazon_asin_detail、amazon_asin_competitor があります。 OCR ファイルアップロードは当面 REST のみです。

最速の方法：API キーとこのページを AI に送る

使っているエージェントが自分の MCP 設定を編集できる場合（WorkBuddy、Claude Code、 Cursor、Codex、Hermes など）、設定ファイルを手で編集する必要はありません。 API キーページで完全なキーをコピーし、下のテンプレートに 入れてメッセージ全体を送ってください。キーとドキュメントのリンクを一度に渡せば、 AI は途中でキーを尋ねることなく設定を書き込めます。

Ecommerce Data API を MCP サーバーとして、現在のクライアントの MCP 設定に追加してください。
ドキュメント：https://ecommercedataapi.com/ja/docs/mcp-platforms
私の API キー：<ここに API キーを貼り付け>

要件：
1. ドキュメントの API キー直接接続の方法で設定してください：トランスポートは Streamable HTTP、URL は https://ecommercedataapi.com/mcp、ヘッダーは Authorization: Bearer <上のキー>（Bearer とキーの間は半角スペース 1 つ）。
2. ecommerce-data-api という名前のサーバーを 1 つだけ追加し、他の MCP 設定はすべて残してください。キーを URL に含めないでください。
3. 返信でキー全体を繰り返さないでください。
4. 完了したら、再起動または再接続が必要かを教えてください。接続後は ecommerce_account で残りクレジットを確認し、有料データ API はまだ呼び出さないでください。

キーはこのチャット履歴に残ります。AI クライアント専用のキーを作成し、不要になったら API キーページでリセットまたは削除してください。ChatGPT Web は AI が設定を編集できない ため、下記の OAuth 手順で接続してください。

接続方法の選択

OAuth クライアントには OAuth 2.1 と PKCE S256 の対応が必要です。固定 Bearer Token のみ受け付けるクライアントでは API キー直接接続を代替として使えます。

ChatGPT Web

1. ChatGPT のプラグイン設定 chatgpt.com/settings/plugins-settings を開き、Default permissions を Allow low-risk tools にします。続いて chatgpt.com/plugins で Add をクリックし、Add custom MCP server を選びます。
2. サーバー URL に本番 URL を入力し、OAuth を選びます。
3. Ecommerce Data API にログインします。
4. 有効なキーを選んで確認するか、明示的に作成して認可を選びます。 キーが 1 個なら選択済みになりますが、確認は必要です。
5. ChatGPT に戻り、新しい会話で ecommerce_account で残りのクレジットを確認してください。有料 API はまだ呼び出さないでください。 と依頼します。

ChatGPT クライアント：Plugins で API キーを直接設定

設定 → Plugins → MCP が表示されるクライアントでは、次の方法でも接続できます。

1. 追加 → MCP サーバーを追加を選び、種類を Streamable HTTP、名前を Ecommerce Data API にします。
2. URL に https://ecommercedataapi.com/mcp を入力します。
3. ヘッダーにキー Authorization、値 Bearer <あなたの API キー> を追加します。Bearer とキーの間には半角スペースを 1 つ入れ、Bearer トークンの環境変数欄は空にします。
4. 保存してサーバーを有効にします。新しい会話で上記の残高確認を行い、ecommerce_account が利用できることを確かめます。

この方法では API キーの値がクライアントに保存され、ブラウザ OAuth は開始されません。URL、スクリーンショット、共有設定ファイルにキーを含めないでください。直接アクセスを停止するにはキーをリセットまたは削除します。

Hermes

リモートサーバーを追加し、Streamable HTTP、本番 URL、 利用できる場合は OAuth / ブラウザ認可を選びます。ログイン、キーの選択または 作成して認可、確認を完了してから接続を更新します。

固定 Bearer Token 欄しかない場合は、下記の API キー直接接続を使います。 プロトコルの互換性だけでは、特定の Hermes 版で OAuth フローが完了したことは確認できません。

WorkBuddy

WorkBuddy では API キーによる直接接続を使用します。いちばん簡単なのは、上のテンプレートに キーを入れてこのページと一緒に WorkBuddy に送り、設定を書かせる方法です。次の手順で 手動設定することもできます。

ユーザー設定は ~/.workbuddy/mcp.json、Windows は %USERPROFILE%\\.workbuddy\\mcp.json、プロジェクト設定は .workbuddy/mcp.json です。既存の mcpServers にはこのサービスの項目だけを追加し、 他の MCP 設定を上書きしないでください。

WorkBuddy API キー直接接続（代替）

1. API キーページでキーを作成するか、既存のキーの完全な値をコピーします。
2. 以下の YOUR_API_KEY を自分のキーに置き換えます。Bearer とキーの間には半角スペースを 1 つ入れてください。
3. 設定を保存し、WorkBuddy でこの MCP サーバーを有効にするか、再接続します。

{
  "mcpServers": {
    "ecommerce-data-api": {
      "type": "http",
      "url": "https://ecommercedataapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

キーを URL に含めないでください。この方式ではクライアントがキーの値を保存し、 ブラウザ OAuth の接続は開始しません。

接続後、amazon_asin_detail などの業務ツールと ecommerce_account が表示されることを 確認します。ecommerce_api_search、ecommerce_api_describe、ecommerce_api_call、 ecommerce_account も従来どおり利用できます。Prompt の名前は ecommerce-data-api、タイトルは Ecommerce Data API です。 任意の task は最大 4,000 文字で、選択しても指示を読み込むだけです。データ取得や課金は行いません。 スラッシュメニューへの表示はクライアント次第で、自然言語のツール呼び出しも可能です。

Claude Code リモート OAuth

Claude Code 内でプラグインをインストールすると、この MCP サーバーと Agent Skill がまとめて入ります。

/plugin install ecommerce-data-api --marketplace ecommercedataapi/ecommerce-data-api

MCP サーバーだけを追加する場合：

claude mcp add --transport http ecommerce-data-api https://ecommercedataapi.com/mcp

/mcp でブラウザ認可を選び、ログイン、キーの選択または作成して認可、確認を行って戻ります。

Claude Code ローカル stdio

ローカルのインストーラーと stdio 接続は引き続き API キーを使い、OAuth にはなりません。

curl -fsSL https://ecommercedataapi.com/install.sh | bash -s -- --yes --only claude-code

インストーラーのローカル入力でキーを設定します。CLI 0.2.2 以降を使用し、 ecomdata doctor と ecomdata mcp status を実行します。リモート URL には CLI は不要です。

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

MCP と REST はアカウント残高を共有します。1 回の依頼で複数の課金対象データ取得が行われる 場合があります。キーごとの独立した予算、権限、レート制限はありません。選択したキーを リセット、削除、期限切れにするとアクセスは無効になり、OAuth のキー変更には再認可が必要です。

MCP 接続を取り消しても REST キーは削除・無効化されず、直接接続も停止しません。 直接接続を止めるにはキーをリセットまたは削除してください。失敗した有料リクエストは自動再試行されません。

WorkBuddy 公式資料：コネクターガイド、 MCP ガイド。