- MCP (Model Context Protocol) est un standard ouvert qui permet aux applications d’IA d’appeler des outils sur d’autres services, afin qu’un assistant puisse répondre à partir des données réelles de votre boutique.
- Ask AI de ROASaurus et le serveur MCP de ROASaurus partagent 24 outils en lecture seule, du bénéfice, de l’attribution et de la valeur client aux coûts, aux leads, aux abonnements, au modèle de mix marketing et aux anomalies.
- Une application d’IA se connecte en s’identifiant sur ROASaurus via OAuth, ou avec une clé API dans un en-tête Authorization.
- Une clé nommée avec le seul scope mcp ne peut que lire ; la clé Orders API peut aussi envoyer des commandes : gardez donc toute clé secrète et révoquez-la en cas de fuite.
- Les périodes sont fixes (aujourd’hui, hier, ou les 7, 14, 30 ou 90 derniers jours), et Ask AI autorise 40 questions par utilisateur et par jour par défaut.
Un serveur MCP Shopify relie les données de votre boutique à un assistant IA via le Model Context Protocol (MCP). Vous posez une question en langage naturel, comme « Quelle campagne a généré le plus de bénéfice le mois dernier ? », et l’assistant répond à partir des chiffres réels de votre boutique plutôt que de mémoire. ROASaurus exécute un serveur MCP avec 24 outils d’analyse en lecture seule, et ces mêmes outils alimentent Ask AI dans le tableau de bord.
Ce guide explique ce qu’est MCP, pourquoi poser des questions d’analyse de cette façon est utile, comment fonctionnent Ask AI et le serveur MCP, comment connecter un client, quelles questions fonctionnent bien, et ce que vous devez savoir sur la confidentialité, la sécurité et les limites.
Qu’est-ce que MCP ?
MCP est un standard open source pour connecter des applications d’IA à des systèmes externes. Une application d’IA comme Claude est le client. Un service qui propose des données ou des actions est le serveur. Le serveur décrit ses outils : chaque outil a un nom, une description et un schéma pour ses entrées.
Quand vous posez une question, le client demande au serveur quels outils existent (tools/list). Le modèle choisit l’outil adapté et le client l’appelle (tools/call). Le résultat retourne au modèle, qui rédige la réponse. Vous n’avez pas besoin de connaître les noms des outils. Vous posez seulement la question.
Shopify exploite aussi des serveurs MCP. Ils se concentrent sur les agents d’achat et les développeurs : recherche de produits, paniers, checkout, comptes clients et documentation développeur. Un serveur MCP d’analyse répond à un autre type de question : le bénéfice après publicité, l’attribution et la valeur client, calculés à partir de vos commandes, de vos coûts et des dépenses de vos comptes publicitaires.
Pourquoi interroger les données de votre boutique dans un assistant IA ?
La plupart des questions sur une boutique demandent des chiffres issus de plusieurs rapports. « Meta a-t-il gagné de l’argent le mois dernier ? » demande le chiffre d’affaires, les coûts produit, l’expédition, les frais et les dépenses publicitaires au même endroit. Dans un tableau de bord, vous ouvrez le bon rapport, réglez les dates et faites le calcul. Dans un assistant IA connecté à vos données, vous posez la question et obtenez la réponse avec les chiffres qui la fondent.
- Un langage courant. Pas de filtres, de générateurs de rapports ni de formules de tableur.
- Des questions de suivi. Demandez « et pour TikTok ? » ou « quelle campagne a causé cela ? » sans repartir de zéro.
- Plusieurs rapports dans une réponse. Le bénéfice, l’attribution et la valeur client peuvent être combinés dans une seule réponse.
- Dans votre langue. Ask AI répond dans la langue dans laquelle vous écrivez.
- À côté de votre autre travail. Via MCP, les chiffres de la boutique sont disponibles dans l’application d’IA où vous rédigez déjà vos comptes rendus ou vos plans.
La réponse n’est aussi complète que les données qui la fondent. Connectez d’abord le suivi côté serveur, vos comptes publicitaires et vos coûts produit, pour que les outils disposent de commandes, de dépenses et de marges.
Comment fonctionnent Ask AI et le serveur MCP de ROASaurus ?
Ask AI est une page de chat dans le tableau de bord ROASaurus. Il fonctionne avec Claude, le modèle d’Anthropic. Le serveur MCP propose les mêmes 24 outils au client IA de votre choix. Dans les deux cas, les outils lisent vos rapports ROASaurus et renvoient les chiffres en JSON. Le modèle rédige la réponse à partir de ces résultats.
Chaque outil d’analyse ne fait que lire. Aucun outil ne peut modifier votre boutique, vos campagnes, vos coûts ou vos paramètres. Le serveur MCP marque chacun d’eux en lecture seule et demande au client de répondre uniquement à partir des résultats des outils. Une clé avec le scope actions:write dispose aussi de propose_action, qui ajoute une modification publicitaire proposée à la boîte de réception Actions ; rien ne change tant qu’un propriétaire ou un administrateur ne l’a pas approuvée. Ask AI, dans le tableau de bord, en dispose aussi.
Dans Ask AI, une question peut utiliser jusqu’à 8 tours d’appels d’outils. Si une question en demande plus, l’assistant vous demande d’être plus précis. Ask AI conserve votre conversation par utilisateur et par boutique, et utilise les 12 derniers messages comme contexte pour une question de suivi. Vous pouvez effacer la conversation à tout moment.
Quelles questions pouvez-vous poser ?
Les bonnes questions nomment une métrique et l’une des périodes prises en charge. Le tableau montre des exemples de questions, l’outil qui répond à chacune, et sur quoi repose la réponse.
| Question | Outil | Ce que montre la réponse |
|---|---|---|
| Comment les 7 derniers jours se comparent-ils aux 7 jours précédents ? | profit_summary | Chiffre d’affaires, commandes, dépenses publicitaires, MER, POAS et bénéfice, par rapport à la période précédente de même durée |
| Quelle campagne a eu le meilleur POAS sur les 30 derniers jours ? | campaign_profit | Par campagne : chiffre d’affaires attribué, bénéfice brut, dépenses publicitaires, bénéfice après publicité, ROAS, POAS et CAC |
| Quelles publicités ont un CPM élevé et peu d’achats ? | ads_table | Dépenses, impressions, clics, CTR et CPM à côté des achats suivis, du ROAS et du CPA |
| Combien de mois une cohorte met-elle à rembourser son CAC ? | ltv_insights | Cohortes mensuelles, mois de récupération du CAC et LTV prévisionnelle |
| Quels produits ramènent le plus de clients récurrents ? | products | Produits les plus vendus et part des primo-acheteurs qui ont recommandé |
| Sommes-nous sur la bonne voie pour l’objectif de chiffre d’affaires de ce mois ? | goals_forecast | Objectifs, réalisé à ce jour et prévision de fin de mois |
| Que devrais-je réapprovisionner cette semaine ? | inventory | Stock disponible, vitesse de vente, jours de stock restants et statut de réapprovisionnement |
Voici un exemple concret. Vous demandez : « Meta a-t-il gagné de l’argent ces 30 derniers jours ? » Le modèle appelle campaign_profit avec la période réglée sur 30 jours et le modèle par défaut du dernier clic. Pour une boutique d’exemple, la ligne Meta du résultat ressemble à ceci :
| Ligne | Meta, 30 derniers jours | Comment c’est calculé |
|---|---|---|
| Chiffre d’affaires attribué | $24,000 | Chiffre d’affaires des commandes attribuées aux clics Meta |
| Bénéfice brut (contribution dans le résultat) | $13,440 | Chiffre d’affaires moins coût produit, expédition, frais de paiement et manutention (56%) |
| Dépenses pub | $8,000 | Synchronisé depuis le compte publicitaire Meta |
| Bénéfice après publicité | $5,440 | $13,440 − $8,000 |
| ROAS | 3.00 | $24,000 ÷ $8,000 |
| POAS | 1.68 | $13,440 ÷ $8,000 |
Dans Ask AI, la réponse commence par « Oui », puis donne le bénéfice après publicité et le POAS, et propose au maximum trois prochaines étapes. Si vous voulez un autre angle, posez une question de suivi comme « et avec le modèle Total Impact ? ». Nos guides sur le POAS et les modèles d’attribution expliquent ces chiffres plus en détail.
Comment connecter le serveur MCP de ROASaurus ?
Le serveur utilise le transport Streamable HTTP de MCP et renvoie des réponses JSON, sans server-sent events. Les applications d’IA comme Claude et ChatGPT se connectent via OAuth : vous vous identifiez sur ROASaurus, choisissez une boutique et autorisez la connexion. Les clients qui permettent de définir un en-tête de requête, comme Claude Code, peuvent utiliser une clé API à la place, comme dans les étapes ci-dessous.
- Créez une clé API
Ouvrez Store settings › API & data dans ROASaurus et créez une clé nommée avec le scope
mcp. Copiez-la : elle n’est affichée qu’une seule fois. Seuls les propriétaires et les administrateurs peuvent créer des clés. - Ou réutilisez la clé Orders API
Vous pouvez aussi utiliser la clé de la carte Orders API, par exemple celle qu’utilise le plugin WooCommerce. Cette clé peut aussi envoyer des commandes. Regenerate API key la remplace et déconnecte tout ce qui utilise l’ancienne.
- Notez la clé de la boutique
Une clé nommée se place seule dans l’en-tête. Avec la clé Orders API, ajoutez la clé de boutique : la valeur
X-Roasaurus-Keysur la même carte, dont la section MCP affiche l’en-tête complet. - Ajoutez le serveur à votre client MCP
Saisissez le point de terminaison et l’en-tête Authorization indiqués ci-dessous. Le client doit prendre en charge Streamable HTTP et les en-têtes de requête personnalisés.
- Posez une question de test
Demandez « Quel était mon chiffre d’affaires hier ? » et comparez le chiffre avec votre tableau de bord.
# Endpoint POST https://app.roasaurus.com/mcp Authorization: Bearer <named key with the mcp scope> # or, with the Orders API key Authorization: Bearer <store key>:<API key> # Claude Code claude mcp add --transport http roasaurus https://app.roasaurus.com/mcp \ --header "Authorization: Bearer <named key with the mcp scope>"
Vous pouvez aussi envoyer la clé de la boutique dans un en-tête X-Roasaurus-Key et seulement la clé API comme jeton bearer. Dans Claude Code, gardez la portée locale par défaut. Un serveur à portée de projet est enregistré dans un fichier .mcp.json partagé via le contrôle de version, ce qui partagerait votre clé.
Pour vous identifier plutôt, ajoutez https://app.roasaurus.com/mcp comme connecteur personnalisé dans Claude ou ChatGPT et connectez-vous quand l’application le demande. Seuls les propriétaires et les admins peuvent autoriser une connexion. Store settings › API & data liste chaque application connectée, que vous pouvez y déconnecter, et une connexion prend aussi fin quand cette personne quitte l’espace de travail.
initialize · 2025-06-18Le client et le serveur s’accordent sur la version du protocoletools/list · 24 tools · readOnlyHint: trueLe client découvre quels outils existenttools/call · campaign_profit · period 30Le modèle demande 30 jours de bénéfice par campagneresult · isError: falseJSON avec une ligne par canal et par campagne401 · Invalid store key or API key.Ce que renvoie une clé erronée ou régénéréeEst-ce sûr ? Confidentialité et sécurité
Comme les outils d’analyse ne font que lire, une application d’IA ne peut pas mettre une campagne en pause, modifier un coût ou changer un paramètre via ROASaurus ; avec actions:write, elle peut seulement proposer une modification publicitaire à faire approuver par un propriétaire ou un administrateur. Les outils n’acceptent par ailleurs que des entrées fixes, comme une période ou un modèle d’attribution choisi dans une liste. Quelques points demandent tout de même de la vigilance.
- Où vont les données. Ask AI envoie votre question et des métriques agrégées de la boutique à Anthropic, qui exploite Claude. Il n’envoie aucune coordonnée de vos clients. Via MCP, les résultats des outils vont au client d’IA que vous connectez, selon les conditions de ce client. Vérifiez ses réglages de conservation des données et d’entraînement.
- Ce que renvoient les outils. Des totaux par période, canal, campagne, publicité, produit, cohorte et segment. Ils ne renvoient ni noms de clients, ni adresses e-mail, ni numéros de téléphone.
- Qui peut poser des questions. Toute personne ayant accès à l’application d’IA où vous ajoutez la connexion peut interroger la boutique. Ajoutez-la à votre propre compte, pas à un compte partagé.
- Les autres connecteurs. La spécification MCP indique qu’il doit toujours y avoir un humain dans la boucle capable de refuser les appels d’outils, et que les clients doivent traiter les annotations d’outils comme non fiables, sauf si le serveur est de confiance. Si votre application d’IA dispose aussi d’outils qui envoient des e-mails ou publient des messages, gardez les demandes de confirmation activées pour ces outils.
Quelles sont les limites ?
- Des périodes fixes. Aujourd’hui, hier, ou les 7, 14, 30 ou 90 derniers jours, dans le fuseau horaire de la boutique. Une plage personnalisée, comme une semaine de mars, n’est pas prise en charge. Les outils de valeur client et de cohortes n’ont pas de période : ils travaillent à partir de l’historique de vos commandes, avec jusqu’à 12 cohortes mensuelles.
- Une fenêtre de 7 jours pour le tableau des publicités. L’outil des publicités utilise une fenêtre d’attribution de 7 jours, quelle que soit la fenêtre définie dans Store settings. Les outils d’attribution et de bénéfice par campagne, comme les rapports d’attribution du tableau de bord, utilisent votre propre réglage ou la fenêtre que vous demandez.
- Des listes raccourcies. Les listes de campagnes renvoient au plus 25 campagnes, le tableau des publicités les 30 lignes qui dépensent le plus, et la liste des produits les 25 premiers produits.
- Une boutique par connexion. Pour plusieurs boutiques, créez une clé et une connexion pour chacune.
- La limite de questions d’Ask AI. Chaque utilisateur peut poser 40 questions par jour par défaut, comptées sur les dernières 24 heures. Via MCP, ce sont les limites d’usage propres à votre client d’IA qui s’appliquent.
- Les réponses peuvent être fausses. Le modèle peut mal lire un résultat. Vérifiez les chiffres importants dans les rapports avant d’agir, par exemple dans l’analyse du bénéfice.
Sources
- Model Context Protocol: What is the Model Context Protocol (MCP)?
- Model Context Protocol specification (2025-06-18): Tools
- Claude Code Docs: Connect Claude Code to tools via MCP
- Claude Docs: Authentication for connectors
- OpenAI: Building MCP servers for plugins and API integrations