Források

A WareRushAI MCP-eszközeinek referenciája

A WareRushAI MCP-szerver olvasó és író eszközei, a hozzájuk tartozó jogosultság és az, amit visszaadnak vagy módosítanak.

Frissítve:

1. get_account_info (jogosultság: account.read)

Visszaadja a bejelentkezett felhasználó cégét, szerepkörét, előfizetési csomagját és a bekapcsolt modulokat. Az asszisztensek ezt hívják először, hogy tudják, kinek az adatait nézik.

2. list_warehouses (jogosultság: inventory.read)

Felsorolja a cég raktárait és telephelyeit, és hogy melyik van Shopify-telephelyhez kötve.

3. search_products (jogosultság: catalog.read)

Terméket keres név, cikkszám, vonalkód, márka vagy modell alapján, és termékenként rövid sort ad árral, kategóriával és készlettel. Az eredmény lapozott; a teljes adatért a get_product való.

4. get_product (jogosultság: catalog.read)

Egy termék adatait, telephelyenkénti készletét és piactéri hirdetési állapotát adja vissza.

5. get_inventory_summary (jogosultság: inventory.read)

Telephelyenként visszaadja az összes készlet darabszámát, így az asszisztens meg tudja válaszolni, mennyi készlete van a cégnek az egyes raktárakban.

6. find_missing_product_data (jogosultság: catalog.read)

Megkeresi az értékesítéshez szükséges adat nélküli termékeket (kép, ár, kategória, leírás, vonalkód és hasonlók), és megnevezi, mi hiányzik. Az eredmény lapozott.

7. find_listing_problems (jogosultság: catalog.read)

Megkeresi azokat a termékeket, amelyek nem kerültek ki egy piactérre vagy csatornára, és közérthetően elmagyarázza a hibát és a teendőt, például az Allegro-kategória által kért hiányzó EAN-t.

8. find_unfulfilled_orders (jogosultság: orders.read)

Felsorolja a még ki nem szállított nyitott webshop-, piactéri és B2B-rendeléseket a forrásukkal, partnerükkel és állapotukkal.

9. search_categories (jogosultság: catalog.read)

Név alapján keres a termékkategória-fában, és kategória-azonosítót és útvonalat ad vissza; az update_product ezzel az azonosítóval állít kategóriát.

10. Így működnek az író eszközök

Az író eszközökhöz catalog.write vagy inventory.write jogosultság és tulajdonosi vagy adminisztrátori szerepkör kell. Mindegyik két lépésben dolgozik: confirm=false esetén csak előnézetet ad a régi és az új értékkel; confirm=true és expected_version (a termék verziója az előnézetből vagy a get_product eszközből) esetén ment. Ha a termék közben megváltozott, a mentést elutasítja. Egy hívás egy terméket módosít, minden módosítás mcp forrással kerül az előzménybe, és törölni semmit nem lehet.

11. update_product (jogosultság: catalog.write)

Egy termék nevét, leírását, márkáját, típusát, kategóriáját, vonalkódját, cikkszámát, eladási árát vagy állapotát (aktív vagy vázlat) módosítja. Az itt megadott ár kézi árnak számít, amit a háttér-AI soha nem ír felül. A cikkszám külön hívásban változtatható.

12. adjust_stock (jogosultság: inventory.write)

Egy termék készletét állítja be, növeli vagy csökkenti egy telephelyen a szokásos készletmozgással, így a mozgásnapló és a Shopify-készletszinkron is frissül.

13. set_channel_listing (jogosultság: catalog.write)

Egy terméket bekapcsol, kikapcsol vagy visszaállít a csatorna szabályára egy piactéren vagy csatornán. Használt, felújított vagy sérült termék soha nem kapcsolható be a csak új terméket fogadó csatornákon (eMAG, Árukereső, Árgép, Pepita).

14. create_product (jogosultság: catalog.write)

Új terméket vesz fel vonalkód vagy név alapján, opcionálisan kezdőkészlettel egy telephelyen. A többit a háttér-AI azonosítja és tölti ki a szokásos keretben (termékenként legfeljebb 5 AI-hívás); meglévő vonalkódhoz soha nem hoz létre másodpéldányt.