MCP bez klíče: tarify a založení obchodu

Tenhle server nepatří žádnému obchodu a klíč nechce: nabízí jen to, co smí kdokoli z internetu, a do existujících obchodů nevidí.

Server běží na adrese https://shopzi.cz/api/mcp. Jak z terminálu vznikne obchod krok za krokem, popisuje článek Založení obchodu přes MCP.

Popisy parametrů jsou převzaté ze schématu, které server posílá v tools/list; kde se v něm text obrací přímo k modelu, je tady převedený do vykání. Povinnost parametru platí uvnitř objektu, ve kterém parametr leží.

shopzi_list_plans

Vrátí placené tarify, které jde založit přes MCP, s cenou za měsíc i za rok v haléřích přímo ze Stripe, s limity tarifu a s poznámkou o zkušebním období: obchod z terminálu má 30 dní zdarma stejně jako obchod z webu, kartu člověk uloží hned při zakládání a první platba přijde 31. den.

• Oprávnění: žádné, server klíč nechce.
• Druh: čtení (readOnlyHint).

shopzi_list_plans: parametry

Nástroj nebere žádné parametry.

shopzi_check_subdomain

Ověří, jestli je subdoména pro nový obchod volná, a vrátí důvod a volné varianty. Komu obsazená subdoména patří, neprozradí.

• Oprávnění: žádné, server klíč nechce.
• Druh: čtení (readOnlyHint).

shopzi_check_subdomain: parametry

• subdomain (text, 1 až 80 znaků; povinný): Požadovaná subdoména, například cerstva-kava pro cerstva-kava.shopzi.cz. Přípona .shopzi.cz se smí uvést.

shopzi_create_store

Založí koncept obchodu a podrží pro něj subdoménu. Obchod vznikne až poté, co člověk v prohlížeči zadá párovací kód, ověří e-mail, přijme podmínky a uloží platební kartu. Bez karty obchod nevznikne, prvních 30 dní se z ní nic nestrhne a první platba přijde 31. den.

• Oprávnění: žádné, server klíč nechce.
• Druh: zápis, který jen přidává.

shopzi_create_store: parametry

• shop_name (text, 2 až 100 znaků; povinný): Název obchodu, jak ho uvidí zákazníci.
• subdomain (text, 3 až 80 znaků; povinný): Subdoména obchodu. Ověřte ji napřed nástrojem shopzi_check_subdomain.
• plan (jedna z hodnot start, growth, scale a pro; povinný): Tarif z shopzi_list_plans. Přes MCP jde založit jen placený tarif.
• interval (jedna z hodnot monthly a annual; povinný): Měsíční (monthly), nebo roční (annual) platba.

shopzi_store_creation_status

Řekne, v jakém stavu je zakládání obchodu, a po dokončení vrátí adresu obchodu a přihlášení do administrace, nikdy klíč ani přihlašovací token.

• Oprávnění: žádné, server klíč nechce.
• Druh: čtení (readOnlyHint).

shopzi_store_creation_status: parametry

• status_token (text, 20 až 200 znaků; povinný): status_token z výsledku shopzi_create_store.

shopzi_docs

Hledá a čte dokumentaci SHOPZI, návody k administraci i dokumentaci pro vývojáře, fulltextově a zdarma: mode s hodnotou search vrátí úryvky a pole docs hledání zúží na jednu z obou dokumentací, s hodnotou read článek nebo jednu jeho kapitolu.

• Oprávnění: žádné, server klíč nechce.
• Druh: čtení (readOnlyHint).

shopzi_docs: parametry

• mode (jedna z hodnot search a read; povinný): search = najít v návodech (vyžaduje query); read = přečíst článek (vyžaduje slug).
• query (text, nejvýš 500 znaků; nepovinný): Jen u search: otázka vlastními slovy.
• slug (text, nejvýš 120 znaků; nepovinný): Jen u read: identifikátor článku z hledání.
• section (jedna z hodnot prehled, zaciname, produkty, objednavky, doprava-a-platby, marketing, vzhled, nastaveni a vyvojari; nepovinný): Jen u search: zúží hledání na jednu sekci dokumentace.
• docs (jedna z hodnot uzivatele a vyvojari; nepovinný): Jen u search: uzivatele = návody k administraci, vyvojari = dokumentace pro vývojáře. Vynechané = obě.
• heading (text, nejvýš 200 znaků; nepovinný): Jen u read: název kapitoly (H2), když stačí její část. Neznámý název vrátí jen nadpisy.