MCP rozhraní

Stručně

MitoOps poskytuje standardní vzdálený MCP server (Model Context Protocol) na adrese /api/mcp, přes který si kompatibilní AI aplikace vyžádá data sama. Stojí nad týmiž schopnostmi jako REST — není to druhé rozhraní s vlastními dotazy, je to jiný způsob, jak se zeptat na totéž.

MCP není vlastnost modelu, ale aplikace, ve které model běží (klienta). Připojí se každá aplikace, která podporuje vzdálené MCP přes HTTP s OAuth nebo s přístupovým klíčem. Claude.ai je produkčně ověřený klient — jeho přesný postup je níže; pro jinou aplikaci platí obecný postup v další části. Klienty, které jsme netestovali, neprohlašujeme za ověřené.

Prokázat se dá dvěma způsoby:

• přístupovým klíčem, který si vydáte v aplikaci — pro vlastní program nebo server, který volá server;
• přes OAuth, když se připojuje AI aplikace, která to umí — tehdy se přihlásíte vy a aplikaci na obrazovce souhlasu vyberete, co smí číst.

V obou případech jde token v hlavičce Authorization: Bearer a v obou platí tentýž rozsah oprávnění: co klíč či souhlas nezahrnuje, to nástroj nevrátí.

Nejrychlejší připojení je tlačítko Připojit AI v horní liště aplikace. Vidí ho ten, kdo má oprávnění k přístupovým klíčům. Okno vás provede třemi kroky: vyberete aplikaci (Claude, ChatGPT nebo jinou), zkopírujete adresu MCP s krátkým postupem pro zvolenou aplikaci a ve třetím kroku vidíte stav připojení i věty na vyzkoušení. Odkazem Co smí AI měnit se dostanete na kartu Zápis přes AI, odkazem Spravovat připojení k seznamu připojení. Když váš tarif MCP neobsahuje, okno to řekne a nabídne tarify. Podrobné postupy jsou níže.

Jak připojit Claude.ai — ověřené připojení krok za krokem

Claude.ai se nepřipojuje k jednotlivým e-shopům, ale k MitoOps — k vrstvě, která už data všech vašich e-shopů spojuje.

Nepotřebujete žádný klíč, Client ID ani tajemství. Claude.ai si vše zjistí sám z adresy rozhraní.

1. V Claude.ai otevřete Settings (Nastavení) → Customize → Connectors (na týmovém plánu nejprve Organization settings → Connectors jako správce).
2. Stiskněte Add custom connector (Přidat vlastní konektor).
3. Do pole Name napište MitoOps.
4. Do pole URL vložte adresu rozhraní MCP z okna Připojit AI nebo z obrazovky Nastavení → API & MCP — ve tvaru https://<vaše adresa>/api/mcp, například https://app.mitoops.com/api/mcp.
5. Advanced settings nechte prázdné: Claude.ai použije vlastní hostovaná metadata klienta (OAuth). Stiskněte Add.
6. U konektoru stiskněte Connect (Připojit).
7. Otevře se přihlášení do MitoOps (i s druhým faktorem, pokud jej máte). Přihlaste se.
8. Uvidíte obrazovku souhlasu: která aplikace, který klient, co smí číst a kterých e-shopů se to týká. Oprávnění jsou seskupena podle oblastí aplikace (obchod, sklad, expedice, marketing, partnerský program, automatizace). Čtení je předzaškrtnuté, citlivé údaje a příprava konceptů ne; změny s přímým dopadem (například mazání kupónů nebo schválení rozesílky) jsou jednotlivě ve sbalené části Pokročilá oprávnění. U každé skupiny je seznam toho, co přesně zahrnuje.
9. Zkontrolujte rozsahy. Citlivé (například Výkazy, Nákupní ceny, Osobní údaje zákazníků, Dodavatelé a nákup, Automatizace – návrhy, Dostupnosti: návrhy změn, Recenze: návrhy odpovědí a Reklamace: návrhy změn nastavení) nejsou zaškrtnuté. Pokud má Claude vidět marži, osobní údaje, navrhovat koncepty a úpravy automatizací nebo změny dostupností či nastavení reklamací, zaškrtněte je vědomě. Šablony a nastavení reklamací čte rozsah Reklamace: nastavení a šablony. Vyberte e-shopy.
10. Stiskněte Povolit. Claude.ai se vrátí na svou stránku a konektor je připojen.
11. V rozhovoru stiskněte + → Connectors a konektor MitoOps zapněte.

Konektor připojený před 2. 9. 2026

Pokud jste konektor připojili dříve, má Claude.ai v mezipaměti starší metadata a na obrazovce souhlasu nabízel jen čtyři základní rozsahy. Konektor odpojte (Disconnect) a připojte znovu (Connect): nabídnou se všechny rozsahy včetně citlivých a nových (expedice, analytika, zásoby).

Co si na obrazovce souhlasu zaškrtnete, to platí — a nikdy ne více, než smíte sami. Kdo nemá v aplikaci právo na nákupní ceny, nemá jak je předat dál. Token, který Claude.ai dostane, nese jen povolené rozsahy.

Jiný MCP klient nebo AI aplikace přes OAuth

Aplikaci zadáte tutéž adresu /api/mcp a nic víc — žádný klíč. Dál to jde samo:

1. Aplikace si od nás vyžádá, kam poslat přihlášení (metadata chráněného zdroje podle RFC 9728).
2. Otevře se vaše přihlášení do MitoOps.
3. Uvidíte obrazovku souhlasu a vyberete rozsahy a e-shopy.
4. Po povolení je připojení hotové a aplikace vidí nástroje.

Aplikace, která si rozsahy vybírá sama, je musí uvést v požadavku: obrazovka souhlasu nabídne jen to, oč aplikace požádala (a na co máte právo). Rozhraní inzeruje všechny rozsahy včetně citlivých — ve výzvě WWW-Authenticate i v scopes_supported. Citlivé se přesto nikdy nepovolí samy: na obrazovce souhlasu jsou označené a nezaškrtnuté a token se vydá zúžený na to, co jste povolili (scope v odpovědi tokenu).

Jak se připojuje přístupovým klíčem

Asistent nebo program potřebuje adresu /api/mcp na vaší doméně a přístupový klíč s MCP mezi rozhraními. Přesnou adresu vypisuje obrazovka Nastavení → API & MCP v bloku „Kde to zapojit“. Klíč vydaný jen pro REST na MCP nefunguje a naopak.

Nástroje

Seznam nástrojů se řídí rozsahy klíče nebo souhlasu: asistent uvidí přesně to, co mu bylo povoleno, a nic jiného. Nástroj mimo rozsah pro něj neexistuje.

Nástroj MCP	Rozsah	REST	Co vrátí
account_connection	stores:read	GET /account/connection	Diagnostika tohoto připojení: aplikace, kdo a kdy přístup povolil, udělená a neudělená oprávnění po oblastech, e-shopy a režim zápisu přes AI.
account_entitlements	account:read	GET /account/entitlements	Tarif klienta, funkce a limity s aktuálním využitím.
account_team	team:read	GET /account/team	Tým klienta: jména, role, aktivní účty, poslední přihlášení a kdo koho vede; e-mail jen s oprávněním na osobní údaje.
affiliate_articles_create	affiliate:write	—	zápis: Založení vlastního článku nápovědy ve všech jazycích najednou (název a tělo v zadaném jazyce); HTML se očistí.
affiliate_articles_get	affiliate:read	GET /affiliate/articles/:key	Jeden článek nápovědy se zněním (HTML) ve všech nebo v jednom jazyce; proměnné nedosazené.
affiliate_articles_list	affiliate:read	GET /affiliate/articles	Články nápovědy partnerského portálu: klíč, výchozí/vlastní, zapnutí, pořadí, stav po jazycích.
affiliate_articles_set_state	affiliate:write	—	zápis: Zapnutí nebo vypnutí článku nápovědy pro všechny jazyky najednou; výchozí se nemaže, jen vypíná.
affiliate_articles_update	affiliate:write	—	zápis: Úprava článku nápovědy v jednom jazyce (název, adresa, tělo; HTML se očistí) nebo obnova výchozího znění; vrátí neznámé proměnné.
affiliate_campaigns_create	affiliate:write	—	zápis: Založení kampaně na e-shopu: název, odměna (nevymýšlet), platnost přiřazení, dostupnost, schvalování konverzí.
affiliate_campaigns_get	affiliate:read	GET /affiliate/campaigns/:campaignId	Jedna kampaň partnerského programu.
affiliate_campaigns_list	affiliate:read	GET /affiliate/campaigns	Kampaně partnerského programu e-shopu s odměnou, dostupností a počty.
affiliate_campaigns_update	affiliate:write	—	zápis: Úprava kampaně: název, odměna, platnost, dostupnost, schvalování, zapnutí/vypnutí, popis pro partnery po jazycích.
affiliate_code_requests_decide	affiliate:write	—	zápis: Vyřízení žádosti partnera o vlastní kód: zamítnutí s důvodem (partner dostane e-mail). Schválení a opakování založí kód na celý e-shop, proto je z AI neprovede nikdo: žádost čeká na člověka v aplikaci.
affiliate_code_requests_list	affiliate:read	GET /affiliate/code-requests	Žádosti partnerů o vlastní slevový kód se stavem a důvodem; čekající první.
affiliate_conversions_decide	affiliate:approve	—	zápis: Rozhodnutí o jedné provizi podle id: approve (nová → schválená), reject (nová → zamítnutá, důvod povinný), cancel (schválená → zrušená, důvod povinný); vyplacená se nevrací, stejné rozhodnutí podruhé nic nemění; partner dostane e-mail.
affiliate_conversions_get	affiliate:read	GET /affiliate/conversions/:conversionId	Detail jedné konverze: částky, provize, stav provize s důvodem, stav objednávky v e-shopu, dobropis, výplata.
affiliate_conversions_list	affiliate:read	GET /affiliate/conversions	Konverze partnerského programu e-shopu: základ provize a celá objednávka s DPH, provize, stav provize s důvodem, stav objednávky v e-shopu, vazba na výplatu.
affiliate_discount_codes_ensure	coupons:write	—	zápis: Ať má partner na e-shopu slevový kód: rozsah je povinný, nejdřív náhled, pak potvrzení; kupón se založí přes kanonické kupóny (nebo se použije existující) a přiřadí partnerovi. Podle režimu AI zápisu (Kupóny): při Ručním schválení se uloží návrh pro člověka; kód na celý e-shop vždy schvaluje člověk.
affiliate_discount_codes_list	affiliate:read	GET /affiliate/discount-codes	Slevové kódy partnerů na e-shopu s počtem použití a obratem.
affiliate_documents_draft_create	affiliate:write	—	zápis: Návrh nového znění právního dokumentu jako koncept; živé znění nemění — zveřejní ho člověk v aplikaci s rozdílem a auditem.
affiliate_documents_get	affiliate:read	GET /affiliate/documents/:key/content	Jeden právní dokument programu se zněním po jazycích (uložený text, veřejné znění, verze, otisky, zdroj, PDF metadata) a otevřenými koncepty.
affiliate_documents_list	affiliate:read	GET /affiliate/documents	Dokumenty programu (podmínky, dohody): politika potvrzení, podepsaná kopie, příloha e-mailu, verze po jazycích, připravenost a počty potvrzení.
affiliate_documents_update	affiliate:write	—	zápis: Politika dokumentu programu (pro koho platí, kdy se potvrzuje, způsob potvrzení: seznámení / elektronický podpis / nahraná kopie, příloha e-mailu, zapnutí); znění se nahrává v aplikaci.
affiliate_email_templates_list	affiliate:read	GET /affiliate/email-templates	Šablony e-mailů partnerům po jazycích (předmět, zapnutí, s událostí i tělo) a automatické přílohy e-mailu Účet schválen.
affiliate_email_templates_update	affiliate:write	—	zápis: Úprava šablony e-mailu partnerům v jednom jazyce (předmět, tělo) nebo zapnutí/vypnutí události.
affiliate_links_generate	affiliate:read	GET /affiliate/links/generate	Sledovaný partnerský odkaz na domov, produkt nebo kategorii e-shopu kampaně; po kliknutí zachová přiřazení partnerovi.
affiliate_partners_get	affiliate:read	GET /affiliate/partners/:partnerId	Jeden partner programu s kampaněmi, které má k dispozici.
affiliate_partners_list	affiliate:read	GET /affiliate/partners	Partneři programu se stavem, výkonem a provizemi; kontakt jen s osobními údaji.
affiliate_partners_set_market	affiliate:write	—	zápis: Členství partnera v e-shopu: povolit (active, schválí i žádost z portálu) nebo odebrat (revoked); kampaně, kupóny a dokumenty e-shopu se partnera týkají jen s aktivním členstvím.
affiliate_partners_set_state	affiliate:write	—	zápis: Rozhodnutí o účtu partnera (schválit, zamítnout, pozastavit, vrátit mezi čekající); schválení pošle e-mail s dohodou.
affiliate_payouts_list	affiliate:read	GET /affiliate/payouts	Výplaty provizí partnerům se stavem; bez bankovních a fakturačních údajů.
affiliate_portal_get	affiliate:read	GET /affiliate/portal	Veřejný portál partnera: adresy po e-shopech, otevřenost registrace s důvodem, vlastní domény, kontaktní osoba, vzhled a stav textů po jazycích.
affiliate_portal_pages_update	affiliate:write	—	zápis: Vlastní texty veřejného portálu v jednom jazyce (stránky přihlášení/registrace/přehled, poučení, popis programu); HTML se očistí.
affiliate_settings	affiliate:read	GET /affiliate/settings	Nastavení partnerského programu: provize, kliky, minimum výplaty, přivedení.
affiliate_settings_update	affiliate:write	—	zápis: Nastavení programu mimo peněz: název, registrace, automatické schvalování, kontaktní osoba, barvy, odkaz na zásady.
affiliate_signatures_get	affiliate:read	GET /affiliate/signatures/:signatureId	Jeden elektronický podpis s podepsaným zněním a snímkem hodnot; neměnný záznam, PDF se skládá v aplikaci.
affiliate_signatures_list	affiliate:read	GET /affiliate/signatures	Elektronicky podepsané dokumenty partnerů (kdo, dokument, verze, jazyk, e-shop, čas, způsob, ověření, otisky, stav) a partneři, kterým podpis chybí; jen čtení — podpis vzniká výhradně v portálu.
affiliate_statistics	affiliate:read	GET /affiliate/statistics	Statistika partnerského programu: vývoj po dnech, zdroje přiřazení, žebříček partnerů.
affiliate_summary	affiliate:read	GET /affiliate/summary	Přehled partnerského programu e-shopu za období: kliky, konverze, provize, partneři.
affiliate_variables_list	affiliate:read	GET /affiliate/variables	Registr proměnných obsahu a e-mailů partnerského programu: kanonická jména, aliasy, typ, plochy, příklad; volitelná kontrola textu na neznámé proměnné.
ai_instructions_get	ai-instructions:read	—	Instrukce AI modulu (AI Copywriter, webový chatbot e-shopu, interní asistent) ke čtení.
brand_soul_change_draft	brand-soul:draft	—	zápis: NÁVRH změny Srdce e-shopu s očekávanou verzí; platným ho udělá jen člověk schválením v MitoOps.
brand_soul_get	brand-soul:read	—	Srdce e-shopu: profil značky pro AI nástroje, účinné hodnoty e-shopu s původem, verze, čekající návrh a připravenost.
analytics_advertising	reports:read	GET /analytics/advertising	Reklama: výdaje, rozpočet, ROAS, PNO, CPA, průměrná objednávka a MER se srovnáním; Google Ads, Meta Ads a OpenAI Ads, prokliky z GA4, 6 měsíců.
analytics_channels	analytics:read	GET /analytics/channels	Kanály návštěvnosti včetně ChatGPT a dalších AI zdrojů.
analytics_comparison	reports:read	GET /analytics/comparison	Obraty se srovnáním: obrat, objednávky, AOV, návštěvy, CR a AI/LLM proti předchozímu období nebo roku.
analytics_daily	reports:read	GET /analytics/daily	Obrat a objednávky po dnech (nejvýše 92 dní), součet za e-shopy nebo jeden e-shop.
analytics_funnels_catalog	analytics-funnels:read	GET /analytics/funnels/catalog	Události, parametry a vlastnosti uživatele z GA4 e-shopu pro nastavení trychtýře.
analytics_funnels_change	analytics-funnels:write	—	zápis: Založí, upraví nebo archivuje trychtýř z GA4. Náhled, zápis s potvrzením; MCP jen se zapnutým „Autonomní provedení“ pro Trychtýře.
analytics_funnels_get	analytics-funnels:read	GET /analytics/funnels/:id	Trychtýř za období: návštěvníci kroků z GA4, nákupy a obrat z objednávek, rozdělení podle kanálů, srovnání.
analytics_funnels_list	analytics-funnels:read	GET /analytics/funnels	Trychtýře z GA4 (například kvíz na webu): kroky, značka návštěvníka, stav a poslední načtení.
analytics_monthly	reports:read	GET /analytics/monthly	Obrat, objednávky a návštěvy po měsících (nejvýše 24), například rok k roku.
analytics_order_coverage	analytics:read	GET /analytics/order-coverage	Pokrytí objednávek měřením; bez e-shopu součet za e-shopy a rozpis po e-shopech.
analytics_order_heatmap	reports:read	GET /analytics/order-heatmap	Kdy přicházejí objednávky: den v týdnu × hodina, nejsilnější den a hodina.
analytics_overview	analytics:read	GET /analytics/overview	Návštěvy, objednávky, obrat, konverzní poměr, AOV, podíl AI zdrojů.
analytics_revenue_sources	reports:read	GET /analytics/revenue-sources	Odkud přišly tržby: kanály, součty AI/LLM, MitoOps a Affiliate, rozpad akvizice podle GA4.
analytics_seo	analytics:read	GET /analytics/seo	Search Console podle dotazů nebo stránek.
approvals_pending	approvals:read	GET /approvals/pending	Co čeká na schválení člověkem: kroky AI v Deníku AI změn a Návrhy od AI.
automations_catalog	automations:read	GET /automations/catalog	Katalog automatizací: spouštěče, pole podmínek, operátory, akce, šablony a catalogVersion.
automations_create_draft	automations:write	—	zápis: Vytvoří VYPNUTÝ koncept automatizace. Nezapíná ani nespouští.
automations_get	automations:read	GET /automations/:workflowId	Jedna automatizace s DSL a výsledkem validace.
automations_list	automations:read	GET /automations	Automatizace klienta se stavem a rozsahem e-shopů.
automations_options	automations:read	GET /automations/options	Číselník pro pole automatizace (stavy, dopravy, platby, šablony, reklamace…): hodnota do DSL a název.
automations_revision_create_draft	automations:write	—	zápis: Navrhne úpravu zveřejněné automatizace jako revizi ke schválení člověkem; běžící verze se nemění.
automations_revision_discard_draft	automations:write	—	zápis: Stáhne otevřenou revizi zveřejněné automatizace.
automations_revision_update_draft	automations:write	—	zápis: Upraví otevřenou revizi zveřejněné automatizace.
automations_runs	automations:read	GET /automations/:workflowId/runs	Historie běhů jedné automatizace.
automations_templates	automations:read	GET /automations/templates	Hotové vzory automatizací s DSL.
automations_update_draft	automations:write	—	zápis: Upraví nepublikovaný koncept automatizace s optimistickou souběžností.
automations_validate_draft	automations:read	—	Ověří návrh automatizace bez zápisu.
campaigns_discount_compute	campaign-rules:read	GET /campaigns/discount-compute	Skutečná sleva z plné ceny při akci a kódu (násobí se), nebo dopočet druhé části k cílové slevě; porovnání s limitem e-shopu.
campaigns_discount_rules	campaign-rules:read	GET /campaigns/discount-rules	Pravidla slev e-shopů: zda je limit zapnutý, nejvyšší souhrnná sleva z plné ceny, rozsah, režim a provize partnerů.
campaigns_discount_rules_configure	campaign-rules:write	—	zápis: Změní pravidlo slev e-shopu: nejprve náhled před a po, zápis až s potvrzením. Stávající kódy a ceny se nemění.
chatbot_conversations_get	chatbot-conversations:read	GET /chatbot/conversations/:sessionId	Přepis jednoho rozhovoru s webovým chatbotem i se zdroji odpovědí bota.
chatbot_conversations_list	chatbot-conversations:read	GET /chatbot/conversations	Rozhovory zákazníků s webovým chatbotem od naposledy aktivního, s první otázkou; kurzor.
chatbot_outcomes	chatbot:read	GET /chatbot/outcomes	Jak dopadly rozhovory s webovým chatbotem: odkdy se výsledek měří, měřené a neměřené rozhovory, známý a neznámý výsledek, vyřešené, nevyřešené, chyba bota a míra vyřešení se jmenovatelem; při nulovém jmenovateli N/A s důvodem. Jen součty.
chatbot_stats	chatbot:read	GET /chatbot/stats	Statistika webového chatbota za období: trychtýř bublinky z jednoho měření (starší počty jdou vedle jako historické), míra otevření chatu, rozhovory, výsledek na úrovni rozhovoru, hodnocení.
chatbot_topics	chatbot:read	GET /chatbot/topics	O čem byly rozhovory: podíly témat z uzavřené taxonomie, míra vyřešení a kandidáti na mezeru ve znalostech podle tématu, nejčastější produkty, typ stránky začátku a vývoj po dnech. Součet podílů se počítá ze zanalyzovaných rozhovorů a ten počet jde ven také. Jen součty.
claims_config_change_draft	claims-settings:draft	—	zápis: Navrhne změnu procesů, stavů, štítků, šablon, textů formuláře a nastavení modulu reklamací; zapíše ji až člověk schválením v aplikaci.
claims_config_draft_get	claims-settings:read	GET /claims/config-drafts/:draftId	Stav návrhu změny nastavení reklamací (čeká, zapsaný, zamítnutý).
claims_configuration	claims-settings:read	GET /claims/configuration	Nastavení reklamací: štítky, pole, zpětná doprava, formulář na e-shopu, typy formuláře.
claims_deadlines	claims:read	GET /claims/deadlines	Otevřené reklamace podle lhůty: po lhůtě a blízko lhůty, od nejnaléhavější, s počty po e-shopech.
claims_get	claims:read	GET /claims/:code	Jedna reklamace s položkami, refundacemi, zpětnými zásilkami, štítky, časovou osou a odeslanými e-maily.
claims_list	claims:read	GET /claims	Reklamace a vrácení jednoho e-shopu s vazbami na objednávku.
claims_refund_options	claims-settings:read	GET /claims/refund-options	Vrácení peněz: zdroj variabilního symbolu, platnost refundačního kuponu, kupon ve formuláři, kdy formulář žádá číslo účtu.
claims_refund_readiness	claims:read	GET /claims/:code/refund-readiness	Případ před refundací: co zákazník žádá, maskovaný účet, variabilní symbol, režim a zda lze případ smazat.
claims_refund_settings	claims-settings:read	GET /claims/refund-settings	Refundace reklamací: režim, bankovní účty se způsobilostí pro platební příkaz (maskované), výchozí a ruční účet.
claims_routes	claims-settings:read	GET /claims/routes	Zpětná doprava reklamací: trasy, adresy, profily dopravců s ID a podporou vratky, typy případů.
claims_routes_change_draft	claims-routes:draft	—	zápis: Navrhne zpětnou trasu (i pro celou EU nebo svět) a adresu příjemce; zapíše je člověk schválením (nebo autonomní zápis, pokud ho klient zapnul).
claims_settings	claims:read	GET /claims/settings	Procesy reklamací s ID a názvy (typy, kroky, stavy, lhůty), štítky; nastavení modulu s rozsahem claims-settings:read.
claims_statistics	claims:read	GET /claims/statistics	Statistika reklamací a vrácení za období: počty, doby vyřízení, typy, hodnocení, důvody.
claims_templates	claims-settings:read	GET /claims/templates	Šablony e-mailů (předmět, text, kdy a zda se posílají automaticky) a protokolů reklamací.
content_articles_search	products:read	GET /content/articles	Články blogu a obsah e-shopu z canonical zrcadla podle názvu nebo textu.
coupons_activation_link	coupons:read	GET /coupons/activation-link	Odkaz, který zákazníkovi uplatní EXISTUJÍCÍ kupón v košíku. Kupón nevytváří.
coupons_activation_status	coupons:read	GET /coupons/activation-status	Dá se kupón na e-shopu použít přes aktivační odkaz: zrcadlo kupónu + stav kódu na webu.
coupons_capabilities	coupons:read	GET /coupons/capabilities	Co o kupónech umí platforma daného e-shopu. Čtěte před zakládáním.
coupons_ensure	coupons:write	—	zápis: Ať kupón na vybraných e-shopech existuje; rozsah (kategorie, produkty nebo výslovně celý e-shop) je povinný, nejdřív náhled, pak potvrzení. Při jiné výši slevy se NEPŘEPÍŠE. Podle režimu AI zápisu (Kupóny): při Ručním schválení se uloží návrh pro člověka; kupón na celý e-shop vždy schvaluje člověk.
coupons_get	coupons:read	GET /coupons/:code	Jeden kupón podle kódu.
coupons_list	coupons:read	GET /coupons	Slevové kupóny e-shopu s typem a výší slevy, platností a odvozeným stavem.
coupons_remove	coupons:delete	—	zápis: Nevratné smazání kupónu na vybraném e-shopu: bez potvrzení jen náhled se závislostmi, s potvrzením smazání; kupón se živou závislostí se nesmaže. Podle režimu AI zápisu (Kupóny): při Ručním schválení se uloží návrh pro člověka.
coupons_templates_cleanup	coupons:delete	—	zápis: Úklid nepoužitých šablon kupónů, které založil MitoOps, na e-shopu; šablony obchodníka a použité šablony zůstávají. Náhled, smazání s potvrzením. Podle režimu AI zápisu (Kupóny): při Ručním schválení se uloží návrh pro člověka.
coupons_update	coupons:write	—	zápis: Výslovná úprava existujícího kupónu včetně omezení na produkty a kategorie; náhled, potom potvrzení. Podle režimu AI zápisu (Kupóny): při Ručním schválení se uloží návrh pro člověka; kupón na celý e-shop vždy schvaluje člověk.
coupons_web_box_overview	coupons:read	GET /coupons/web-box	Rámečky s cenou po zadání kódu u produktů na e-shopu: hlavní vypínač, kupóny, nastavení a stav.
coupons_web_box_preview	coupons:read	—	Ukáže, jak bude karta produktu na webu vypadat s rámečkem ceny po zadání kódu podle navrženého nastavení; jen čtení, nic nemění.
coupons_web_box_set	coupons:write	—	zápis: Zapne, vypne nebo upraví rámeček s cenou po zadání kódu pro existující kupón; náhled, pak potvrzení. Podle režimu AI zápisu (Kupóny): při Ručním schválení se uloží návrh pro člověka.
coupons_web_box_stats	coupons:read	GET /coupons/web-box/stats	Zobrazení rámečku, kopie kódu a uplatnění v košíku podle kupónu a produktu.
customers_get	customers:read	GET /customers/:customerKey	Jeden zákazník z adresáře — identita, e-shopy, celoživotní i volitelné peníze za období, rozpis podle e-shopu.
customers_list	customers:read	GET /customers	Adresář zákazníků: identita (s maskováním osobních údajů), e-shopy, jazyk, celoživotní počty a obrat po měnách; volitelný filtr nákupní aktivity v období.
customers_performance	reports:read	GET /customers/performance	Zákazníci jako pseudonymy: objednávky, obrat, LTV, noví a opakovaní.
credit_notes_search	invoices:read	GET /credit-notes	Hledání v dobropisech.
documents_list	invoices:read	GET /documents	Účetní doklady jednoho druhu (faktury, zálohové faktury, dobropisy) po stránkách s životním cyklem, stavem ve zdroji, filtrem platnosti a dostupností PDF.
documents_pdf_link	invoices:read	—	Krátkodobý odkaz (10 minut) na PDF faktury, zálohové faktury nebo dobropisu k otevření v prohlížeči.
invoices_get	invoices:read	GET /invoices/:invoiceCode	Jedna faktura s položkami dokladu, dobropisy, zálohovými fakturami a číslem objednávky.
invoices_search	invoices:read	GET /invoices	Hledání ve fakturách; filtr úhrady (zaplacené, nezaplacené, po splatnosti) s počtem a součtem po e-shopech.
payments_matching	payments:read	GET /payments/matching	Párování přijatých plateb s objednávkami: počty podle výsledku a nespárované, nejednoznačné a chybné platby.
inventory_movements	inventory:read	GET /inventory/movements	Historie skladových pohybů: kdy, co, o kolik, druh, původ, objednávka.
inventory_product_availability	inventory:read	GET /inventory/availability	Stav zásoby více položek najednou.
inventory_product_statistics	inventory:read	GET /inventory/product-statistics	Po produktech za období: stav skladu, prodané, reklamované a vrácené kusy, míra reklamací.
inventory_stock	inventory:read	GET /inventory/stock	Stav zásoby jedné položky i se zdrojem hodnoty.
inventory_sync_status	stock-sync:read	GET /inventory/sync-status	Stav synchronizace skladu mezi e-shopy: fronta, konflikty, poslední běh a kontrola shody, mapování, zdraví spojení.
inventory_valuation	inventory:read	GET /inventory/valuation	Hodnota skladu jako obrazovka: nákupní a prodejní hodnota, hrubý a čistý potenciál, pod minimem, záporné, největší položky; bez sad a balíčků.
messaging_deliveries	messaging:read	GET /messaging/deliveries	Doručení e-mailů k zásilkám, objednávkám, reklamacím a partnerům: souhrn, stavy a chyby (odražené, spam, zablokované).
notifications_list	notifications:read	GET /notifications	Upozornění ze zvonečku: co hlásí moduly, závažnost, stav, počet nepřečtených a obrazovka, která to řeší.
orders_get	orders:read	GET /orders/:orderCode	Jedna uložená objednávka včetně položek.
orders_line_discounts	orders:read	GET /orders/:orderCode/line-discounts	Historické ceny a slevy po položkách objednávky: původní cena, sleva, kupon, zaplacená hodnota a spolehlivost.
orders_list	orders:read	GET /orders	Uložené objednávky, od nejnovější; filtr stavu, hledání, úhrada, období a úplný počet ve filtru.
orders_packing_queue	orders:read	GET /orders/packing-queue	Fronta balení podle stavů, které si klient nastavil jako připravené k zabalení: počet a objednávky po e-shopech.
availabilities_change_draft	availabilities:draft	—	zápis: NÁVRH změny číselníku dostupností (založit, upravit, smazat). Do e-shopu ho zapíše až člověk schválením v MitoOps.
availabilities_draft_get	products:read	GET /availabilities/drafts/:draftId	Stav návrhu změny číselníku dostupností: čeká na schválení, zapsaný s výsledkem, zamítnutý, vypršelý.
availabilities_history	products:read	GET /availabilities/history	Historie synchronizace dostupností: co se z kterého e-shopu přeneslo kam a s jakým výsledkem; období, kurzor.
availabilities_list	products:read	GET /availabilities	Číselník dostupností e-shopu: název, popis, naskladnění, doručení, význam pro Google, barva, výchozí role.
availabilities_pairing	products:read	GET /availabilities/pairing	Párování dostupností mezi e-shopy: řádky s položkou každého e-shopu, návrhy, nespárované, stav synchronizace.
availabilities_pairing_change_draft	availabilities:draft	—	zápis: NÁVRH změny párování dostupností (buňka, vlastní řádek). Uloží ho až člověk schválením v MitoOps; synchronizaci nezapíná.
availabilities_pairing_draft_get	products:read	GET /availabilities/pairing-drafts/:draftId	Stav návrhu změny párování dostupností: čeká na schválení, uložený, zamítnutý, vypršelý.
catalog_reconcile	products:write	—	zápis: Sladí zrcadlo katalogu s e-shopem: produkty a kategorie, které e-shop prokazatelně nemá (dvě nezávislá pozorování), dostanou v MitoOps náhrobek. Náhled s důkazy, zápis s potvrzením.
categories_content_change_draft	category-content:draft	—	zápis: NÁVRH nových textů kategorií (nejvýše 30 najednou); do e-shopu je zapíše až člověk schválením v MitoOps.
categories_content_draft_get	category-content:read	GET /catalog/category-content-drafts/:draftId	Stav návrhu textů kategorií: čeká na schválení, zapsaný, zamítnutý, vypršelý.
categories_content_get	category-content:read	GET /categories/:guid/content	Texty kategorie (horní a dolní popis, SEO titulek a popis) s otiskem a zapisovatelností pole.
categories_create	categories:write	—	zápis: Založí kategorii e-shopu (výchozí skrytou). Nejdřív náhled, zápis s potvrzením.
categories_get	category-content:read	GET /categories/:guid	Jedna kategorie s živým stavem z e-shopu včetně viditelnosti (true/false, null = platforma ji nevede) a plánů od–do.
categories_list	products:read	GET /categories	Kategorie e-shopu s počtem produktů, po stránkách s úplným počtem.
categories_products_assign	product-categories:write	—	zápis: Hromadně přidá produkty do kategorie nebo je z ní odebere (seznam kódů nebo jednorázově ze zdrojové kategorie). Náhled s počty, zápis s potvrzením, výsledek po produktech a opakování neúspěšných.
categories_products_list	products:read	GET /categories/:guid/products	Produkty zařazené v kategorii, stránkovaně, živě z e-shopu (při výpadku ze zrcadla s označením zdroje).
categories_remove	categories:write	—	zápis: Smaže jen prázdnou kategorii (bez produktů a podkategorií), jinak doporučí skrytí. Náhled, zápis s potvrzením.
categories_update	categories:write	—	zápis: Upraví kategorii: název, nadřazenou, adresu, viditelnost, texty, SEO a obrázek; jen změněná pole. Náhled před a po, zápis s potvrzením.
categories_visibility_plan	categories:write	—	zápis: Plán zobrazení kategorie od–do nebo jeho zrušení. Náhled, zápis s potvrzením.
categories_visibility_plans_list	category-content:read	GET /categories/visibility-plans	Plány zobrazení kategorií od–do: čas, stav, původní viditelnost, poslední zápis a chyba.
product_logistics_get	product-logistics:read	GET /product-logistics/:code	Hmotnost a rozměry prodejního balení varianty živě z e-shopu (kg, cm), zděděná pole, revize a poslední zápisy.
product_logistics_list_missing	product-logistics:read	GET /product-logistics/missing	Kódy e-shopu bez hmotnosti nebo rozměrů (nebo s neověřenými jednotkami); s codes hodnoty z kopie se zdrojem a jistotou.
product_logistics_update_confirmed	product-logistics:write	—	zápis: Zápis hmotnosti a rozměrů prodejního balení varianty do e-shopu po náhledu s potvrzením a revizí; čtení zpět z e-shopu.
product_logistics_update_preview	product-logistics:read	—	Náhled změny hmotnosti a rozměrů bez zápisu: před a po, varování (jednotky, doprava v pokladně, 30 kg), revize.
products_availability_update	product-stock:write	—	zápis: Změní dostupnost produktu skladem a po vyprodání a objednávání po vyprodání; počet kusů ne. Náhled, zápis s potvrzením.
products_categories_get	products:read	GET /products/:code/categories	Všechny kategorie produktu po e-shopech živě z e-shopu: hlavní a další zařazení včetně skrytých kategorií.
products_categories_update	product-categories:write	—	zápis: Přidá a odebere další kategorie produktu a volitelně změní hlavní; ostatní zařazení zachová. Náhled před a po, zápis s potvrzením.
products_category_assign	product-categories:write	—	zápis: Změní hlavní kategorii produktu na vybraných e-shopech. Náhled před a po, zápis s potvrzením.
products_changes	products:read	GET /products/changes	Deník změn karty produktu: pole, e-shop, kdy, odkud a náhled staré a nové hodnoty; ceny jen s oprávněním.
products_content_change_draft	product-content:draft	—	zápis: NÁVRH nových textů produktů (nejvýše 30 najednou); do e-shopu je zapíše až člověk schválením v MitoOps.
products_content_draft_get	product-content:read	GET /catalog/product-content-drafts/:draftId	Stav návrhu textů produktů: čeká na schválení, zapsaný s upozorněními e-shopu, zamítnutý, vypršelý.
products_content_get	product-content:read	GET /products/:code/content	Texty produktu z e-shopu (popis, krátký popis, SEO titulek a popis) s otiskem a zapisovatelností pole.
products_content_policy	product-content:read	GET /product-content/policy	Politika obsahu na e-shopu bez volání e-shopu: co tento přístup smí číst a navrhovat, která pole platforma zapíše, režim schvalování a autonomní zápis, limity a otisky.
products_create	products:write	—	zápis: Založí nový produkt na vybraných e-shopech, vždy SKRYTÝ; zveřejní ho člověk. Náhled, zápis s potvrzením.
products_gallery_edit	product-gallery:write	—	zápis: Galerie produktu jako v editoru: přidat z adresy https, nahradit, odebrat, pořadí, hlavní obrázek, popis. Náhled, zápis s potvrzením.
products_get	products:read	GET /products/:code	Jeden produkt podle kódu včetně zařazení a ceny z karty.
products_offer	products:read	GET /products/:code/offer	Nabídka produktu v e-shopu: zda ho e-shop ještě má, viditelnost, objednatelnost, dostupnost a cena s měnou, DPH a cenou v prodejní měně e-shopu.
products_prices_update	product-prices:write	—	zápis: Změní ceny produktu (cena, přeškrtnutá, akční s datem od a do, koeficient; nákupní jen s právem). Náhled před a po, zápis s potvrzením.
products_remove	products:write	—	zápis: Nevratné smazání produktu, jen živě skrytého, bez zásoby a bez prodejů (např. testovacího). Náhled, smazání s potvrzením.
products_search	products:read	GET /products	Hledání produktů podle názvu, kódu, EAN nebo PLU; filtr kategorie, aktivity a pod minimem s úplným počtem; stav v e-shopu, produkty smazané v e-shopu jen na vyžádání.
products_update	products:write	—	zápis: Upraví produkt na vybraných e-shopech: název, texty a SEO, identifikátory a údaje výrobce; ceny, dostupnost ani zařazení ne. Náhled před a po, zápis s potvrzením.
products_visibility_get	products:read	GET /products/:code/visibility	Živý stav produktu po e-shopech: viditelnost (i surový stav platformy), objednatelnost a indexovatelnost ke čtení, běžící plán od–do.
products_visibility_plans_list	products:read	GET /catalog/products/visibility-plans	Plány viditelnosti produktů od–do: čas, stav, původní stav e-shopu, poslední zápis, chyba a poslední kolo plánovače.
products_visibility_plan	product-visibility:write	—	zápis: Plán viditelnosti produktu od–do nebo jeho zrušení s režimem (safe nic nezveřejní). Náhled, zápis s potvrzením.
products_visibility_update	product-visibility:write	—	zápis: Skryje nebo zobrazí produkt na vybraných e-shopech; objednatelnost ani indexování nemění. Náhled ze živého stavu, zápis s potvrzením a kontrolním čtením.
reports_cost_groups	reports:read	GET /reports/cost-groups	Kategorie a štítky nákladů a rozložení skupin v Nákladech.
reports_costs_change	report-costs:write	—	zápis: Založí, upraví nebo vyřadí ruční náklad. Náhled, zápis s potvrzením; provede asistent po schválení karty nebo MCP se zapnutým „Autonomní provedení“ pro Náklady.
reports_costs_list	reports:read	GET /reports/costs	Ruční i automatické náklady s částkou, která se započte do období; firemní i po e-shopech.
reports_export_create	report-exports:write	—	zápis: Vygeneruje report (xlsx, docx, pdf) za období; vrátí runId, soubor se stáhne přes REST. Data nemění.
reports_financial_summary	reports:read	GET /reports/financial-summary	Finanční souhrn období; s purchase-prices:read i nákup, hrubý zisk a marže.
reports_history_get	reports:read	GET /reports/history/:runId	Stav jednoho exportu a jeho soubory s adresou ke stažení přes REST.
reports_history_list	reports:read	GET /reports/history	Historie vygenerovaných reportů se soubory, velikostí a SHA256.
reports_layout_get	reports:read	GET /reports/layout	Rozložení exportu reportu: obálka, pořadí a zapnutí listů a sekcí, zlomy stran.
reports_layout_update	reports:write	—	zápis: Uloží rozložení exportu (pořadí a zapnutí listů a sekcí). Náhled, zápis s potvrzením.
reports_notes_get	reports:read	GET /reports/notes	Poznámka k reportům, která jde do výkazu ve Wordu a PDF.
reports_notes_update	reports:write	—	zápis: Přepíše poznámku k reportům (HTML se očistí). Náhled, zápis s potvrzením.
reports_order_status_rules	reports:read	GET /reports/order-status-rules	Které stavy objednávek se počítají do obratu, po e-shopech, s počtem a obratem ve stavu.
reports_summary_all	reports:read	GET /reports/summary-all	Souhrn více e-shopů jako u „Všechny“: celek, rozpad po e-shopech, firemní náklady jednou, computedAt a dataAsOf.
sales_order_performance	reports:read	GET /sales/order-performance	Obrat po objednávkách se součty za celé období; s purchase-prices:read i nákup, zisk a marže.
sales_product_performance	reports:read	GET /sales/product-performance	Prodeje po produktech se součty za celé období.
reviews_get	reviews:read	GET /reviews/:kind/:reviewId	Jedna recenze s historií odpovědí, jazykem, tónem a podpisem e-shopu a čekajícím návrhem odpovědi.
reviews_list	reviews:read	GET /reviews	Recenze obchodu a produktů jednoho e-shopu: hvězdičky, text, produkt, odpověď e-shopu, čekající návrh; filtry a období.
reviews_reply_create_draft	reviews:draft	—	zápis: NÁVRH odpovědi na recenzi. Na web ho zveřejní až člověk schválením v MitoOps (nebo autonomní režim, pokud ho vlastník zapnul).
reviews_reply_draft_get	reviews:read	GET /reviews/reply-drafts/:draftId	Stav návrhu odpovědi na recenzi: čeká na schválení, zveřejněný, zamítnutý, vypršelý.
reviews_statistics	reviews:read	GET /reviews/statistics	Statistika recenzí e-shopu za období: počet, bez odpovědi, průměr, počet podle hvězdiček a po druzích.
reviews_web_overview	reviews:read	GET /reviews/web-display	Blok recenzí na stránce produktu (skript na webu): zda je zapnutý, podpora platformy a nastavení.
reviews_web_set	reviews-web:write	—	zápis: Zapne, vypne nebo upraví blok recenzí na stránce produktu; náhled, pak potvrzení. Do e-shopu nic nezapisuje.
search_console_query	search-console:read	GET /search-console/query	Search Console po dnech, dotazech, stránkách, zemích a zařízeních, se stránkováním a otiskem obsahu.
search_console_status	search-console:read	GET /search-console/status	Stav Search Console e-shopu: připojení, property, oprávnění, synchronizace a rozsah archivu.
shipping_carriers	shipping:read	GET /shipping/carriers	Připojení dopravci a profily, bez přístupových údajů.
shipping_overview	shipping:read	GET /shipping/overview	Přehled expedice: k zabalení, čeká na předání, na cestě, chyby dopravce, dobírky, s rozpisem po e-shopech.
shipping_packing_performance	shipping:read	GET /shipping/packing-performance	Výkon balení podle lidí: počet zabalených objednávek, čas balení (průměr a medián), čas do zabalení a do předání, srovnání s týmem.
shipping_pickups	shipping:read	GET /shipping/pickups	Svoz po dopravcích: do kdy objednat, do kdy převzetí, co čeká na svoz a objednané svozy.
shipping_returns	shipping:read	GET /shipping/returns	Zpětné zásilky (vratky) se stavem a reklamací, součty na cestě a nevyřízené po e-shopech.
shipping_shipment_detail	shipping:read	GET /shipping/shipments/:shipmentId	Jedna zásilka se všemi událostmi sledování.
shipping_shipments	shipping:read	GET /shipping/shipments	Zásilky s dopravcem, zemí, časem předání a doručení, po stránkách.
shipping_stats	shipping:read	GET /shipping/stats	Statistiky doručování po dopravcích: počty, úspěšnost, medián a p90 doručení, země.
stores_integration_status	stores:read	GET /stores/integration-status	Stav MitoOps kódu na webu po e-shopech: nainstalováno, verze, moduly, připravenost kupónu z odkazu.
stores_list	stores:read	GET /stores	Seznam e-shopů klienta i s jejich kódem.
purchasing_advisor	purchasing:read	GET /purchasing/advisor	Nákupní návrh: co doobjednat a kolik, naléhavost, stav, minimum a odhad potřeby; globálně za jeden sklad.
suppliers_get	purchasing:read	GET /suppliers/:supplierId	Jeden dodavatel s nabídkami a nákladovými složkami.
suppliers_list	purchasing:read	GET /suppliers	Dodavatelé s nabídkami a nákladovými složkami, po stránkách s úplným počtem.
webhooks_deliveries	webhooks:read	GET /webhooks/endpoints/:endpointId/deliveries	Deník doručení jednoho endpointu bez těla.
webhooks_endpoint	webhooks:read	GET /webhooks/endpoints/:endpointId	Jeden webhook endpoint s počtem čekajících doručení.
webhooks_endpoints	webhooks:read	GET /webhooks/endpoints	Webhook endpointy klienta bez tajemství a stav fronty.
webhooks_events	webhooks:read	GET /webhooks/events	Katalog událostí odchozích webhooků, obálka a podpis.

Jméno, e-mail, telefon a ulice zákazníka jsou v orders_list, orders_get, claims_list a claims_get jen s rozsahem personal-data:read; bez něj odpověď nese zemi a město. Totéž platí pro kontakt dodavatele a partnera programu (affiliate_partners_*). Rozsah nemá vlastní nástroj.

V adresáři zákazníků (customers_list, customers_get) rozhoduje tentýž rozsah o jménu, firmě, e-mailu, telefonu a marketingovém pohlaví; bez něj zůstane pseudonym, e-shopy, země, jazyk, počty a data. Obrat a LTV jsou navíc za reports:read. Marketingové pohlaví je odhad z křestního jména (genderSource: "name_inference"), ne údaj, který by zákazník uvedl — asistent ho tak má i podávat. Bankovní a daňové údaje partnerů se nevydávají nikdy.

Webový chatbot — témata rozhovorů. chatbot_topics (tentýž rozsah chatbot:read) odpoví jedním voláním na otázku „o čem to bylo“: podíl rozhovorů podle témat z uzavřené taxonomie, míra vyřešení a počet kandidátů na mezeru ve znalostech podle tématu, nejčastější produkty (na které se zákazníci ptali a které bot doporučil), z jakého typu stránky rozhovory začínají a vývoj po dnech. Vyhodnocení je deterministické, takže dvě volání nad stejným obdobím dají stejné číslo. Vrací pouze součty — text zákazníka se do něj nedostane žádnou cestou. Podíl jde vždy s počtem. chatbot_conversations_list má filtry topic a knowledgeGapCandidate; přepis konkrétního rozhovoru zůstává za citlivým rozsahem a jen v rámci retence.

Webový chatbot. Statistika (chatbot_stats, rozsah chatbot:read) vrací pouze součty: kolika návštěvám stránky se ukázala bublinka a kolik z nich na ni kliklo, otevření okna, počet rozhovorů a zpráv, co bot vyřídil, hodnocení zákazníků a trychtýř registrace na newsletter. Rozhovory zákazníků (chatbot_conversations_list, chatbot_conversations_get) jsou za vlastním citlivým rozsahem chatbot-conversations:read, který na obrazovce souhlasu zaškrtnete vědomě: zákazník je v evidenci jen náhodný klíč rozhovoru (bez IP, cookie, jména či e-mailu), e-mail, telefon a IBAN, které napsal do textu, dostane asistent jen s personal-data:read — jinak místo nich vidí značku [e-mail], [telefón], [iban]. Rozhovory se vydávají jen v rámci retence e-shopu (nastavení Historie v AI centru); e-shop s retencí nula nevydá nic. Zobrazení bublinky se do 21. 9. 2026 počítala při každém vyskočení hlášky; od 22. 9. 2026 je zobrazení jedna návštěva stránky a measurementChanges v odpovědi říká, zda zvolené období míchá obě měření.

Každý nástroj má protějšek v REST nad toutéž schopností. Odpovědi se liší obálkou, obchodní údaje jsou shodné. Pravidla období, stránkování a význam finančních polí jsou v REST rozhraní.

Souhrnné nástroje (shipping_stats, analytics_*, reports_financial_summary) vracejí hotová čísla z aplikace — asistent nemusí stahovat tisíce záznamů a počítat sám. Surové seznamy (shipping_shipments, orders_list) zůstávají pro podrobný pohled.

Na co se dá ptát

Po připojení odpoví Claude.ai z údajů MitoOps například na:

• „Jaké bylo procentuální rozložení dopravy za srpen?“ — shipping_stats
• „Jaký byl medián času doručení DHL a GLS?“ a „Kolik bylo nedoručených a vrácených?“ — shipping_stats
• „Do kterých zemí jsme přes DHL posílali?“ — shipping_stats (pole countries)
• „Jaký byl obrat a konverzní poměr za srpen?“ — analytics_overview nebo reports_financial_summary
• „Kolik objednávek a obratu přišlo z ChatGPT?“ — analytics_channels
• „Jaké dotazy měly nejvyšší CTR?“ — analytics_seo
• „Jaká je marže produktu X za poslední měsíc?“ — sales_product_performance (s purchase-prices:read)
• „Na co se zákazníci tento měsíc nejčastěji ptali chatbota a o čem napsat článek na blog?“ — chatbot_conversations_list a chatbot_conversations_get (s chatbot-conversations:read)
• „Kolik rozhovorů měl chatbot a kolik z nich vyřídil bez podpory?“ — chatbot_stats
• „Jaké dostupnosti má e-shop CZ a které jsou výchozí?“ (availabilities_list)
• „Přidej na e-shop CZ dostupnost Předprodej říjen s významem předprodej a doručením do 14 dnů“ (availabilities_change_draft s availabilities:draft; vznikne návrh, který zapíšete schválením v aplikaci)
• „Které dostupnosti na e-shopu CZ nejsou spárované se SK?“ (availabilities_pairing)
• „Na které 5★ recenze na e-shopu CZ jsme ještě neodpověděli? Připrav na ně odpovědi.“ (reviews_list, potom reviews_reply_create_draft s reviews:draft; vzniknou návrhy, které zveřejníte schválením v aplikaci)
• „Uprav zapnutou automatizaci 12 tak, aby posílala upozornění jen při dopravě Kurýr“ (automations_options pro dopravu, potom automations_revision_create_draft; běžící verze se nezmění, dokud revizi nezveřejníte v editoru)
• „Jaké e-maily posílají reklamace automaticky a co v nich stojí německy?“ (claims_templates s claims-settings:read)
• „Přejmenuj stav reklamace Čeká na zboží na Čekáme na zásilku“ (claims_settings pro ID, potom claims_config_change_draft s claims-settings:draft; zapíšete schválením v aplikaci)

Čtení a úzké zápisy: automatizace, kupon, partnerský program, dostupnosti, reklamace

Provozní data (objednávky, stav zásob, produkty, doklady, zásilky) se přes MCP jen čtou. Každý zápis stojí za vlastním citlivým rozsahem: koncept automatizace, slevový kupon, správa partnerského programu, rozhodnutí o provizi, návrh změny číselníku dostupností, který do e-shopu zapíše až člověk, a návrh změny nastavení reklamací, který také zapíše až člověk.

Koncept automatizace — s rozsahem automations:write je to vypnutý koncept: s rozsahem automations:write může asistent podle katalogu (automations_catalog) navrhnout pravidlo a uložit je jako koncept, nebo upravit koncept, který ještě nikdo nepublikoval. Koncept se objeví v Automatizacích jako každý rozpracovaný návrh — zapnout, publikovat nebo spustit jej můžete jen vy v aplikaci. Publikovanou automatizaci asistent přímo nezmění.

Revize běžící automatizace. I publikovanou a zapnutou automatizaci může asistent s rozsahem automations:write upravit, ale jen návrhem: automations_revision_create_draft (vstup workflowId, expectedPublishedVersion z automations_get, catalogVersion, celé nové dsl, note a clientRequestId) uloží revizi vedle běžící verze. Běžící automatizace se nemění a běží dál. Na jednu automatizaci je nejvýše jedna otevřená revize; upraví se přes automations_revision_update_draft s expectedRevisionVersion a zahodí přes automations_revision_discard_draft. Odpověď nese approvalUrl, odkaz do editoru automatizace. Tam člověk s právem upravovat automatizace revizi uvidí v horním panelu, načte ji do editoru (tlačítko Načíst návrh do editoru), zkontroluje a zveřejní běžným tlačítkem; automatizace zůstane zapnutá. Nebo ji zamítne. Když mezitím někdo zveřejnil jinou verzi, revize se uzavře (REVISION_STALE) a je třeba připravit novou. Otevřenou revizi i historii vrátí automations_get (openRevision, revisions).

Číselníky polí a ověření hodnot. Pole, která se v editoru vybírají ze seznamu (stav objednávky, doprava, platba, profil dopravce, šablona upozornění, typ, stav, štítek a šablony reklamace, webhook endpoint a další), mají v katalogu zdroj. automations_options se source a market vrátí jejich hodnoty [{ value, name }] přesně v tvaru, který editor ukládá (ID stavu, GUID dopravy a platby, ID stavu reklamace); bez source vypíše zdroje a zda se liší podle e-shopu (perShop). Validace (automations_validate_draft) i uložení konceptu či revize odmítne hodnotu, která v e-shopu neexistuje (FIELD_UNKNOWN_OPTION), a zástupný text typu DOPLNIT_… nebo TODO (FIELD_PLACEHOLDER). Když se seznam nedá ověřit (e-shop neodpověděl, seznam je zkrácený), přijde jen upozornění FIELD_OPTIONS_UNVERIFIED. orders_get a orders_list nesou statusId, shippingGuid a paymentGuid, tedy tytéž hodnoty, se kterými pracují podmínky automatizace.

Rozsah automations:write je citlivý: na obrazovce souhlasu není předznačený, nabídne se jen člověku s právem automatizace upravovat, existující připojení jej nedostanou a obnova tokenu jej nerozšíří. Objednávky, produkty, stav zásob, doklady, refundace, reklamační případy ani zásilky se přes MCP měnit nedají; číselník dostupností e-shopu a nastavení reklamací se mění jen návrhem, který schválí člověk v aplikaci (níže). Webhook endpointy se přes MCP jen čtou. Přístupové údaje k dopravcům, e-shopu ani k analytice se přes MCP přečíst nedají.

Slevový kupon — s rozsahem coupons:write asistent založí kupon podle parametrů, které zadáte (coupons_ensure, i kupon partnera affiliate_discount_codes_ensure), a výslovně upraví existující (coupons_update, náhled a potvrzení); mazání má vlastní rozsah coupons:delete a kupon s živou závislostí se nesmaže.

Správa partnerského programu — s rozsahem affiliate:write asistent rozhodne o účtu partnera (affiliate_partners_set_state: schválit, zamítnout, pozastavit; partner dostane e-mail i s PDF dohody podle politiky dokumentů), vyřídí žádost o vlastní kód (affiliate_code_requests_decide), upraví nastavení programu mimo peněz (affiliate_settings_update: název, registrace, kontaktní osoba, barvy), texty portálu v jednom jazyce (affiliate_portal_pages_update), články nápovědy (affiliate_articles_create, affiliate_articles_update i s obnovou výchozího znění, affiliate_articles_set_state; smazání zvenku ne), šablony e-mailů (affiliate_email_templates_update), kampaně (affiliate_campaigns_create, affiliate_campaigns_update), politiku dokumentů (affiliate_documents_update) a členství partnera v e-shopu (affiliate_partners_set_market: povolit nebo odebrat). Znění právních dokumentů si přečte (affiliate_documents_get: text po jazycích, verze, otisky, koncepty) a nové znění navrhne jen jako koncept (affiliate_documents_draft_create; i privacyNotice v affiliate_portal_pages_update je od této verze koncept) — živé znění zveřejní člověk v aplikaci s rozdílem a auditem. Registr proměnných obsahu a e-mailů (kanonická jména, aliasy, typ, plochy) vydá affiliate_variables_list; affiliate_email_templates_list vrací jména proměnných, ne indexy. Výplaty, základ provize ani nahrání souboru dokumentu přes MCP neexistují — zůstávají v aplikaci.

Rozhodnutí o provizi — s vlastním citlivým rozsahem affiliate:approve (právo schvalování provizí, ne správa programu) asistent nejprve přečte čekající provize i se stavem objednávky v e-shopu (affiliate_conversions_list s state=new, detail affiliate_conversions_get: základ provize revenue, celá objednávka s DPH revenueTotal, orderState open/completed/cancelled, orderPaid, dobropis), shrne je a až na výslovný pokyn uživatele rozhodne o jedné konkrétní konverzi (affiliate_conversions_decide: approve, reject nebo cancel, při zamítnutí a zrušení s povinným důvodem, který partner dostane e-mailem). Platí stejný stavový automat jako v aplikaci: vyplacená provize se nevrací, zrušená a zamítnutá jsou koncové, stejné rozhodnutí podruhé nic nemění (changed: false). Hromadné schválení zvenku neexistuje — na sto konverzí je sto volání, každé s auditem. Od W-AFF10 nese každá konverze i approvalPolicy (způsob schvalování kampaně, lhůta, povolené stavy objednávky, zaplacení) a approvalEligibility — zda by ji hodinová automatika teď schválila a proč ne (minimum_age_not_reached, order_state_not_allowed, order_not_paid, order_cancelled, fully_refunded, approval_manual…), týž výpočet jako v aplikaci; seznam má filtry orderPaid, minCommission, orderState a stránkování offset + hasMore, takže „projdi nové konverze za dva měsíce, ukaž nezaplacené nebo ty nad 20 €“ je jedno až několik čtení. Podmínky kampaně nastaví affiliate_campaigns_update (approval, approveAfterDays, requiredOrderStatusIds, paidRequired) s rozsahem affiliate:write. Výplaty partnerům se přes MCP jen čtou (affiliate_payouts_list) — vystavit dávku, vygenerovat doklad, odeslat ho partnerovi ani podat příkaz do banky asistent neumí; to zůstává v aplikaci pod rukou provozovatele.

Návrh změny číselníku dostupností. S citlivým rozsahem availabilities:draft asistent připraví návrh, jak na jednom e-shopu založit, upravit nebo smazat dostupnosti (availabilities_change_draft, jen MCP). Do e-shopu nezapíše nic: návrh ověří, uloží v MitoOps na 24 hodin a vrátí draftId, náhled po položkách (preview s poli před a po, warnings a errors), expiresAt a approvalUrl, odkaz na obrazovku Sklad → Dostupnosti, kde návrh čeká v kartě Správa. Tam ho člověk s oprávněním schválí tlačítkem Schválit a zapsat nebo zamítne a zápis proběhne s jeho právy v okamžiku kliknutí. Když se číselník e-shopu od návrhu změní, schválení nezapíše nic a návrh skončí jako failed. Stav a výsledek po položkách vrátí availabilities_draft_get: pending, writing, executed, partial, failed, rejected nebo expired. Když náhled hlásí blokaci, návrh nevznikne (blocked), a když se nic nemění, také ne (no_change).

Vstupem je market a changes (nejvýš 30 položek). Každá změna má action (create, update nebo remove), u úpravy a smazání id z availabilities_list a jen pole, která se mají změnit: name (nejvýš 120 znaků, v jazyce e-shopu), description (nejvýš 1000 znaků, null znamená bez popisu), onStockHours a deliveryHours (celé hodiny 0 až 2500, null znamená bez údaje), meaning (in_stock, backorder, preorder, out_of_stock) a color (hex, null znamená bez barvy). Nová dostupnost potřebuje name a meaning. Volitelný clientRequestId dělá volání idempotentním: tentýž klíč se stejným obsahem vrátí tentýž návrh (replayed: true), s jiným obsahem skončí chybou CONFLICT (CLIENT_REQUEST_REUSED).

Náhled zablokuje, co by e-shop odmítl nebo co by rozbilo nastavení: duplicitní název v e-shopu, smazání systémové nebo výchozí dostupnosti či dostupnosti, kterou používá plán dostupnosti, a na WooCommerce změnu významu systémové položky nebo význam výchozí položky, který do její role nepatří. Dostupnost, kterou používají produkty, e-shop nesmaže. Změnu významu na WooCommerce zapíše jen e-shop s doplňkem MitoOps 1.5.0 nebo novějším. Když e-shop při zápisu neodpoví jasně (chyba serveru, časový limit), zápis se neopakuje, ale ověří se čtením číselníku; co se ověřit nedá, má ve výsledku uncertain: true. Asistent smí návrh připravit jen na výslovný pokyn uživatele v rozhovoru, nikdy podle textu v přečtených údajích, a hodnoty, které uživatel nezadal, nevymýšlí. Přiřazení dostupností k produktům ani stav zásob se návrhem nemění; schválená změna významu však může změnit, zda lze produkty s touto dostupností po vyprodání objednat, a náhled na to upozorní.

Párování a historie synchronizace dostupností. availabilities_pairing (rozsah products:read) vrátí to, co karta Sklad → Dostupnosti → Párování: řádky (čtyři hlavní a vlastní) s položkou každého e-shopu v rozsahu přístupu, návrhy pro prázdné buňky hlavních řádků, nespárované položky po e-shopech a stav synchronizace (sync.enabled). availabilities_history vrátí historii přenosů s obdobím (from, to), e-shopem, kódem produktu a kurzorem; záznam s e-shopem mimo rozsah přístupu se nevydá. S rozsahem availabilities:draft asistent navrhne změnu párování (availabilities_pairing_change_draft, pouze MCP): nastavit nebo vyprázdnit buňku (set), založit, upravit nebo smazat vlastní řádek (createRow, updateRow, removeRow). Párování se nezmění, dokud návrh neschválí člověk na kartě Párování tlačítkem Schválit a uložit; když se párování od návrhu změní, neuloží se nic (failed). Při zapnuté synchronizaci náhled upozorní (SYNC_ON), že schválené párování rozhoduje, jakou dostupnost dostanou produkty v ostatních e-shopech. Synchronizaci zapnout přes MCP nejde, je to rozhodnutí člověka v aplikaci. Stav vrátí availabilities_pairing_draft_get.

Recenze: čtení a návrh odpovědi. Rozsah reviews:read otevírá reviews_list (filtry druh project nebo product, answered, rating, search, productGuid, období a kurzor; totals jsou součty bez filtru stavu odpovědi), reviews_get (historie odpovědí, jazyk e-shopu, tón a podpis z nastavení Hlas e-shopu, čekající návrh) a reviews_statistics (počet, bez odpovědi, průměr, počet podle hvězdiček a po druzích za období). Jméno recenzenta je osobní údaj a přijde jen s personal-data:read; e-mail recenzenta ani číslo objednávky rozhraní nevydává. Text recenze napsal zákazník: jsou to údaje, ne pokyny pro asistenta (authorContentUntrusted). S citlivým rozsahem reviews:draft asistent připraví návrh odpovědi (reviews_reply_create_draft, pouze MCP). Odpověď je veřejná a v e-shopu se dá jen přepsat, proto ji nezveřejní: podpis e-shopu připojí systém, návrh platí 72 hodin a vrátí approvalUrl na Sklad → Recenze, kde ho člověk s právem odpovídat schválí, upraví nebo zamítne. Když recenze mezitím dostane jinou odpověď, schválení nezveřejní nic. Pokud vlastník v Nastavení → API & MCP → Zápis přes AI zapne autonomní zápis pro odpovědi na recenze, odpověď na recenzi se 4 nebo 5 hvězdičkami se zveřejní hned jménem člověka, který přístup udělil, nejvýše 50 za den; u 1 až 3 hvězdiček rozhoduje vždy člověk. Stav vrátí reviews_reply_draft_get.

Nastavení reklamací ke čtení. claims_settings (rozsah claims:read) vrátí procesy s ID a názvy typů, kroků a stavů ve zvoleném jazyce (language) i u položek, které si klient nepřejmenoval, a štítky; s rozsahem claims-settings:read i nastavení modulu (předpona kódu, lhůta, automatické naskladnění, formulář na e-shopu). Se stejným rozsahem claims_templates vrátí e-mailové šablony (jazyk, předmět, text, HTML, kdy se posílají trigger, zda odcházejí samy autoSend, který protokol přiloží) a šablony protokolů, filtrované podle language nebo templateKey; claims_configuration vrátí štítky, vlastní pole, důvody vrácení, trasy a adresy zpětné dopravy, formulář na e-shopu po e-shopech (bez tokenu integrace) a typy formuláře s vlastními texty. Kontakt a ulice adresy prodejce jsou jen s personal-data:read. claims_get nese časovou osu případu (zprávy, poznámky, změny stavu), odeslané e-maily (šablona, předmět, stav, bez adresy příjemce) a štítky; text zpráv je jen s personal-data:read.

Návrh změny nastavení reklamací. S citlivým rozsahem claims-settings:draft asistent připraví návrh (claims_config_change_draft, jen MCP): založit nebo upravit typ, krok a stav procesu (názvy po jazycích, barva, výchozí a uzavírací stav, lhůta), štítek, text e-mailové šablony v jednom jazyce, její automatické odeslání a text šablony protokolu. Mazání není. Do nastavení nezapíše nic: návrh ověří stejnými pravidly jako obrazovka (například neznámá proměnná v šabloně jej zablokuje), uloží jej v MitoOps na 72 hodin a vrátí draftId, náhled (preview, pole před a po, errors), expiresAt a approvalUrl, odkaz na Reklamace → Nastavení, kde návrh čeká v panelu Návrhy změn ke schválení. Člověk s právem spravovat nastavení jej schválí (Schválit a zapsat) nebo zamítne. Návrh se zapíše celý, nebo vůbec: když se některá hodnota od přípravy návrhu změnila, nezapíše se nic a návrh skončí jako failed. Stav vrátí claims_config_draft_get (pending, executed, failed, rejected, expired); když náhled hlásí chybu, návrh nevznikne (blocked), a když se nic nemění, také ne (no_change). ID a klíče bere asistent z claims_settings a claims_templates; clientRequestId dělá volání idempotentním.

Recepty. Server nabízí MCP prompts sales_drop_diagnosis (diagnostika poklesu prodejů), winback_campaign (kampaň na návrat zákazníků) , weekend_promotion (víkendová akce) a campaign_360 (kampaň se skrytou kategorií, produkty, bannerem, kuponem a zobrazením od–do). Recept je jen postup: řekne asistentovi, které nástroje použít a v jakém pořadí. Žádné právo navíc nemá, každý krok projde rozsahem, tarifem a potvrzením svého nástroje.

Nástroje nesou anotace podle revize protokolu (readOnlyHint, destructiveHint, idempotentHint); automations_create_draft je idempotentní přes clientRequestId, automations_update_draft vyžaduje expectedVersion a při změně katalogu vrátí CATALOG_CHANGED; automations_revision_create_draft je idempotentní přes clientRequestId a automations_revision_update_draft vyžaduje expectedRevisionVersion.

Povolení se dá odebrat

Zrušením povolení v Nastavení → API & MCP přestanou platit všechny přístupy, které z něj vznikly — okamžitě, ne po vypršení. Totéž se stane, když konektor odpojíte v Claude.ai.

Verze protokolu

Server mluví revizí 2026-07-28 i staršími (2025-11-25, 2025-06-18, 2025-03-26). Klient si vybere sám podle toho, co pošle; starší klientské knihovny se tedy připojí bez úpravy.

Novější revize je bez úvodního handshaku a bez relace: každý požadavek nese vlastní verzi a povinné hlavičky MCP-Protocol-Version, Mcp-Method a při volání nástroje Mcp-Name. Pokud se hlavička rozejde s tělem, odpověď je 400 — směrovat podle hlaviček a vykonávat podle těla by znamenalo dva zdroje pravdy o témž volání.

Související

• Přehled
• REST rozhraní
• Odchozí webhooky
• Dostupnosti