Zdroje

Přehled MCP nástrojů WareRushAI

Nástroje serveru WareRushAI MCP pro čtení i zápis, jejich rozsahy oprávnění (scopes) a co vracejí nebo mění.

Revised:

1. get_account_info (rozsah account.read)

Vrací společnost přihlášeného uživatele, jeho roli, plán předplatného a aktivované moduly. Asistenti jej volají jako první, aby věděli, na čí data se dívají.

2. list_warehouses (rozsah inventory.read)

Vypíše sklady a lokace společnosti a uvede, které z nich jsou propojeny s lokací v Shopify.

3. search_products (rozsah catalog.read)

Vyhledává produkty podle názvu, SKU, čárového kódu, značky nebo modelu a vrací stručný řádek ke každému produktu s cenou, kategorií a stavem zásob. Výsledky jsou stránkované; pro úplný záznam použijte get_product.

4. get_product (rozsah catalog.read)

Vrací data jednoho produktu, jeho skladové zásoby podle jednotlivých lokací a stav zalistování na marketplace.

5. get_inventory_summary (rozsah inventory.read)

Vrací celkové množství zásob podle jednotlivých lokací, takže asistent může odpovědět, kolik zásob společnost v jednotlivých skladech drží.

6. find_missing_product_data (rozsah catalog.read)

Vyhledá produkty, kterým chybí údaje potřebné k prodeji (obrázek, cena, kategorie, popis, čárový kód apod.), a uvede, co přesně chybí. Výsledky jsou stránkovány.

7. find_listing_problems (rozsah catalog.read)

Vyhledá produkty, které se nepodařilo vystavit na marketplace nebo prodejním kanálu, a vysvětlí chybu včetně srozumitelného návodu k nápravě – například chybějící kód EAN vyžadovaný kategorií Allegro.

8. find_unfulfilled_orders (rozsah orders.read)

Vypíše otevřené objednávky z e-shopů, marketplaces a B2B, které dosud nebyly odeslány, včetně jejich zdroje, partnera a stavu.

9. search_categories (rozsah catalog.read)

Vyhledává ve stromu produktových kategorií podle názvu a vrací ID a cesty kategorií; update_product podle ID nastaví kategorii.

10. Jak fungují nástroje pro zápis

Nástroje pro zápis vyžadují rozsah catalog.write nebo inventory.write a roli vlastníka nebo správce. Každý pracuje ve dvou krocích: s confirm=false vrátí jen náhled starých a nových hodnot; s confirm=true a expected_version (verze produktu z náhledu nebo z get_product) uloží. Pokud se produkt mezitím změnil, uložení se odmítne. Jedno volání mění jeden produkt, každá změna se zapíše do historie s původem mcp a nic nelze smazat.

11. update_product (rozsah catalog.write)

Mění název, popis, značku, typ, kategorii, čárový kód, SKU, prodejní cenu nebo stav (aktivní nebo koncept) jednoho produktu. Zde zadaná cena je ruční cena, kterou AI na pozadí nikdy nepřepíše. SKU se mění samostatným voláním.

12. adjust_stock (rozsah inventory.write)

Nastaví, přidá nebo odebere zásobu jednoho produktu v jedné lokaci běžným skladovým pohybem, takže se aktualizuje i deník pohybů a synchronizace zásob se Shopify.

13. set_channel_listing (rozsah catalog.write)

Zapne, vypne nebo vrátí na pravidlo kanálu jeden produkt na jednom tržišti nebo kanálu. Použité, repasované nebo poškozené produkty nelze nikdy zapnout na kanálech, které přijímají jen nové produkty (eMAG, Árukereső, Árgép, Pepita).

14. create_product (rozsah catalog.write)

Vytvoří nový produkt podle čárového kódu nebo názvu, volitelně s počáteční zásobou v jedné lokaci. AI na pozadí jej identifikuje a doplní zbytek v obvyklém limitu nejvýše 5 volání AI na produkt; existující čárový kód se nikdy nezduplikuje.