# MCP: příkazy a pokyny serveru > Lomítkové příkazy, které server MCP obchodu nabízí klientovi, s oprávněním, které chtějí, a pokyny, které oba servery SHOPZI posílají modelu. - Sekce: Pro vývojáře - Stránka: https://shopzi.cz/dokumentace/vyvojari/mcp-prikazy - Ověřeno: 2026-09-16 --- Kromě nástrojů nabízí server MCP obchodu hotové příkazy (v protokolu `prompts`), které klient obvykle ukáže jako lomítkové příkazy. Příkaz vybírá člověk, ne model, a pošle modelu připravenou otázku. Jsou to tytéž rychlé akce, které nabízí panel Agenta v administraci, a klíč dostane jen ty, na jejichž oprávnění dosáhne. Klient si seznam vyžádá voláním `prompts/list` a příkaz spustí voláním `prompts/get` s jeho jménem. Každý příkaz nese předponu `shopzi_`, aby se mezi příkazy jiných serverů v klientu neztratil. Jak se server připojuje a ověřuje, popisuje článek [MCP server](/dokumentace/vyvojari/mcp-server). ## Příkazy s argumentem [#prikazy-s-argumentem] Argument si klient umí našeptat ze skutečných dat obchodu: nabídne názvy produktů, kategorií nebo čísla objednávek, ne interní identifikátory. Model si položku podle nich dohledá sám. * `shopzi_produkt_detail`, **Detail produktu**: Vypíše vše, co obchod o produktu ví: cenu, stav, sklad a zařazení. * **Oprávnění:** `products:read` * **Argument:** `produkt`, Název produktu nebo jeho SKU. * **Zpráva modelu:** Najdi produkt „\{produkt}“ a vypiš mi o něm vše, co víš: cenu, stav, skladovou zásobu a do kterých kategorií patří. * `shopzi_kategorie_obsah`, **Co je v kategorii**: Vypíše produkty v jedné kategorii i s jejich stavem. * **Oprávnění:** `products:read` * **Argument:** `kategorie`, Název kategorie. * **Zpráva modelu:** Které produkty mám v kategorii „\{kategorie}“? Vypiš je i s cenou a stavem. * `shopzi_objednavka_detail`, **Detail objednávky**: Vypíše položky, částky, stav platby a expedice jedné objednávky. * **Oprávnění:** `orders:read` * **Argument:** `objednavka`, Číslo objednávky nebo e-mail zákazníka. * **Zpráva modelu:** Najdi objednávku „\{objednavka}“ a vypiš mi její položky, celkovou částku, stav platby a stav expedice. ## Příkazy s oprávněním `orders:read` [#prikazy-s-opravnenim-orders-read] Klíč s oprávněním „Objednávky (čtení)“ dostane tyto příkazy bez argumentu. Každý pošle modelu jako zprávu člověka přesně text za dvojtečkou. * `shopzi_orders_week`, **Objednávky za týden**: Kolik objednávek mi přišlo za posledních 7 dní a jaká je jejich celková hodnota? * `shopzi_orders_today`, **Objednávky dnes**: Kolik objednávek přišlo dnes a v jaké celkové hodnotě? * `shopzi_orders_unpaid`, **Nezaplacené objednávky**: Které objednávky čekají na zaplacení? Seřaď je od nejstarší. * `shopzi_orders_unshipped`, **K odeslání**: Které zaplacené objednávky ještě nemají expedici? * `shopzi_returns_open`, **Čeká na vyřízení**: Které vratky a reklamace jsou ve stavu požadováno nebo přijato? * `shopzi_returns_approved`, **Schválené k vrácení**: Které vratky jsou schválené a čekají na vrácení peněz? Vypiš i schválenou částku. * `shopzi_returns_deadline`, **Blíží se lhůta**: Z otevřených vratek a reklamací: u kterých se blíží zákonná lhůta? * `shopzi_returns_credit`, **Už s dobropisem**: U kterých vyřízených vratek je už vystavený dobropis? ## Příkazy s oprávněním `products:read` [#prikazy-s-opravnenim-products-read] Klíč s oprávněním „Katalog: produkty, kategorie, dodavatelé (čtení)“ dostane tyto příkazy bez argumentu. Každý pošle modelu jako zprávu člověka přesně text za dvojtečkou. * `shopzi_products_active`, **Kolik mám produktů**: Kolik mám v katalogu aktivních produktů? * `shopzi_products_count`, **Kolik mám produktů**: Kolik mám v katalogu produktů celkem a kolik z nich je aktivních? * `shopzi_products_no_desc`, **Produkty bez popisu**: Které produkty nemají vyplněný popis nebo SEO titulek? Vypiš prvních dvacet. * `shopzi_products_recent`, **Co jsem přidal naposled**: Které produkty jsem přidal za posledních 14 dní? * `shopzi_cats_tree`, **Strom kategorií**: Jak vypadá strom kategorií? Vypiš mi je i s tím, jak hluboko jsou zanořené. * `shopzi_cats_order`, **Pořadí v menu**: V jakém pořadí se kategorie ukazují zákazníkovi? * `shopzi_cats_slugs`, **Adresy kategorií**: Jaké mají kategorie adresy na webu? * `shopzi_cats_brands`, **Značky v katalogu**: Jaké mám v katalogu značky a kolik u nich mám produktů? * `shopzi_attrs_list`, **Jaké mám vlastnosti**: Vypiš mi definované vlastnosti produktů i s tím, jaké mají ovládání. * `shopzi_attrs_filter`, **Co filtruje na webu**: Které vlastnosti se zákazníkovi ukazují jako filtr v katalogu? * `shopzi_attrs_off`, **Vypnuté vlastnosti**: Které vlastnosti mám vypnuté, takže se nikde nepoužívají? * `shopzi_attrs_vendors`, **Značky a dodavatelé**: Jaké mám v katalogu značky a dodavatele? * `shopzi_vendors_list`, **Značky v katalogu**: Jaké mám v katalogu značky a kolik u nich mám živých produktů? * `shopzi_vendors_empty`, **Značky bez produktů**: Které značky nemají ani jeden živý produkt? * `shopzi_vendors_off`, **Vypnuté značky**: Které značky mám vypnuté, takže se na webu neukazují? * `shopzi_b2b_pricelists`, **Ceníky**: Jaké mám ceníky, jakou mají slevu a které jsou aktivní? ## Příkazy s oprávněním `stock:read` [#prikazy-s-opravnenim-stock-read] Klíč s oprávněním „Sklad, pohyby a nákup (čtení)“ dostane tyto příkazy bez argumentu. Každý pošle modelu jako zprávu člověka přesně text za dvojtečkou. * `shopzi_stock_levels`, **Co mi dochází**: Které skladové položky mi docházejí nebo jsou vyprodané? Vypiš je i s dostupným množstvím. * `shopzi_stock_movements`, **Poslední pohyby**: Jaké byly poslední skladové pohyby a čeho se týkaly? * `shopzi_stock_stocktakes`, **Rozpracované inventury**: Které inventury mám rozpracované a kolik nesrovnalostí zatím našly? * `shopzi_stock_po`, **Objednávky zásob**: Které objednávky zásob jsou odeslané nebo potvrzené a ještě nedorazily celé? * `shopzi_stock_suppliers`, **Dodavatelé zásob**: Jaké mám dodavatele, jakou mají dodací lhůtu a kolik u nich mám otevřených objednávek? * `shopzi_suppliers_list`, **Dodavatelé ve skladu**: Jaké mám ve skladu dodavatele, jakou mají dodací lhůtu a kolik u nich mám otevřených objednávek zásob? ## Příkazy s oprávněním `documents:read` [#prikazy-s-opravnenim-documents-read] Klíč s oprávněním „Doklady: metadata, položky a stažení PDF/ISDOC (čtení)“ dostane tyto příkazy bez argumentu. Každý pošle modelu jako zprávu člověka přesně text za dvojtečkou. * `shopzi_docs_month`, **Vystavené doklady**: Kolik mám vystavených dokladů podle typu, tedy faktur, dobropisů a zálohových faktur? * `shopzi_docs_by_type`, **Doklady podle typu**: Kolik mám vystavených dokladů podle typu, tedy faktur, dobropisů a zálohových faktur? * `shopzi_docs_unpaid`, **Nezaplacené faktury**: Které vystavené faktury zatím nikdo nezaplatil a v jaké celkové částce? * `shopzi_docs_credit_notes`, **Dobropisy**: Vypiš mi vystavené dobropisy i s částkou a číslem objednávky, ke které patří. * `shopzi_docs_last`, **Poslední faktura**: Ukaž mi poslední vystavenou fakturu se všemi položkami a rozpisem DPH. * `shopzi_docs_no_ico`, **Doklady bez IČO**: U kterých dokladů chybí IČO nebo DIČ odběratele? ## Příkazy s oprávněním `customers:read` [#prikazy-s-opravnenim-customers-read] Klíč s oprávněním „Zákazníci, skupiny, recenze, zprávy, historie e-mailů a SMS a žádosti GDPR (čtení)“ dostane tyto příkazy bez argumentu. Každý pošle modelu jako zprávu člověka přesně text za dvojtečkou. * `shopzi_customers_count`, **Kolik mám zákazníků**: Kolik mám registrovaných zákazníků a kolik z nich jsou firmy? * `shopzi_customers_b2b`, **Čeká na velkoobchod**: Kteří zákazníci čekají na schválení velkoobchodního účtu? * `shopzi_customers_newsletter`, **Odběratelé newsletteru**: Kolik zákazníků mi odebírá newsletter a jaký je to podíl ze všech? * `shopzi_customers_groups`, **Cenové skupiny**: Jaké mám cenové skupiny zákazníků a jaké mají podmínky? * `shopzi_customers_messages`, **Nevyřízené zprávy**: Které zprávy od zákazníků ještě nikdo nevyřídil? * `shopzi_reviews_pending`, **Recenze ke schválení**: Které recenze čekají na moderaci? Vypiš je i s počtem hvězd a produktem. * `shopzi_reviews_reported`, **Nahlášené recenze**: Které recenze někdo nahlásil? Ukaž je i s textem, ať se můžu rozhodnout. * `shopzi_reviews_verified`, **Od ověřených zákazníků**: Kolik z čekajících recenzí je od ověřených zákazníků a kolik od ostatních? * `shopzi_reviews_published`, **Co je zveřejněné**: Které recenze mám zveřejněné? Vypiš je i s hodnocením a produktem. * `shopzi_messages_new`, **Nové zprávy**: Které zprávy od zákazníků jsou nové a nikdo je ještě nečetl? * `shopzi_messages_read`, **Přečtené, nevyřízené**: Které zprávy mám přečtené, ale ještě nejsou v archivu? * `shopzi_messages_archived`, **V archivu**: Kolik zpráv už mám v archivu? * `shopzi_messages_find`, **Hledat ve zprávách**: Psal mi někdo ohledně reklamace nebo vrácení zboží? Prohledej zprávy. * `shopzi_b2b_groups`, **Cenové skupiny**: Jaké mám cenové skupiny zákazníků, jaké mají platební podmínky a minimální objednávku? * `shopzi_b2b_pending`, **Čeká na schválení**: Z registrovaných zákazníků: kdo čeká na schválení velkoobchodního účtu? * `shopzi_b2b_companies`, **Firemní zákazníci**: Vypiš mi zákazníky, kteří nakupují na firmu, i s názvem firmy. * `shopzi_gdpr_open`, **Nevyřízené žádosti**: Které žádosti o export nebo výmaz osobních údajů ještě čekají na vyřízení? * `shopzi_gdpr_split`, **Exporty a výmazy**: Kolik mám žádostí o export a kolik o výmaz osobních údajů? * `shopzi_gdpr_oldest`, **Nejdéle čekající**: Která nevyřízená žádost čeká nejdéle a od kdy? * `shopzi_gdpr_done`, **Už vyřízené**: Kolik žádostí jsem už vyřídil a kdy to bylo? ## Příkazy s oprávněním `content:read` [#prikazy-s-opravnenim-content-read] Klíč s oprávněním „Obsah: stránky, blog, sekce, média (čtení)“ dostane tyto příkazy bez argumentu. Každý pošle modelu jako zprávu člověka přesně text za dvojtečkou. * `shopzi_pages_list`, **Přehled stránek**: Které obsahové stránky mám a které z nich nejsou publikované? * `shopzi_pages_header`, **Co je v hlavičce**: Které stránky se zákazníkovi ukazují v hlavičce webu a které ne? * `shopzi_pages_seo`, **SEO jedné stránky**: Má stránka Obchodní podmínky vyplněný SEO titulek i popisek? * `shopzi_pages_blog`, **Články na blogu**: Jaké mám na blogu články a v jakých rubrikách? * `shopzi_appearance_home`, **Bloky domovské stránky**: Jaké bloky mám na domovské stránce a v jakém pořadí jdou za sebou? * `shopzi_appearance_home_off`, **Vypnuté bloky**: Které bloky na domovské stránce mám vypnuté, takže je návštěvník nevidí? * `shopzi_blog_list`, **Přehled článků**: Jaké mám na blogu články a které z nich nejsou publikované? * `shopzi_blog_cats`, **Rubriky blogu**: Jaké mám na blogu rubriky a které jsou aktivní? * `shopzi_blog_excerpt`, **O čem články jsou**: O čem jsou moje poslední články? Shrň mi je podle perexu. * `shopzi_blog_seo`, **SEO posledního článku**: Vezmi poslední publikovaný článek a zkontroluj mi u něj SEO titulek i popisek. * `shopzi_media_list`, **Poslední soubory**: Co mám v knihovně médií? Vypiš mi naposledy nahrané soubory. * `shopzi_media_alt`, **Obrázky bez popisu**: Které obrázky nemají vyplněný alternativní text? * `shopzi_media_size`, **Co zabírá místo**: Z naposledy nahraných souborů: které zabírají nejvíc místa? * `shopzi_media_types`, **Jaké typy souborů**: Jaké typy souborů mám v knihovně, tedy obrázky, videa a dokumenty? ## Příkazy s oprávněním `marketing:read` [#prikazy-s-opravnenim-marketing-read] Klíč s oprávněním „Marketing: slevy, feedy, kampaně, segmenty (čtení)“ dostane tyto příkazy bez argumentu. Každý pošle modelu jako zprávu člověka přesně text za dvojtečkou. * `shopzi_discounts_active`, **Aktivní slevy**: Které slevové kódy jsou právě aktivní a do kdy platí? * `shopzi_discounts_unused`, **Nepoužité kódy**: Které slevové kódy zatím nikdo neuplatnil? * `shopzi_discounts_limit`, **Dochází limit**: Kterým kódům dochází limit uplatnění? Seřaď je podle toho, kolik zbývá. * `shopzi_discounts_draft`, **Rozpracované kódy**: Které slevové kódy jsou ještě jen koncept a nikdy se nespustily? * `shopzi_campaigns_list`, **Přehled kampaní**: Jaké mám e-mailové kampaně a v jakém jsou stavu? * `shopzi_campaigns_scheduled`, **Naplánované**: Které kampaně mám naplánované a na kdy? * `shopzi_campaigns_draft`, **Rozpracované**: Které kampaně zůstaly jako koncept a nikdy neodešly? * `shopzi_segments_list`, **Segmenty zákazníků**: Jaké mám segmenty zákazníků a kolik mají uložených členů? * `shopzi_feeds_status`, **Stav feedů**: Které feedy do srovnávačů mám zapnuté a kdy naposledy proběhly? * `shopzi_feeds_errors`, **Feed skončil chybou**: Skončil některý feed chybou? Ukaž mi hlášení. * `shopzi_feeds_count`, **Kolik položek odešlo**: Kolik položek naposledy odešlo do jednotlivých srovnávačů? * `shopzi_feeds_off`, **Vypnuté srovnávače**: Do kterých srovnávačů zatím feed neposílám? * `shopzi_popups_list`, **Přehled oken**: Jaká mám vyskakovací okna a které z nich je právě aktivní? * `shopzi_popups_content`, **Co je v okně**: Co mám v aktivním vyskakovacím okně napsané a kam vede jeho tlačítko? * `shopzi_popups_frequency`, **Jak často se ukazuje**: Jak často se okno zákazníkovi ukáže a s jakým zpožděním po otevření webu? * `shopzi_popups_discount`, **Okno se slevou**: Které vyskakovací okno nabízí slevový kód? ## Příkazy s oprávněním `settings:read` [#prikazy-s-opravnenim-settings-read] Klíč s oprávněním „Nastavení, doprava, platby, vzhled (čtení)“ dostane tyto příkazy bez argumentu. Každý pošle modelu jako zprávu člověka přesně text za dvojtečkou. * `shopzi_shipping_list`, **Přehled dopravy**: Vypiš mi metody dopravy i s cenami a DPH. * `shopzi_shipping_cod`, **Kde jde dobírka**: U kterých metod dopravy jde platit dobírkou? * `shopzi_shipping_free`, **Doprava zdarma**: Od jaké částky mám u jednotlivých metod dopravu zdarma? * `shopzi_shipping_off`, **Vypnuté metody**: Které metody dopravy mám vypnuté, takže si je zákazník nemůže vybrat? * `shopzi_appearance_now`, **Jak teď obchod vypadá**: Jakou mám nastavenou šablonu, barvy a písma? * `shopzi_appearance_motion`, **Uvítací animace**: Mám zapnutou uvítací animaci? V jakém stylu a jak dlouho běží? * `shopzi_settings_store`, **Údaje obchodu**: Jaké mám vyplněné fakturační údaje obchodu, tedy IČO, DIČ a adresu? * `shopzi_settings_payments`, **Platební metody**: Jaké platební metody mám zapnuté a kterou kartovou bránu používám? * `shopzi_settings_hours`, **Otevírací doba**: Jakou mám nastavenou otevírací dobu prodejny a kdy mám zavřeno? * `shopzi_settings_inventory`, **Nastavení skladu**: Mám zapnutý sklad a od kolika kusů hlásí docházející zásobu? * `shopzi_search_rules`, **Synonyma a přesměrování**: Jaká mám ve vyhledávání nastavená synonyma, přesměrování a připnuté produkty? * `shopzi_search_index`, **Stav napovídání**: Kolik produktů mám připravených pro chytré vyhledávání a kolik jich čeká na přepočet? ## Příkazy s oprávněním `tasks:read` [#prikazy-s-opravnenim-tasks-read] Klíč s oprávněním „Úkoly a seznam členů týmu (čtení)“ dostane tyto příkazy bez argumentu. Každý pošle modelu jako zprávu člověka přesně text za dvojtečkou. * `shopzi_tasks_open`, **Otevřené úkoly**: Které úkoly jsou otevřené a co z nich má nejvyšší prioritu? * `shopzi_tasks_review`, **Čeká na kontrolu**: Které úkoly jsou ve stavu ke kontrole? * `shopzi_tasks_due`, **Po termínu**: Které z otevřených úkolů mají termín, který už uplynul? * `shopzi_tasks_unassigned`, **Bez řešitele**: Které z otevřených úkolů nemají přiřazeného řešitele? * `shopzi_tasks_done`, **Hotové úkoly**: Kolik úkolů je hotových? Vypiš mi je i s tím, kdo je řešil. ## Příkazy s oprávněním `analytics:read` [#prikazy-s-opravnenim-analytics-read] Klíč s oprávněním „Statistiky: návštěvnost, SEO, hledání, tržby a prodeje (čtení)“ dostane tyto příkazy bez argumentu. Každý pošle modelu jako zprávu člověka přesně text za dvojtečkou. * `shopzi_seo_score`, **Celkové SEO skóre**: Jaké mám celkové SEO skóre a kolik stránek je v pořádku, kolik na hraně a kolik špatně? * `shopzi_seo_worst`, **Nejhorší stránky**: Které stránky mají nejhorší SEO skóre a co konkrétně jim chybí? * `shopzi_seo_sections`, **Podle typu obsahu**: Jak si stojí SEO u jednotlivých typů obsahu, tedy u produktů, kategorií a stránek? * `shopzi_seo_trend`, **Zlepšilo se to?**: Zlepšilo se mi průměrné SEO skóre za posledních 30 dní? * `shopzi_search_zero`, **Nenašli nic**: Co lidi na webu hledali a nic nenašli? Vypiš nejčastější takové dotazy. * `shopzi_search_top`, **Co lidi hledají**: Co lidi na mém webu hledají nejčastěji? * `shopzi_visitors_week`, **Návštěvnost za týden**: Kolik lidí mi za posledních 7 dní přišlo na web a kolik zobrazili stránek? * `shopzi_visitors_sources`, **Odkud chodí**: Z jakých webů ke mně návštěvníci chodí nejčastěji? * `shopzi_visitors_pages`, **Nejnavštěvovanější stránky**: Které stránky mají nejvíc zobrazení? * `shopzi_visitors_devices`, **Mobil, nebo počítač**: Chodí ke mně lidi spíš z mobilu, nebo z počítače? ## Příkazy s oprávněním `docs:read` [#prikazy-s-opravnenim-docs-read] Klíč s oprávněním „Dokumentace SHOPZI (čtení)“ dostane tyto příkazy bez argumentu. Každý pošle modelu jako zprávu člověka přesně text za dvojtečkou. * `shopzi_cats_help`, **Jak na kategorie**: Jak se v SHOPZI zakládá kategorie a jak funguje zanoření? Vysvětli mi to podle nápovědy. * `shopzi_docs_help`, **Jak na fakturaci**: Jak se v SHOPZI vystavuje faktura a dobropis? Vysvětli mi to podle nápovědy. * `shopzi_reviews_help`, **Jak na recenze**: Jak v SHOPZI funguje moderace recenzí a co znamenají jednotlivé stavy? * `shopzi_discounts_help`, **Jak na slevy**: Jak se v SHOPZI zakládá slevový kód a co která nastavení znamenají? * `shopzi_shipping_help`, **Jak na dopravu**: Jak se v SHOPZI nastavuje doprava a výdejní místa? Vysvětli mi to podle nápovědy. * `shopzi_pages_help`, **Jak na stránky**: Jak se v SHOPZI zakládá nová stránka a co znamenají její typy? * `shopzi_appearance_help`, **Jak na vzhled**: Jak se v SHOPZI mění šablona, barvy a písma? Vysvětli mi to podle nápovědy. * `shopzi_attrs_help`, **Jak na vlastnosti**: K čemu v SHOPZI slouží vlastnosti produktů a jak souvisí s variantami a filtry? * `shopzi_vendors_help`, **Značka nebo dodavatel?**: Jaký je v SHOPZI rozdíl mezi značkou v katalogu a dodavatelem ve skladu? * `shopzi_returns_help`, **Jak na reklamace**: Jak se v SHOPZI vyřizuje vratka a jak reklamace? Vysvětli mi rozdíl podle nápovědy. * `shopzi_messages_help`, **Jak na zprávy**: Kde se v SHOPZI berou zprávy od zákazníků a jak se s nimi pracuje? * `shopzi_b2b_help`, **Jak na velkoobchod**: Jak v SHOPZI funguje velkoobchod, cenové skupiny a schvalování firemních účtů? * `shopzi_gdpr_help`, **Jak na GDPR**: Jak se v SHOPZI vyřizuje žádost o export a o výmaz osobních údajů? * `shopzi_emailing_help`, **Jak na kampaně**: Jak se v SHOPZI připraví a rozešle e-mailová kampaň? * `shopzi_feeds_help`, **Jak na feedy**: Jak se v SHOPZI zapíná feed do Heuréky a Zboží.cz a co pro to potřebuju? * `shopzi_popups_help`, **Jak na vyskakovací okna**: K čemu se v SHOPZI hodí vyskakovací okna a jaké mají typy? * `shopzi_blog_help`, **Jak na blog**: Jak se v SHOPZI zakládá článek na blogu a k čemu jsou rubriky? * `shopzi_media_help`, **Jak na média**: Jak se v SHOPZI nahrávají obrázky a k čemu je alternativní text? * `shopzi_settings_help`, **Jak na nastavení**: Co všechno se v SHOPZI nastavuje a kde to najdu? Vysvětli mi to podle nápovědy. * `shopzi_seo_help`, **Co skóre počítá**: Co v SHOPZI ovlivňuje SEO skóre stránky a jak si ho můžu zlepšit? * `shopzi_search_help`, **Jak na vyhledávání**: Jak v SHOPZI funguje vyhledávání na webu a k čemu jsou synonyma? * `shopzi_docs_howto`, **Najít v nápovědě**: Najdi mi v nápovědě, jak se dělá to, co zrovna potřebuju. Zeptej se mě na co. * `shopzi_support_start`, **Než obchod spustím**: Co všechno musím podle nápovědy udělat, než obchod spustím? * `shopzi_support_orders`, **Jak vyřídit objednávku**: Jak se v SHOPZI vyřizuje objednávka od přijetí až po odeslání? * `shopzi_support_products`, **Jak přidat produkt**: Jak přidám nový produkt i s variantami a fotkami? * `shopzi_support_shipping`, **Doprava a platby**: Jak nastavím dopravu a platební metody? * `shopzi_visitors_help`, **Jak se to měří**: Jak SHOPZI měří návštěvnost a proč nepotřebuje cookies? ## Pokyny serveru obchodu [#pokyny-serveru-obchodu] Pokyny (`instructions`) posílá server modelu jednou za spojení. Říkají, jak počítat s penězi, kdy se ptát člověka a kde hledat nápovědu. Jsou psané pro model, proto mu tykají, a tady stojí doslova. Server obchodu, například `https://muj-eshop.cz/api/mcp`, posílá tyto pokyny: ```text Tohle je e-shop na platformě SHOPZI. Mluv česky. Peníze jsou CELÁ ČÍSLA V HALÉŘÍCH (129000 = 1 290,00 Kč), DPH je celé procento (21, 12, 0), nikdy 0,21. Nikdy si nevymýšlej čísla, názvy ani stavy: každé tvrzení o tomhle obchodě musí pocházet z nástroje. Když na něco nástroj není, řekni to rovnou. Než něco přepíšeš nebo smažeš, přečti si to. Nástroj, který přepisuje, maže nebo utrácí kredity obchodníka, odpoví nejdřív otázkou (`resultType: "input_required"`); ukaž ji člověku a teprve jeho potvrzení akci spustí. Tu otázku klient ukáže člověku jako dialog, ty ji nevidíš. Neslibuj proto, že počkáš na potvrzení v chatu: řekni, že se objeví potvrzovací dialog (u placené akce s cenou a zůstatkem kreditů), a zavolej nástroj. Když výsledek nese větu o potvrzení, drž se jí: akce proběhla se souhlasem člověka a cenu z ní zopakuj. Interní identifikátory (UUID) obchodníkovi neukazuj. Nevíš, jak něco v SHOPZI funguje? Zeptej se nástroje `shopzi_docs`, je to náš vlastní návod a je zdarma. Změny jde vzít zpět přes `shopzi_undo_change`; `shopzi_list_changes` ukáže, co se dnes změnilo. ``` ## Pokyny serveru bez klíče [#pokyny-serveru-bez-klice] Server bez klíče na adrese `https://shopzi.cz/api/mcp` umí jen založit nový obchod (postup popisuje článek [Založení obchodu přes MCP](/dokumentace/vyvojari/zalozeni-obchodu-pres-mcp)) a posílá tyto pokyny: ```text Tohle je bezklíčový server SHOPZI, české e-commerce platformy. Mluv česky. Umí jen založit NOVÝ obchod: ceník (`shopzi_list_plans`), volná subdoména (`shopzi_check_subdomain`), koncept obchodu (`shopzi_create_store`) a jeho stav (`shopzi_store_creation_status`). Peníze jsou CELÁ ČÍSLA V HALÉŘÍCH (39000 = 390,00 Kč). WEBZI s.r.o. není plátcem DPH, ceny jsou konečné. Koncept nic neúčtuje. Člověk otevře `draft_url` v prohlížeči, zadá `pairing_code`, ověří e-mail, přijme podmínky a uloží kartu; 30 dní zdarma, první platba 31. den. Ukaž mu odkaz i kód, stav pak zjišťuj nástrojem se `status_token`. API klíč k novému obchodu v terminálu nikdy nedostaneš: ukáže se jednou v prohlížeči a patří do konfigurace klienta, ne do chatu. Pak se připoj k serveru MCP obchodu na jeho doméně. Jak se v SHOPZI něco dělá, zjisti nástrojem `shopzi_docs`. Čísla ani ceny si nevymýšlej. ```