MCP 経由で idealo を Claude に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → idealo をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

idealo + Claude

idealo の Partner Web Service を通じて、AI エージェントから idealo の価格比較に掲載するショップのオファーを管理します。SKU でオファーを読み取り、承認のうえでオファーの作成や置き換え、価格、配送日数、タイトルの変更、オファーの削除ができます。idealo に掲載されているショップ向けです。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

IDEALO_CLIENT_ID, IDEALO_CLIENT_SECRET, IDEALO_SHOP_ID

ステップ 1 — 認証情報を取得

セットアップは約 3 分です。idealo に掲載されているショップ (idealo との加盟店契約) と、idealo Business へのアクセスが必要です。

1. idealo Business にサインインし、Shop settings → API clients (business.idealo.com/direct/shops/settings/api-clients) を開きます。
2. Partner Web Service へのアクセス権を持つ API クライアントを作成し、その client ID と client secret をコピーします。secret は一度しか表示されません。手元にない場合は新しいクライアントを作成してください。
3. client ID (UUID) を IDEALO_CLIENT_ID に、secret を IDEALO_CLIENT_SECRET に、idealo Business に表示される数字の shop ID を IDEALO_SHOP_ID に貼り付けます。AnythingMCP がクライアント認証情報を有効期間 1 時間のアクセストークンに交換し、自動で更新します。
4. コネクタをインストールし、公開中だとわかっているオファーの SKU で idealo_get_offer を実行します。idealo に保存されているとおりのオファーが表示されます。

読み取れるデータ: SKU で指定したオファーを 1 件ずつ、idealo に保存されているとおりに読み取ります。タイトル、価格と値下げ前の価格、URL、EAN とメーカー品番、ブランド、配送料と支払い手数料、配送日数、エネルギーラベル、商品の状態、その他のオファー項目です。Partner Web Service には一覧取得の呼び出しがないため、AI が SKU をお尋ねします。

オファーのみで、注文は扱いません: Partner Web Service 2.0 は、idealo に掲載されたショップが、商品フィードの代わりに、またはフィードと併用して、オファーを 1 件ずつ管理するためのインターフェースです (idealo.de、.at、.fr、.it、.es、.co.uk)。idealo は 2023 年にチェックアウトサービス (Direktkauf) とその注文 API を終了したため、注文は引き続きご自身のショップに入ります。

オファーの書き方: 価格は小数点以下ちょうど 2 桁の文字列で、"177.99" のように書きます。値下げ前の価格は割引前の価格です。新しいオファーには少なくとも SKU、タイトル、価格、URL、配送料 1 件 (例: "DHL": "4.90") と支払い手数料 1 件 (例: "PAYPAL": "0.00") が必要で、EAN、メーカー品番、ブランドがあると idealo が商品を照合しやすくなります。idealo_upsert_offer はオファー全体を置き換えるため、送らなかった項目は削除されます。idealo_update_offer は送った項目だけを変更しますが、配送料と支払い手数料、サイズ、色、性別、素材、動的な商品属性は変更できず、EAN や画像などのリスト項目はすべて送る必要があります。SKU に使えるのは英字、数字、アンダースコア、ピリオド、ハイフンだけです。

変更の前に必ず確認します: インストール時には、書き込みツールは 1 つも有効になっていません。管理者が有効にした後も、AI は変更前と変更後の値を含むオファーを示すか、削除する SKU を伝え、承認を得てから公開します。

インストール時にオフ: idealo_upsert_offer、idealo_update_offer、idealo_delete_offer。idealo にはテスト環境がないため、書き込みはすぐに価格比較上の公開中のオファーに反映され、削除したオファーは idealo から消えます。AI に使わせるものだけを有効にしてください。すべてのオファーを一括削除する機能は、意図的に用意していません。

制限: idealo は呼び出し回数を制限しており、現在の上限は X-RateLimit-Limit ヘッダーに示されます。429 が返ったら AI は待ってから再試行し、オファーは 1 件ずつ変更します。

よくあるエラー: 401 は client ID または secret が誤っているか、トークンが拒否されたことを示します。Shop settings → API clients で確認してください。403 は API クライアントに Partner Web Service の権限がないか、shop ID がご自身のものでないことを示します。404 はこのショップにそのオファーが存在しないことを示します (SKU または shop ID の誤り)。400 では、項目と理由を含む fieldErrors が返ります (例: 小数点以下 2 桁でない価格)。

このコネクタは注文の読み取りや処理、全オファーの一覧表示、商品フィードの変更、全オファーの一括削除は行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Claude にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

推奨ルート：設定ファイルを触らずに claude.ai web で動作します。

1. Claude で Customize → Connectors を開きます。
2. + をクリックし、Add custom connector を選びます。
3. 名前（例: idealo）とリモート MCP サーバー URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力し、Add をクリックします。
4. Connect をクリックし、AnythingMCP にサインイン（OAuth）してアクセスを許可します。

下記のすべてのツールがチャットに表示されます。プロンプトを入力し始めてください。

利用可能なツール

プロンプトの例

• 「SKU KS-4711 のオファーは今 idealo でどう掲載されていますか？価格、配送日数、送料を教えてください。」
• 「SKU TV-55-OLED の価格を 899.00 ユーロに下げ、値下げ前の価格として 999.00 ユーロを表示してください。」
• 「SKU BOSCH-GSR18 の配送日数を 1-3 営業日に変更してください。」
• 「SKU LAMP-200、EAN 4006381333931 で idealo に新しいオファーを作成してください。価格は 49.90 ユーロ、DHL の送料は 4.90 ユーロ、PayPal は手数料なしです。」
• 「SKU KS-4711 のオファーを idealo から取り下げてください。在庫切れです。」

FAQ

Claude Code は Claude Desktop と同じように動作しますか? はい。両方を https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID に向けてください。

次のステップ

• コネクタのランディング
• ChatGPT に接続
• Cursor に接続
• Gemini に接続
• Meta Muse に接続