Utiliser le point de connexion et le parcours OAuth documentés​

Le point de connexion MCP est https://mcp.madabina.com/mcp. Les métadonnées de ressource protégée sont publiées à https://mcp.madabina.com/.well-known/oauth-protected-resource et le serveur d’autorisation est https://madabina.com.

Configurez un client compatible avec Streamable HTTP et la découverte OAuth. Le marchand autorise la connexion depuis le parcours du client. Ne collez pas un jeton marchand dans une configuration partagée et ne considérez pas l’URL du serveur comme une autorisation suffisante.

Demander uniquement les accès nécessaires​

Les permissions documentées séparent la lecture, l’écriture des produits, l’écriture des commandes et les opérations destructives. Demandez uniquement les permissions nécessaires à la fonctionnalité. La suppression d’un produit et l’annulation d’une commande nécessitent la permission destructive; une intégration en lecture seule ne devrait pas la demander.

L’accès reste associé au compte marchand autorisé et à la boutique sélectionnée. Affichez ce contexte dans l’intégration et ne supposez pas qu’un marchand ne possède qu’une boutique.

Traiter les écritures avec prudence​

Les écritures MCP nécessitent une clé d’idempotence au format UUID. Si une mutation expire, ne la relancez pas automatiquement avec une nouvelle clé : suivez les consignes à jour du serveur et réutilisez la même clé lorsque vous retentez la même opération.

Ne stockez pas les jetons dans les journaux ou le code source. Si l’autorisation échoue, vérifiez la découverte OAuth du client et la documentation officielle au lieu d’insérer manuellement des identifiants.

Consulter les outils et permissions à jour​

La liste des outils et des permissions peut évoluer. Avant de livrer une intégration, consultez le guide du serveur MCP Madabina pour les métadonnées, permissions et effets des mutations en vigueur.

Utilisez cette checklist lorsque vous ajoutez ou modifiez un produit dans votre boutique Madabina.

Choisir un nom précis​

Nommez l’article avec des mots que vos clients reconnaîtront. Ajoutez un modèle, une matière ou une taille s’ils permettent de distinguer le produit. Évitez de répéter des expressions de recherche dans le titre; ajoutez plutôt les détails utiles dans la description.

Ajouter des images qui montrent le produit​

Choisissez des images nettes, fidèles au produit et qui montrent les détails utiles à l’évaluation. Gardez un cadrage cohérent pour les articles similaires. Si une couleur ou une variante change, utilisez une image qui rend cette différence visible.

Expliquer les caractéristiques utiles​

Décrivez le produit en termes simples. Précisez la matière, les dimensions, la compatibilité, les conseils d’entretien ou les autres faits importants pour cet article. Distinguez les caractéristiques confirmées des estimations et supprimez les informations qui ne sont plus valables.

Vérifier le prix et la disponibilité​

Contrôlez le prix affiché et le stock avant de rendre le produit visible. Si l’article a des variantes, vérifiez le prix, le stock et la visibilité de chaque option. Mettez la fiche à jour si le produit est temporairement indisponible ou si ses détails changent.

Relire les langues et la catégorie​

Madabina prend en charge les textes produit en français, anglais et arabe. Ajoutez les versions que vous voulez afficher et relisez-les dans la boutique publique. Choisissez une catégorie qui décrit bien l’article pour faciliter la navigation.

Prévisualiser la page publique​

Ouvrez la fiche comme un client. Vérifiez sur téléphone que le nom, les images, la description, le prix et la disponibilité sont faciles à repérer. Contrôlez le formulaire de commande et confirmez que les informations correspondent au produit proposé.

Pour le parcours marchand détaillé, consultez le guide Madabina des produits et du stock. Vous pouvez ensuite créer votre boutique Madabina.

Commencer par le contrat API​

L’URL de base de production est https://madabina.com/api/v1. La référence API interactive et le document OpenAPI font autorité pour les routes disponibles et les schémas de requête.

La documentation décrit l’authentification marchande et les ressources accessibles au compte authentifié. Les routes privées nécessitent un jeton Bearer valide et les ressources sont limitées aux boutiques que le marchand authentifié peut gérer.

Garder les identifiants hors du code client​

Suivez le parcours d’authentification documenté pour obtenir un jeton. Envoyez les jetons d’accès dans l’en-tête Authorization: Bearer … sur HTTPS. Conservez les identifiants et les jetons côté serveur dans un stockage adapté; ne les ajoutez pas au dépôt, à un bundle navigateur ou aux journaux.

Avant d’implémenter le renouvellement du jeton, la déconnexion ou une mutation, vérifiez les champs et comportements exacts dans la référence à jour. Ils font partie du contrat de l’API et peuvent évoluer.

Réaliser une première requête limitée​

Choisissez une opération de lecture dans la référence et essayez-la avec un compte marchand de test. Traitez les réponses de succès et d’erreur documentées, gérez les identifiants invalides ou expirés et ne supposez pas que toutes les réponses ont la même forme. Ajoutez des écritures seulement après avoir vérifié leurs validations et leurs effets.

Vérifier le contexte de boutique et les effets​

Concevez l’intégration autour du compte marchand et de la boutique concernés. Avant d’automatiser un changement de statut, une annulation ou une modification de stock, vérifiez les effets décrits. Par exemple, le guide marchand indique qu’une annulation de commande peut restaurer le stock lorsque c’est applicable et ne supprime pas définitivement son enregistrement.

Continuer avec les références officielles​

• Guide de l’API REST Madabina
• Référence API interactive
• Spécification OpenAPI JSON

Le blog présente le parcours d’intégration; la référence API décrit les routes, paramètres et réponses exacts.

Créer une boutique en ligne demande plus que de mettre un site en ligne. Avant d’inviter des clients, vérifiez qu’ils comprennent votre offre, peuvent passer commande et voient les options de livraison disponibles.

Cette checklist porte sur la préparation de la boutique et le parcours client. L’immatriculation, la fiscalité, la couverture des transporteurs et les autres obligations commerciales dépendent de votre situation : consultez les autorités et prestataires concernés pour obtenir des informations à jour.

1. Définir votre offre​

Précisez à qui s’adressent vos produits, quel besoin ils couvrent et quels articles seront disponibles au lancement. Un catalogue de départ ciblé est souvent plus simple à présenter et à tenir à jour qu’une grande collection incomplète.

Décidez comment vous fixerez les prix, suivrez la disponibilité, répondrez aux questions et traiterez une commande impossible à honorer. Ces décisions vous aident à préparer les informations dont les clients ont besoin avant de commander.

2. Préparer des fiches produit claires​

Pour chaque article, préparez un nom, un prix, une description utile, des images et une disponibilité à jour. Expliquez les choix importants comme la taille ou la couleur lorsqu’ils existent. Si vos clients utilisent plusieurs langues, préparez les textes dans les langues que vous souhaitez afficher.

Les vendeurs Madabina peuvent gérer les détails des produits, leurs traductions, le stock et la visibilité de la boutique. Consultez le guide des produits et du stock pour connaître le parcours actuel.

3. Rendre le parcours de commande compréhensible​

Parcourez la boutique comme un client. Les informations produit doivent être faciles à trouver, le formulaire doit demander les éléments nécessaires au traitement de la commande et le total doit être visible avant l’envoi.

Effectuez une commande de test avant de partager le lien. Vérifiez qu’elle apparaît dans le bon espace marchand et que la confirmation présentée au client est claire.

4. Configurer les options de livraison que vous pouvez assurer​

Configurez les destinations et méthodes que votre activité est prête à servir. Vérifiez les frais et les choix proposés pour chaque destination. Les options dépendent des réglages de la boutique; testez donc plusieurs destinations si vous servez différentes zones.

Le guide de configuration de la boutique et de la livraison détaille les réglages marchands.

5. Lancer, puis améliorer une étape à la fois​

Partagez d’abord la boutique avec un petit public. Repérez les questions fréquentes et les étapes qui posent problème, puis améliorez les informations produit ou de livraison qui manquent de clarté. Gardez les stocks et les réglages de livraison à jour.

Checklist de lancement​

• Les noms, prix, images et disponibilités ont été vérifiés.
• Les informations de la boutique et les langues sont correctes.
• Les destinations, méthodes et frais correspondent à ce que vous pouvez assurer.
• Une commande de test a été passée et vérifiée.
• Les clients savent comment contacter la boutique en cas de question.

Créer un compte marchand Madabina pour commencer à préparer votre boutique.