Carrefour Drive MCP — AIエージェントのための食料品ショッピング

Carrefour Drive（carrefour.fr）用MCPサーバー。 Claude、Cursor、その他あらゆる Model Context Protocolクライアントで、フランスの食料品カタログを検索し、カートを構築し、 Driveの受け取り時間枠や配送枠を選び、ポイント残高や過去のレシートを確認できます — すべてお客様自身のCarrefourアカウントで。

48のツール。 43個の実在するcarrefour.fr APIエンドポイントをJSONとして記述し、 汎用エグゼキュータで実行します。さらに5つのセッション管理ツールを追加。エンドポイントの追加は JSONファイルを1つ置くだけ — コードは不要です。

"What did I buy last month?"            → get_loyalty_order_receipts
"Refill my usual weekly groceries."     → get_frequent_purchases + add_item_to_cart
"Cheapest organic pasta under 2 €?"     → search_products
"Book the Saturday morning Drive slot." → get_delivery_timeslots + select_cart_delivery_slot

• スタンドアロン — spectralバイナリも、外部ゲートウェイも、APIキーも不要。クローンして、ビルドして、実行するだけ。

• Cloudflare対策済み — すべての呼び出しは実際のChromiumページから発行されるため、 200以外の応答はありません。

• ログイン状態を維持 — ブラウザウィンドウで一度ログインするだけ。サーバーが OAuth2 SSOループを通じてセッションを自動更新します。

目次

• インストール

• エージェントに接続する — Claude Code · Claude Desktop · Cursor、Windsurf、Zed、VS Code

• ログイン

• ツールリファレンス

• なぜ実ブラウザなのか

• 認証の仕組み

• エグゼキュータの仕組み

• 設定

• インストールの確認

• FAQ

Related MCP server: mcp-leclerc-drive

インストール

クローンするものは何もありません。Node.js 20+ が唯一の前提条件です（ネイティブの fetch、FormData、node:testを使用）。

npx -y github:maximeallanic/CarrefourDriveMCP

その1つのコマンドで、stdio上で動作するサーバーをフェッチしてビルドし、起動します — 初回実行時には HTTPトランスポートとして使用するChromiumもダウンロードされます。ほとんどの場合、 コマンドを自分で入力する必要はありません。MCPクライアントの設定に記載しておけば （次のセクション）、クライアントが代わりに実行してくれます。

一度グローバルにインストールしたい場合は？

npm install -g github:maximeallanic/CarrefourDriveMCP
carrefour-drive-mcp

セッション、ブラウザプロファイル、ログは~/.carrefour-drive-mcpに保存されます （CARREFOUR_DATA_DIRを設定すれば変更可能）。そのため、アップグレードしても ログアウトされることはありません。

git clone https://github.com/maximeallanic/CarrefourDriveMCP.git
cd CarrefourDriveMCP
npm install     # builds, and downloads the Chromium transport
node dist/index.js

ソースからチェックアウトした場合、データはリポジトリ内のdata/ディレクトリに保存されます。

エージェントに接続する

Claude Code

claude mcp add carrefour-drive -- npx -y github:maximeallanic/CarrefourDriveMCP

その後、任意のセッションで：

> Log me in to Carrefour        (runs carrefour_browser_login)
> Add 2 L of semi-skimmed milk to my Drive cart

Claude Desktop

claude_desktop_config.jsonを編集します：

• macOS — ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows — %APPDATA%\Claude\claude_desktop_config.json

• Linux — ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "carrefour-drive": {
      "command": "npx",
      "args": ["-y", "github:maximeallanic/CarrefourDriveMCP"]
    }
  }
}

Claude Desktopを再起動すると、Carrefourツールがツールメニューに表示されます。

Windowsでは、"command": "cmd"を使用し、 "args": ["/c", "npx", "-y", "github:maximeallanic/CarrefourDriveMCP"]とします。

Cursor、Windsurf、Zed、VS Code、その他のMCPクライアント

stdioでMCPを話せるクライアントなら、同じ2つのフィールドで動作します：

{
  "command": "npx",
  "args": ["-y", "github:maximeallanic/CarrefourDriveMCP"]
}

• Cursor — ~/.cursor/mcp.json（またはプロジェクト内の.cursor/mcp.json）

• Windsurf — ~/.codeium/windsurf/mcp_config.json

• VS Code / Copilot — .vscode/mcp.jsonの"servers"配下

• Zed — settings.jsonの"context_servers"配下

グローバルにインストールした場合やソースからクローンした場合は、代わりに以下を使用します： {"command": "carrefour-drive-mcp"}または {"command": "node", "args": ["/absolute/path/to/dist/index.js"]}。

すでにクッキーをお持ちの場合は、ログインの代わりに"env"ブロックで渡せます： {"CARREFOUR_COOKIES": "…cookie header…"}。

ログイン

carrefour.frは、Cloudflare Turnstileキャプチャと OTPの背後でクッキーによるサインインを行います。そのためログインは対話式で、一度だけ行います：

1. エージェントに carrefour_browser_login の実行を依頼します。

2. Carrefourのログインページでブラウザウィンドウが開きます。メールアドレス、パスワード、 OTPコードはご自身で入力してください。

3. ウィンドウを閉じないでください — サーバーがOAuthループの完了を検出し、 メモリからセッションクッキーを取得して、ウィンドウを閉じます。

以降、セッションは自動的に更新されます。サーバーは認証が必要な呼び出しの前にSSOの authorize → callbackリダイレクトを再生し、さらに30分ごとにキープアライブを実行します。 SSOクッキー自体が期限切れになった場合（最大24時間、またはアイドル60分）にのみ、 再度ログインが必要です — ツールがその旨を明示的に通知します。

セッション状態はいつでもcarrefour_session_statusで確認できます（verify: trueで 実際の呼び出しを行います）。

carrefour_set_cookiesでは、JSON配列形式のみがクッキーの domainを保持できます — c4iamsecuretkを提供できるのはこの形式だけであり、 これがないと自動更新は不可能です。

クッキージャーは<data dir>/sessions/cookies.json（0600）に保存され、 起動のたびにブラウザプロファイルへ再注入されます。

ツールリファレンス

検索とカタログ （アカウント不要）

カートとチェックアウト

⚠️ submit_checkout_paymentは実際の支払いを実行します。4つのパラメータが 説明ではHTTPヘッダーを示唆しているにもかかわらず、クエリ文字列として取得されました — 本番環境で使用する前に、実際のトレースと照合して確認してください。

アカウント、注文、ポイント

買い物リスト

なぜ実際のブラウザが必要なのか

carrefour.fr は Cloudflare の マネージドチャレンジ の背後にあり、クライアントをフィンガープリントします。同じ日に1つのIPから測定した結果:

ヘッダーをいくら調整しても変わりません。唯一有効なトランスポートはブラウザです。そしてリクエストはページから発行される必要があります — Playwright の APIRequestContext は Node の HTTP スタックを使用するため、fetch と同様にブロックされます。

そこで、サーバーは永続的な Chromium を保持し、すべての API 呼び出しをターゲットオリジンに駐車したページ内の fetch として実行します(オリジンごとに1ページ、CORS のため)。これはウィンドウレスで実行されますが、標準のヘッドレスモードではありません:

最後の行が実際に出荷されるものです。

認証の仕組み

2つの独立した Cookie システム:

ログインは2つの制約があるため対話式です。フォームは Cloudflare Turnstile キャプチャの背後にあり、CDP 駆動のブラウザでは検証を拒否します。また、c4iamsecuretk は セッション Cookie であり、Chromium がディスクに書き込むことはありません。そこで、ウィンドウはデバッグポートを開いた通常の Chromium ですが、ログインが完了するまで何もアタッチされません。サーバーは /json/list 上のプレーン HTTP でタブをポーリングします(CDP ドメインが有効でないため、自動化の痕跡はありません)。OAuth ループがストアに戻ってきた瞬間にアタッチし、Cookie をメモリから読み取ります。

その後も更新は通常のナビゲーションです — Chromium がリダイレクトを追跡し、Cookie を自分で設定します:

GET moncompte.carrefour.fr/iam/oauth2/CarrefourConnect/authorize?client_id=…&redirect_uri=https://www.carrefour.fr/login/check
  └─302─► www.carrefour.fr/login/check?code=…   (the BFF exchanges the code)
      └─302─► www.carrefour.fr/                  (fresh session cookies)

エグゼキューターの仕組み

tools/*.json ──► loader (validation) ──► params (JSON Schema ➜ zod) ──► MCP tools/list
                                     └─► resolve ($param ➜ URL/query/headers/body)
                                              └─► http.service (cookies + rate limit + fetch)

tools/ 内のすべてのファイルは自己記述的です:

{
  "name": "add_item_to_cart",
  "parameters": { "type": "object", "properties": { … }, "required": [ … ] },
  "request": {
    "method": "PATCH",
    "url": "https://www.carrefour.fr/api/cart",
    "headers": { … },
    "query": {},
    "body": { "items": [ { "ean": { "$param": "ean" }, … } ] },
    "content_type": "application/json"
  },
  "requires_auth": true
}

エンジン(src/spec/):

• headers、query、body 内の {"$param": "name"} ノードを再帰的に置換し、元の型(数値、ブール値、配列)を保持します;

• 引数のないプレースホルダーを削除するため、オプションパラメータはリクエストから null として送信される代わりに消えます;

• URL セグメント {basket_service_type}、{store_id} などをエンコードして埋め込み、必須セグメントが欠けている場合は明確なメッセージで失敗します;

• 配列を繰り返しクエリキーとしてシリアライズします(codes[]=14&codes[]=15);

• content_type に応じてボディをエンコードします: JSON、x-www-form-urlencoded、または multipart/form-data(境界は fetch に任せます);

• ジッター付きのスライディングレート制限とブラウザヘッダーを適用します。

エンドポイントの追加 = tools/ に新しい JSON ファイルを置くだけです。コードを書く必要はありません。

設定

.env.example を参照してください。主な変数:

インストールの確認

ソースチェックアウトから:

npm run build     # tsc
npm test          # build + unit tests (node:test)
npm run smoke     # build + real MCP stdio handshake + tools/list
npm run verify    # all three

テストでは $param の置換、URL セグメント、クエリ文字列内の配列、3つのボディエンコーディング、Cookie ジャーの処理をカバーしています。スモークテストは実際にサーバーを起動し、JSON-RPC ハンドシェイクを実行してツールを一覧表示します。

carrefour.fr へのネットワーク呼び出しは自動テストされません — 実際のアカウントと有効な Cookie が必要です。

FAQ

API キーは必要ですか? いいえ。Carrefour には公開 API がありません。このサーバーは、ウェブサイトが使用するのと同じプライベートエンドポイントを、あなた自身のセッションで駆動します。

フランス国外でも動作しますか? カタログと店舗はフランス向けです(carrefour.fr)。Cloudflare は一部の IP からより厳格に動作する場合があります。

パスワードは保存されますか? いいえ。ブラウザウィンドウに入力するだけです。永続化されるのは Cookie のみで、~/.carrefour-drive-mcp/sessions/cookies.json に 0600 パーミッションで保存されます。このリポジトリには認証情報は一切含まれず、data/ と .env は gitignore されています。

実際の注文を発行できますか? はい — submit_checkout_payment は実際の支払いを請求します。そのように扱ってください。

エンドポイントを追加できますか? tools/ に JSON ファイルを置いてください。エグゼキューターの仕組み を参照してください。

サポートされているクライアントは? stdio 経由で MCP を話すものなら何でも: Claude Code、Claude Desktop、Cursor、Windsurf、VS Code / Copilot、Zed、Continue、MCP SDK を使用したカスタムエージェント。

免責事項

非公式プロジェクトであり、Carrefour とは提携、承認、支援の関係はありません。個人利用および教育目的で、ご自身のアカウントで使用してください。Carrefour の利用規約を尊重し、それに応じてレート制限を守ってください。

ライセンス

MIT © Maxime Allanic

キーワード: Carrefour MCP server · Carrefour Drive API · Model Context Protocol 食料品 · Claude Desktop MCP · Claude Code MCP server · Cursor MCP · フランスの食料品の買い物AIエージェント · オンラインショッピング · drive · 買い物リスト · Carrefour ロイヤルティ · MCP ショッピングカート自動化.