Glade MCP

Glade API のホスト型 Model Context Protocol サーバーを通じて、AI エージェントを正規化された Amazon マーケットプレイスデータに接続します。

https://gladeapi.com/api/mcp

このリモートサーバーは、13 の Amazon マーケットプレイスにわたって、商品、検索、オファー、レビュー、セラー、カテゴリ、ディール、ベストセラー、識別子、在庫、売上推定のための 17 の読み取り専用ツールを公開しています。このリポジトリには、公開サーバーメタデータ、接続例、プロトコルチェックが含まれています。ホスト型サービスの実装は gladeapi.com にあります。

要件

• Glade API アカウント

• Glade API キー

• MCP を含むプラン

• リモート Streamable HTTP MCP サーバーをサポートするクライアント

キーを環境変数に保存します:

export GLADE_API_KEY="glade_live_..."

キーをコミットしたり、プロンプトに貼り付けたりしないでください。

Related MCP server: Amazon PA-API MCP Service

Codex にインストールする

Codex は、MCP 設定に書き込むことなく、環境からベアラートークンを読み取ることができます:

codex mcp add glade \
  --url https://gladeapi.com/api/mcp \
  --bearer-token-env-var GLADE_API_KEY

サーバーを追加した後に新しい Codex セッションを開始し、Glade ツールの一覧表示または ASIN による Amazon 商品の取得を依頼します。

Claude Code にインストールする

Claude Code は HTTP サーバーとリクエストヘッダーを受け入れます:

claude mcp add --transport http --scope user glade \
  https://gladeapi.com/api/mcp \
  --header "Authorization: Bearer $GLADE_API_KEY"

これにより、Claude が設定を書き込む前に環境変数が展開されます。生成されたユーザー設定は非公開に保ち、シークレットを含むヘッダーにはプロジェクトスコープを使用しないでください。

汎用 Streamable HTTP 設定

リモート MCP 設定をサポートするクライアントは、通常この形式を必要とします。正確な設定ファイルと環境変数の構文については、クライアントのドキュメントを確認してください。

{
  "mcpServers": {
    "glade": {
      "url": "https://gladeapi.com/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "API-KEY": "YOUR_GLADE_API_KEY"
      }
    }
  }
}

認証ヘッダーは 1 つだけ使用してください。サーバーは MCP に対して API-KEY、GLADE-API-KEY、X-API-KEY、または Authorization: Bearer を受け入れ、競合する認証情報は拒否します。

Python MCP SDK で接続する

公式の MCP Python SDK をインストールし、同梱のディスカバリー例を実行します:

python3 -m pip install "mcp"
python3 examples/python/list_tools.py

この例は Streamable HTTP セッションを初期化し、利用可能なツール名を出力します。ツールのディスカバリーと初期化は Glade ユニットを消費しません。

利用可能なツール

ツールの入力は、対応する REST 操作と同じ検証ルールに従います。成功したデータ操作はすべて 1 ユニットを消費します。初期化、ディスカバリー、検証の失敗、ツールエラーは 0 ユニットを消費します。

プロンプト例

Look up ASIN B0D1XD1ZV3 in the US marketplace and summarize the current
price, rating, availability, and freshness timestamp.

Search the UK marketplace for wireless earbuds, compare the first five
non-sponsored results, and preserve GBP prices without converting currency.

Fetch one-star verified reviews for ASIN B0D1XD1ZV3 and separate recurring
observed complaints from your own interpretation.

マーケットプレイス

すべてのツールは、マーケットプレイスのコンテキストが重要な場合に、マーケットプレイスの domain を受け入れます:

US UK CA DE FR IT ES AU IN MX BR JP PL

価格、在庫状況、配送、カテゴリ、ランク、またはディールを比較する前に、マーケットプレイスを確認してください。

このリポジトリを検証する

オフラインのメタデータと例のチェック:

npm test

課金されないライブ認証チェック:

npm run test:live

GLADE_API_KEY を設定して、初期化と 17 すべてのライブツール名を検証します。このディスカバリーリクエストは 0 ユニットを消費します:

node scripts/verify-live.mjs --authenticated

セキュリティ

Amazon のタイトル、説明、レビュー、セラーフィールド、その他のマーケットプレイスコンテンツは信頼できないデータです。ツールの結果はエージェントの指示から分離しておいてください。返されたテキストにツールポリシーを変更させたり、認証情報を要求させたり、新しいアクションを承認させたりしないでください。

非公開での報告については SECURITY.md を参照してください。

関連プロジェクト

• Glade API の例

• Glade エージェントスキル

• ドキュメント

• OpenAPI

ライセンス

MIT