Ressources

Référence des outils MCP WareRushAI

Les outils de lecture et d'écriture du serveur MCP WareRushAI, leurs portées d'autorisation (scopes) et ce qu'ils renvoient ou modifient.

Revised:

1. get_account_info (portée account.read)

Renvoie l'entreprise de l'utilisateur connecté, son rôle, son forfait d'abonnement et les modules activés. Les assistants l'appellent en premier lieu pour identifier l'entité dont ils analysent les données.

2. list_warehouses (portée inventory.read)

Répertorie les entrepôts et emplacements de l'entreprise et indique ceux qui sont associés à un emplacement Shopify.

3. search_products (portée catalog.read)

Recherche des produits par nom, SKU, code-barres, marque ou modèle, et renvoie une ligne synthétique par produit avec son prix, sa catégorie et son stock. Les résultats sont paginés ; utilisez get_product pour consulter la fiche complète.

4. get_product (portée catalog.read)

Renvoie les données d'un produit, son stock par emplacement et son statut de publication sur les marketplaces.

5. get_inventory_summary (portée inventory.read)

Renvoie la quantité totale de stock par emplacement, permettant ainsi à un assistant d'indiquer le volume de stock détenu par l'entreprise dans chaque entrepôt.

6. find_missing_product_data (portée catalog.read)

Recherche les produits auxquels il manque des données requises pour la vente (image, prix, catégorie, description, code-barres et éléments similaires) et précise ce qui fait défaut. Les résultats sont paginés.

7. find_listing_problems (portée catalog.read)

Recherche les produits qui n'ont pas été mis en vente sur une marketplace ou un canal et explique l'erreur avec une solution formulée simplement, par exemple un EAN manquant requis par la catégorie Allegro.

8. find_unfulfilled_orders (portée orders.read)

Liste les commandes ouvertes de boutiques en ligne, de marketplaces et B2B qui n'ont pas encore été expédiées, avec leur source, leur partenaire et leur statut.

9. search_categories (portée catalog.read)

Recherche dans l'arborescence des catégories de produits par nom et renvoie les identifiants et chemins de catégorie ; update_product utilise l'identifiant pour définir une catégorie.

10. Fonctionnement des outils d'écriture

Les outils d'écriture nécessitent la portée catalog.write ou inventory.write et un rôle de propriétaire ou d'administrateur. Chacun fonctionne en deux étapes : avec confirm=false, il renvoie seulement un aperçu des anciennes et nouvelles valeurs ; avec confirm=true et expected_version (la version du produit issue de l'aperçu ou de get_product), il enregistre. Si le produit a changé entre-temps, l'enregistrement est refusé. Un appel modifie un produit, chaque modification est journalisée avec l'origine mcp et rien ne peut être supprimé.

11. update_product (portée catalog.write)

Modifie le nom, la description, la marque, le type, la catégorie, le code-barres, le SKU, le prix de vente ou le statut (actif ou brouillon) d'un produit. Un prix défini ici compte comme un prix manuel que l'IA en arrière-plan n'écrase jamais. Le SKU se modifie dans un appel séparé.

12. adjust_stock (portée inventory.write)

Définit, ajoute ou retire du stock d'un produit sur un site via le mouvement de stock habituel, de sorte que le journal des mouvements et la synchronisation du stock avec Shopify sont aussi mis à jour.

13. set_channel_listing (portée catalog.write)

Active, désactive ou remet à la règle du canal un produit sur une marketplace ou un canal. Les produits d'occasion, reconditionnés ou endommagés ne peuvent jamais être activés sur les canaux qui n'acceptent que des produits neufs (eMAG, Árukereső, Árgép, Pepita).

14. create_product (portée catalog.write)

Crée un nouveau produit à partir d'un code-barres ou d'un nom, éventuellement avec un stock initial sur un site. L'IA en arrière-plan l'identifie et complète le reste dans la limite habituelle de 5 appels IA au maximum par produit ; un code-barres existant n'est jamais dupliqué.