Resurser

WareRushAI MCP-verktygsreferens

Läs- och skrivverktygen i WareRushAI MCP-servern, deras behörighetsomfång och vad de returnerar eller ändrar.

Revised:

1. get_account_info (omfång account.read)

Returnerar företaget för den inloggade användaren, dennes roll, abonnemangsplan och aktiverade moduler. Assistenter anropar detta först för att veta vems data de hanterar.

2. list_warehouses (omfång inventory.read)

Listar företagets lager och platser samt vilka av dem som är kopplade till en plats i Shopify.

3. search_products (omfång catalog.read)

Söker efter produkter via namn, SKU, streckkod, varumärke eller modell och returnerar en kort rad per produkt med pris, kategori och lagersaldo. Resultaten är sidnumrerade; använd get_product för hela posten.

4. get_product (omfång catalog.read)

Returnerar information om en enskild produkt, dess lagersaldo per plats och dess publiceringsstatus på marknadsplatser.

5. get_inventory_summary (omfång inventory.read)

Returnerar den totala lagermängden per plats, så att en assistent kan svara på hur mycket lager företaget har i varje lager.

6. find_missing_product_data (omfång catalog.read)

Hittar produkter som saknar data som krävs för försäljning (bild, pris, kategori, beskrivning, streckkod och liknande) och anger vad som saknas. Resultaten är sidnumrerade.

7. find_listing_problems (omfattning catalog.read)

Hittar produkter som inte publicerades på en marknadsplats eller kanal och förklarar felet med en tydlig åtgärdsbeskrivning, till exempel en saknad EAN som krävs av Allegro-kategorin.

8. find_unfulfilled_orders (omfattning orders.read)

Listar öppna webbutiks-, marknadsplats- och B2B-ordrar som ännu inte har skickats, tillsammans med källa, partner och status.

9. search_categories (omfattning catalog.read)

Söker i produktkategoriträdet efter namn och returnerar kategori-id:n och sökvägar; update_product använder id:t för att sätta en kategori.

10. Så fungerar skrivverktygen

Skrivverktyg kräver omfattningen catalog.write eller inventory.write och rollen ägare eller administratör. Varje verktyg arbetar i två steg: med confirm=false returnerar det bara en förhandsvisning av gamla och nya värden; med confirm=true och expected_version (produktversionen från förhandsvisningen eller från get_product) sparar det. Om produkten har ändrats under tiden nekas sparandet. Ett anrop ändrar en produkt, varje ändring loggas med ursprung mcp och ingenting kan raderas.

11. update_product (omfattning catalog.write)

Ändrar namn, beskrivning, varumärke, produkttyp, kategori, streckkod, SKU, försäljningspris eller status (aktiv eller utkast) för en produkt. Ett pris som sätts här räknas som ett manuellt pris som bakgrunds-AI:n aldrig skriver över. SKU ändras i ett separat anrop.

12. adjust_stock (omfattning inventory.write)

Sätter, ökar eller minskar lagersaldot för en produkt på en plats via den vanliga lagerrörelsen, så att även rörelseloggen och Shopify-lagersynkroniseringen uppdateras.

13. set_channel_listing (omfattning catalog.write)

Slår på, slår av eller återställer kanalregeln för en produkt på en marknadsplats eller kanal. Begagnade, renoverade eller skadade produkter kan aldrig slås på för kanaler som bara tar emot nya produkter (eMAG, Árukereső, Árgép, Pepita).

14. create_product (omfattning catalog.write)

Skapar en ny produkt utifrån en streckkod eller ett namn, valfritt med ingående lagersaldo på en plats. Bakgrunds-AI:n identifierar den och fyller i resten inom den vanliga gränsen på högst 5 AI-anrop per produkt; en befintlig streckkod dupliceras aldrig.