Serveur MCP
Principes de base
Le serveur MCP de Snipcart vous permet de gérer votre boutique en langage naturel à l'aide d'assistants IA comme Claude, GPT (via Codex) ou tout client compatible MCP. Au lieu de naviguer manuellement entre les endpoints de l'API, vous décrivez ce dont vous avez besoin — « montre-moi les commandes de la semaine dernière », « crée un rabais de 15 % », « rembourse la commande X » — et l'IA s'occupe du reste.
Qu'est-ce que MCP? Le Model Context Protocol est un standard ouvert qui permet aux assistants IA d'interagir avec des outils et services externes. Voyez-le comme un pont entre votre assistant IA et votre boutique Snipcart.
Ce que vous pouvez faire
Le serveur MCP expose 38 outils couvrant tous les domaines principaux de votre boutique Snipcart :
- Commandes — Lister, consulter, mettre à jour le statut, envoyer des notifications, accéder aux produits numériques
- Clients — Rechercher, consulter les profils, mettre à jour les informations, gérer les comptes
- Produits — Parcourir le catalogue, mettre à jour les niveaux de stock, archiver des produits
- Rabais — Créer des codes de coupon, des déclencheurs par total du panier, des rabais en pourcentage ou à montant fixe
- Remboursements — Consulter et créer des remboursements
- Paniers abandonnés — Surveiller et analyser les paniers abandonnés
- Méthodes de livraison — Créer et gérer des tarifs de livraison personnalisés
- Domaines — Configurer les domaines de paiement autorisés
- Notes de commande — Ajouter et consulter des notes internes sur les commandes
Clients supportés
Le serveur MCP de Snipcart utilise le transport Streamable HTTP avec un en-tête personnalisé X-Snipcart-Api-Key pour l'authentification. Tout client MCP supportant les serveurs distants avec des en-têtes personnalisés peut se connecter.
| Client | Supporté | Notes |
|---|---|---|
| Claude Desktop | Oui | macOS et Windows |
| Claude Code | Oui | CLI et extensions IDE |
| Cursor | Oui | Via les paramètres MCP dans l'IDE |
| Windsurf | Oui | Via mcp_config.json |
| OpenAI Codex CLI | Oui | Via config.toml avec http_headers |
| GitHub Copilot | Oui | Via les paramètres du serveur MCP |
| ChatGPT (web) | Non | Supporte uniquement l'en-tête authorization, pas les en-têtes personnalisés |
| Claude.ai (web) | Non | Requiert OAuth 2.1, que Snipcart ne supporte pas |
Note : Tout client compatible MCP supportant le Streamable HTTP avec des en-têtes personnalisés devrait fonctionner. Si votre client n'est pas listé ici, consultez sa documentation pour la configuration de serveur MCP distant.
Comment ça fonctionne
Lorsque vous posez une question à votre assistant IA à propos de votre boutique, il envoie une requête au serveur MCP. Le serveur s'authentifie avec votre clé API privée Snipcart, appelle le endpoint approprié de l'API Snipcart et retourne le résultat dans un format structuré que l'IA interprète pour vous.
Vous (langage naturel)
→ Assistant IA (sélectionne le bon outil)
→ Serveur MCP (authentifie + appelle l'API Snipcart)
→ API Snipcart (retourne les données)
→ Serveur MCP (formate la réponse)
→ Assistant IA (explique les résultats)
→ Vous (réponse lisible)Pas de code, pas de commandes curl, pas de chemins d'endpoints à mémoriser. Il suffit de demander.
Notes importantes
- Le serveur MCP utilise votre clé API privée — la même clé que vous utiliseriez avec l'API REST. Gardez-la secrète.
- Toutes les requêtes passent par le serveur hébergé à
snipcart-mcp.azurewebsites.net. Vous pouvez aussi auto-héberger le serveur si vous le préférez. - Le serveur applique une limitation de débit pour protéger votre boutique et l'API Snipcart.
Prochaine étape : Installation — Connectez votre assistant IA à votre boutique en moins de 2 minutes.