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.
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.
2Installation 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-boutiqueL'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"
}
}
}3Outils disponibles
3.1. Gestion des commandes
list_orders: Lister les commandes de la boutique avec filtrage par date et statutupdate_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 produitscreate_product,update_product,delete_product: Gestion CRUD des produitsupdate_stock,increase_stock,decrease_stock: Gestion des stocksupdate_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éesupdate_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.
4Ressources
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 stockscirclee://shop/categories: Catégories du menucirclee://shop/orders/today: Commandes du jour
5Dé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
6Conditions 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 client ? Découvrez comment commander par IA.
Contactez-nous
Pour toute question technique, vous pouvez nous contacter via le formulaire de contact accessible en cliquant ici.