Connecter un assistant IA (MCP)

Zimam fait tourner un serveur MCP (Model Context Protocol) pour votre boutique. Tout assistant IA compatible MCP, dont Claude, peut s'y connecter et répondre à des questions comme « montre-moi les commandes en attente du jour » ou « quels produits sont presque en rupture ? ». Avec l'accès en écriture, l'assistant peut aussi modifier des commandes et des produits et envoyer des commandes à un transporteur.

L'adresse du serveur est :

https://api.getzimam.com/mcp

Les données de vos clients

Une fois connecté, l'assistant lit les noms, numéros de téléphone et adresses de livraison de vos clients. Ces données partent vers le fournisseur d'IA configuré dans votre propre client MCP, en dehors de Zimam, et Zimam ne contrôle pas ce que ce fournisseur en fait. Avant de vous connecter, vous devez confirmer : « Je comprends que les noms, numéros de téléphone et adresses de livraison des clients seront envoyés au fournisseur d'IA configuré dans mon propre client MCP, en dehors de Zimam. »

Se connecter par identification (OAuth)

Utilisez cette méthode quand votre client MCP peut ajouter un serveur distant par son URL et vous identifier.

1. Dans votre client MCP, ajoutez un serveur MCP distant ou un connecteur avec l'adresse ci-dessus.
2. Quand le client ouvre Zimam, connectez-vous avec votre compte Zimam.
3. Sur Connecter un assistant IA, choisissez la Boutique.
4. Sous Accès demandé, gardez ou décochez chaque autorisation demandée par le client.
5. Cochez l'avertissement sur les données des clients.
6. Cliquez sur Autoriser l'accès, ou sur Refuser.

Se connecter avec un jeton

Utilisez cette méthode quand votre client MCP accepte un en-tête HTTP personnalisé.

1. Ouvrez Paramètres de la boutique, puis l'onglet MCP, où vous trouvez Jetons d'accès MCP.
2. Cliquez sur Créer un jeton et donnez-lui un Nom.
3. Sous Accès, choisissez les autorisations. Les autorisations d'écriture sont sous Accès en écriture.
4. Cochez l'avertissement sur les données des clients et créez le jeton.
5. Cliquez sur Copier le jeton. Il n'est affiché qu'une seule fois.
6. Dans votre client MCP, envoyez-le dans l'en-tête Authorization: Bearer suivi du jeton.

Autorisations

Autorisation	Offre
Lire les commandes, Lire les produits, Lire les statistiques, Lire le statut de livraison	Toutes les offres
Créer et modifier des commandes, Créer et modifier des produits, Assigner la livraison des commandes	Growth, Pro et Enterprise

Sur les autres offres, les autorisations d'écriture affichent « Non inclus dans votre offre actuelle. Passez à une offre supérieure pour l'autoriser. » Si votre boutique passe plus tard à une offre sans écriture, les actions d'écriture de l'assistant sont refusées et son accès en lecture continue de fonctionner.

Un jeton ou une application n'a jamais plus d'accès que l'utilisateur Zimam qui l'a créé. Si cet utilisateur perd l'accès à la boutique, le jeton cesse de fonctionner.

Ce que l'assistant peut faire

• Lecture : lister et rechercher des commandes, ouvrir une commande, lister et ouvrir des produits, lire les statistiques de la boutique et par région, lire le statut de livraison.
• Commandes : ajouter une note, confirmer une commande en attente, changer le statut d'une commande, modifier le nom, le téléphone, l'adresse et les notes du client.
• Produits : créer un produit (toujours créé non publié), modifier un produit, mettre à jour le stock, publier ou dépublier un produit.
• Livraison : envoyer une commande à une société de livraison.

Actions qui demandent votre confirmation

Changer le statut d'une commande, modifier une commande, modifier un produit, publier ou dépublier un produit et envoyer une commande à un transporteur se font en deux étapes. L'assistant reçoit d'abord un aperçu du changement et vous le montre. Il n'applique le changement que s'il revient avec exactement ce changement dans les 5 minutes. Si quoi que ce soit diffère de l'aperçu, le changement est refusé.

Ajouter une note, confirmer une commande en attente, mettre à jour le stock et créer un produit non publié se font directement.

Limites

• 30 requêtes toutes les 10 secondes par boutique. Au-delà, l'assistant est invité à patienter et à réessayer.
• 10 envois à un transporteur par minute et par boutique.

Révoquer l'accès

Dans Jetons d'accès MCP :

• Cliquez sur Révoquer à côté d'un jeton pour l'arrêter immédiatement.
• Sous Applications connectées, cliquez sur Révoquer à côté d'une application. Elle est déconnectée partout et tous les jetons qu'elle a reçus sont invalidés. Les autres applications ne sont pas touchées.

Si l'assistant signale que son jeton est invalide ou expiré, reconnectez-le.