Carrefour Drive MCP

Serveur MCP et CLI non officiels pour piloter Carrefour Drive sur carrefour.fr dans un profil web Camoufox persistant appartenant à l’utilisateur.

Il ne se connecte à aucun téléphone et n’utilise aucune application mobile. Le navigateur web local conserve le magasin, la session et le panier ; le client MCP ne retourne que les champs utiles.

Capacités

• doctor_carrefour : vérifie le navigateur web local et le magasin configuré ;

• session_status_carrefour : vérifie le Drive et l’état de connexion visible ;

• connect_carrefour : ouvre un wizard local vers la connexion ou la création de compte sur le site officiel ;

• search_carrefour_products : recherche le catalogue web actuel du Drive ;

• get_carrefour_product : relit prix, disponibilité, EAN et ingrédients ;

• get_carrefour_cart : relit le panier et calcule son empreinte ;

• add_to_carrefour_cart : prévisualise, confirme, ajoute une unité sur le web et réconcilie le panier.

Le MCP ne choisit aucun créneau, ne valide aucune commande et ne paie jamais. Une page ou un état non reconnu provoque une erreur explicite, sans donnée fictive ni bascule vers un autre backend.

Related MCP server: camofox-browser-mcp

Prérequis

• Node.js 22.12 ou supérieur ;

• camofox-browser 2.4.6 ou compatible ;

• un compte Carrefour autorisé par son propriétaire (la recherche et le panier invité peuvent fonctionner avant connexion) ;

• un Drive sélectionné sur carrefour.fr dans le profil Camoufox dédié.

npm install --global camofox-browser@2.4.6

Créez une clé forte dans votre gestionnaire de secrets, définissez CAMOFOX_AUTH_MODE=required et CAMOFOX_API_KEY dans l’environnement du service, puis démarrez-le :

camofox server start --background

Installation

git clone https://github.com/ncleton-petitmaker/carrefour-drive-mcp.git
cd carrefour-drive-mcp
npm ci
npm run build
cp .env.example .env

Renseignez localement .env. CAMOFOX_USER_ID doit être unique par personne et compte. La clé Camoufox est un secret local : ne la publiez jamais.

Première utilisation

node dist/cli.js doctor
node dist/cli.js connect
node dist/cli.js session

Le wizard loopback ne possède aucun champ d’identifiant. Il ouvre la page officielle de connexion ou de création dans le profil web isolé ; le mot de passe, le code et le CAPTCHA éventuel restent exclusivement dans cette fenêtre.

Sélectionnez ensuite votre Drive sur Carrefour si nécessaire, puis utilisez :

node dist/cli.js search --query tofu --limit 5
node dist/cli.js product --product-ref 'URL-retournée-par-search'
node dist/cli.js cart
node dist/cli.js add --product-ref 'URL-retournée-par-search'

La première commande add prévisualise l’opération et retourne l’empreinte du panier. Après vérification, relancez-la avec --confirm-cart-fingerprint <empreinte>. Dans MCP, le premier appel retourne un jeton à usage unique valable cinq minutes ; le second reprend exactement la référence, la quantité et le jeton. Toute modification intermédiaire invalide la confirmation.

Configuration MCP

{
  "mcpServers": {
    "carrefour-drive": {
      "command": "node",
      "args": ["/chemin/absolu/carrefour-drive-mcp/dist/mcp/server.js"],
      "env": {
        "CAMOFOX_URL": "http://127.0.0.1:9377",
        "CAMOFOX_USER_ID": "carrefour-drive-personal",
        "CAMOFOX_AUTH_MODE": "required",
        "CAMOFOX_API_KEY": "référence-vers-votre-secret-local",
        "CARREFOUR_STORE_ID": "4370",
        "CARREFOUR_STORE_NAME": "Mon Carrefour Drive"
      }
    }
  }
}

Préférez le gestionnaire de secrets du client MCP à une clé écrite en clair dans sa configuration.

Validation

npm run verify

Cette commande exécute le typage, les tests client et MCP avec le SDK officiel, l’audit de confidentialité et l’inspection du paquet npm.

Statut juridique

Projet non officiel, sans affiliation ni approbation de Carrefour. N’utilisez que votre propre compte, votre propre session et votre propre panier, dans le respect des conditions du fournisseur.