🔥 La checklist : les 10 règles d'or du Fast Food qui cartonne

🔥 10 règles d'or du Fast Food

Documentation/Gérer son restaurant par IA
Documentation

Gérer son restaurant par IA

Pilotez votre boutique Circlee avec un assistant IA : commandes, menu, promotions et statistiques.

27/03/2026

Exemples d'utilisation

Consulter les statistiques

"Combien de commandes aujourd'hui ? Quel est le chiffre d'affaires ?"

L'IA consulte get_order_statistics et vous présente un résumé clair de votre activité.

Gérer le menu

"Ajoute un nouveau burger à 12€ dans la catégorie Burgers"

L'IA utilise create_product pour ajouter le produit directement à votre carte.

Suivre les commandes

"Quelles commandes sont en attente ?"

L'IA consulte list_orders et vous permet de changer le statut via update_order_status.



1. Vue d'ensemble

Le serveur MCP Circlee implémente le Model Context Protocol pour connecter des clients IA (Claude Desktop, Claude Code, ou tout client compatible MCP) à la plateforme Circlee.

En tant qu'administrateur, vous accédez à l'ensemble des outils de gestion : commandes, menu, promotions, statistiques et configuration de votre boutique.

L'authentification est automatique : votre client MCP vous redirige vers la page de connexion Circlee lors de la première utilisation.


2. Installation et configuration

2.1. Prérequis

  • Un compte administrateur sur votre boutique Circlee
  • Un client MCP compatible (Claude Desktop, Claude Code, etc.)

2.2. Configuration

Connectez votre client MCP au serveur Circlee en utilisant l'URL de votre boutique :

https://mcp.circlee.fr/votre-boutique

L'authentification se fait automatiquement via OAuth : votre client MCP vous redirigera vers la page de connexion Circlee lors de la première utilisation. Connectez-vous avec votre compte administrateur pour accéder à tous les outils de gestion.

Exemple de configuration pour Claude Desktop (claude_desktop_config.json) :

{
  "mcpServers": {
    "circlee": {
      "type": "url",
      "url": "https://mcp.circlee.fr/votre-boutique"
    }
  }
}

3. Outils disponibles

3.1. Gestion des commandes

  • list_orders — Lister les commandes de la boutique avec filtrage par date et statut
  • update_order_status — Modifier le statut d'une commande (accepter, refuser, prêt, etc.)
  • get_order_statistics — Statistiques agrégées (nombre, CA, panier moyen)
  • get_statistics_by_period — Statistiques par jour, mois ou année

3.2. Gestion du menu

Produits :

  • list_products, search_products, get_product — Consultation des produits
  • create_product, update_product, delete_product — Gestion CRUD des produits
  • update_stock, increase_stock, decrease_stock — Gestion des stocks
  • update_product_visibility, reorder_products — Affichage et ordre des produits

Catégories :

  • list_categories, update_categories, delete_category

3.3. Promotions

  • list_promotions, create_promotion, update_promotion, delete_promotion

3.4. Configuration de la boutique

  • update_shop — Modifier les horaires, adresse, coordonnées
  • update_order_config — Activer ou désactiver la livraison, le retrait, etc.
  • list_banners, create_banner, update_banner, delete_banner — Gestion des bannières

3.5. Clients

  • list_clients — Afficher les meilleurs clients

3.6. Sécurité et confirmation

Les actions destructrices (suppression, désactivation) nécessitent une confirmation via un jeton à usage unique :

  • confirm_action — Confirmer l'exécution d'une action en attente

Les jetons de confirmation expirent après 5 minutes. Ce mécanisme empêche les actions destructrices accidentelles.


4. Ressources

Les ressources sont des données en lecture seule automatiquement injectées dans le contexte de l'assistant IA :

  • circlee://shop/profile — Profil de la boutique (nom, adresse, horaires, configuration)
  • circlee://shop/menu — Menu complet avec prix et stocks
  • circlee://shop/categories — Catégories du menu
  • circlee://shop/orders/today — Commandes du jour

5. Dépannage

Erreur : "401 Unauthorized"

  • Vérifiez que votre token d'accès n'a pas expiré (durée de vie : 1 heure)
  • Essayez de vous reconnecter pour obtenir un nouveau token via le flux OAuth
  • Assurez-vous que votre compte Circlee est actif et associé à une boutique

Les outils d'administration ne sont pas disponibles

Les outils d'administration nécessitent le rôle administrateur. Vérifiez que vous êtes connecté avec un compte ayant les droits d'administration sur votre boutique.

Erreur : "Jeton de confirmation expiré"

Les jetons de confirmation pour les actions destructrices expirent après 5 minutes. Si vous recevez cette erreur, relancez l'action pour obtenir un nouveau jeton, puis confirmez dans les 5 minutes.

Problèmes de connexion au serveur

  • Vérifiez que l'URL de votre boutique est correcte (format : https://mcp.circlee.fr/votre-boutique)
  • Vérifiez votre connexion internet et que le serveur est accessible
  • Essayez de redémarrer votre client MCP

6. Conditions d'utilisation

L'utilisation du serveur MCP Circlee est soumise à nos conditions d'utilisation de l'API, qui complètent nos conditions générales d'utilisation.



Contactez-nous

Pour toute question technique, vous pouvez nous contacter via le formulaire de contact accessible en cliquant ici.