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

> Nástroje serveru MCP na shopzi.cz, který běží bez klíče: tarify, kontrola subdomény, koncept nového obchodu, stav zakládání a hledání v dokumentaci.

- Sekce: Pro vývojáře
- Stránka: https://shopzi.cz/dokumentace/vyvojari/mcp-platforma
- Ověřeno: 2026-09-16

---

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](/dokumentace/vyvojari/zalozeni-obchodu-pres-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` [#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 [#shopzi-list-plans-parametry]

Nástroj nebere žádné parametry.

## `shopzi_check_subdomain` [#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 [#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` [#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 [#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` [#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 [#shopzi-store-creation-status-parametry]

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

## `shopzi_docs` [#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 [#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.