MCP プラットフォーム設定

本番 MCP エンドポイント：

https://ecommercedataapi.com/mcp

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

接続方法の選択

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

ChatGPT Web

1. ChatGPT の設定で Developer mode を有効にします。
2. 本番 URL のリモート MCP サーバーを追加し、OAuth を選びます。
3. Ecommerce Data API にログインします。
4. 有効なキーを選んで確認するか、明示的に作成して認可を選びます。 キーが 1 個なら選択済みになりますが、確認は必要です。
5. ChatGPT に戻り、新しい会話で ecommerce_account で残りのクレジットを確認してください。有料 API はまだ呼び出さないでください。 と依頼します。

Hermes

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

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

WorkBuddy

WorkBuddy のリモート接続ではブラウザ OAuth を推奨します。設定は次だけです。

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

Authorization、Client ID、Client Secret は追加しません。対応クライアントではブラウザが 自動的に開きます。ログイン後、有効なキーを選んで確認するか、明示的に作成して認可を 選びます。キーが 1 個なら選択済みですが、確認操作は必要です。キーの値は WorkBuddy に渡りません。

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

旧設定に固定の Authorization ヘッダーがあると OAuth は開始しません。 このサービスの該当ヘッダーだけを削除して再接続し、必要ならこの接続だけの古い認可キャッシュを 削除します。他の MCP のキャッシュは削除しないでください。

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

ブラウザ OAuth がないクライアントだけで使用します。

{
  "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 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 ガイド。