1Vue 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.
L'authentification est automatique : votre client MCP vous redirige vers la page de connexion Circlee lors de la première utilisation.
2Installation et configuration
2.1. Prérequis
- Un compte client sur une 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 la boutique :
https://mcp.circlee.fr/nom-de-la-boutiqueL'authentification se fait automatiquement via OAuth : votre client MCP vous redirigera vers la page de connexion Circlee lors de la première utilisation.
Exemple de configuration pour Claude Desktop (claude_desktop_config.json) :
{
"mcpServers": {
"circlee": {
"type": "url",
"url": "https://mcp.circlee.fr/nom-de-la-boutique"
}
}
}3Outils disponibles
3.1. Catalogue (accès public)
browse_menu: Parcourir les produits du restaurant avec pagination et filtragesearch_menu: Rechercher des produits par mots-clésget_product_details: Obtenir les détails complets d'un produit (options, images, prix)browse_categories: Lister les sections du menu
3.2. Prise de commande (authentification requise)
order_wizard: Assistant guidé pour passer une commande complète étape par étapecheck_availability: Vérifier les créneaux de livraison et retraitcheck_product_availability: Vérifier la disponibilité des produitscreate_order: Passer une commande avec produits, créneaux et méthode de paiementlist_customer_orders: Historique des commandesget_customer_order: Détail d'une commande
3.3. Compte client (authentification requise)
get_my_profile: Consulter son profil clientupdate_my_profile: Modifier ses informations personnelleslist_my_addresses: Lister ses adresses de livraisoncreate_address: Créer une adresse de livraisonupdate_address: Modifier une adresse existantedelete_address: Supprimer une adresse
4Dé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
Problèmes de connexion au serveur
- Vérifiez que l'URL de la boutique est correcte (format :
https://mcp.circlee.fr/nom-de-la-boutique) - Vérifiez votre connexion internet et que le serveur est accessible
- Essayez de redémarrer votre client MCP
Le menu ou les commandes ne se chargent pas
- Vérifiez que le nom de la boutique dans l'URL est correct
- Assurez-vous que la boutique est active sur la plateforme Circlee
- Essayez de vous reconnecter en relançant le flux d'authentification
5Conditions 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.
Vous êtes restaurateur ? Découvrez comment gérer votre boutique par IA.
Contactez-nous
Pour toute question, vous pouvez nous contacter via le formulaire de contact accessible en cliquant ici.