MCP rozhranie

V skratke

MitoOps poskytuje štandardný vzdialený MCP server (Model Context Protocol) na adrese /api/mcp, cez ktorý si kompatibilná AI aplikácia vypýta údaje sama. Stojí nad tými istými schopnosťami ako REST — nie je to druhé rozhranie s vlastnými dopytmi, je to iný spôsob, ako sa spýtať to isté.

MCP nie je vlastnosť modelu, ale aplikácie, v ktorej model beží (klienta). Pripojí sa každá aplikácia, ktorá podporuje vzdialené MCP cez HTTP s OAuth alebo s prístupovým kľúčom. Claude.ai je produkčne overený klient — jeho presný postup je nižšie; pre inú aplikáciu platí všeobecný postup v ďalšej časti. Klientov, ktorých sme neotestovali, nevyhlasujeme za overených.

Preukázať sa dá dvomi spôsobmi:

• prístupovým kľúčom, ktorý si vydáte v aplikácii — pre vlastný program alebo server, ktorý volá server;
• cez OAuth, keď sa pripája AI aplikácia, ktorá to vie — vtedy sa prihlásite vy a aplikácii na obrazovke súhlasu vyberiete, čo smie čítať.

V oboch prípadoch ide token v hlavičke Authorization: Bearer a v oboch platí ten istý rozsah oprávnení: čo kľúč či súhlas nezahŕňa, to nástroj nevráti.

Najrýchlejšie pripojenie je tlačidlo Pripojiť AI v hornej lište aplikácie. Vidí ho, kto má právo na prístupové kľúče. Okno vás prevedie tromi krokmi: vyberiete aplikáciu (Claude, ChatGPT alebo inú), skopírujete adresu MCP s krátkym postupom pre zvolenú aplikáciu a v treťom kroku vidíte stav pripojenia aj vety na vyskúšanie. Odkazom Čo smie AI meniť sa dostanete na kartu Zápis cez AI, odkazom Spravovať pripojenia k zoznamu pripojení. Keď vaša tarifa MCP neobsahuje, okno to povie a ponúkne tarify. Podrobné postupy sú nižšie.

Ako pripojiť Claude.ai — overené pripojenie krok za krokom

Claude.ai sa nepripája k jednotlivým e-shopom, ale k MitoOps — k vrstve, ktorá už dáta všetkých vašich e-shopov spája. Nepotrebujete žiadny kľúč, Client ID ani tajomstvo. Claude.ai si všetko zistí sám z adresy rozhrania.

1. V Claude.ai otvorte Settings (Nastavenia) → Customize → Connectors (na tímovom pláne najprv Organization settings → Connectors ako správca).
2. Stlačte Add custom connector (Pridať vlastný konektor).
3. Do poľa Name napíšte MitoOps.
4. Do poľa URL vložte adresu rozhrania MCP z okna Pripojiť AI alebo z obrazovky Nastavenia → API & MCP — v tvare https://<vaša adresa>/api/mcp, napríklad https://app.mitoops.com/api/mcp.
5. Advanced settings nechajte prázdne: Claude.ai použije vlastné hostované metadáta klienta (OAuth). Stlačte Add.
6. Pri konektore stlačte Connect (Pripojiť).
7. Otvorí sa prihlásenie do MitoOps (aj s druhým faktorom, ak ho máte). Prihláste sa.
8. Uvidíte obrazovku súhlasu: ktorá aplikácia, ktorý klient, čo smie čítať a ktorých e-shopov sa to týka. Oprávnenia sú zoskupené podľa oblastí aplikácie (obchod, sklad, expedícia, marketing, partnerský program, automatizácie). Čítanie je predznačené, citlivé údaje a príprava konceptov nie; zmeny s priamym dopadom (napríklad mazanie kupónov alebo schválenie rozosielky) sú jednotlivo v zbalenej časti Pokročilé oprávnenia. Pri každej skupine je zoznam toho, čo presne zahŕňa.
9. Skontrolujte rozsahy. Citlivé (napríklad Výkazy, Nákupné ceny, Osobné údaje zákazníkov, Dodávatelia a nákup, Automatizácie – návrhy, Dostupnosti: návrhy zmien, Recenzie: návrhy odpovedí a Reklamácie: návrhy zmien nastavení) nie sú zaškrtnuté. Ak má Claude vidieť maržu, osobné údaje, navrhovať koncepty a úpravy automatizácií alebo zmeny dostupností či nastavení reklamácií, zaškrtnite ich vedome. Šablóny a nastavenia reklamácií číta rozsah Reklamácie: nastavenia a šablóny. Vyberte e-shopy.
10. Stlačte Povoliť. Claude.ai sa vráti na svoju stránku a konektor je pripojený.
11. V rozhovore stlačte + → Connectors a konektor MitoOps zapnite.

Konektor pripojený pred 2. 9. 2026

Ak ste konektor pripojili skôr, Claude.ai má v medzipamäti staršie metadáta a na obrazovke súhlasu ponúkal iba štyri základné rozsahy. Konektor odpojte (Disconnect) a pripojte znova (Connect): ponúknu sa všetky rozsahy vrátane citlivých a nových (expedícia, analytika, zásoby).

Čo si na obrazovke súhlasu zaškrtnete, to platí — a nikdy nie viac, než smiete sami. Kto nemá v aplikácii právo na nákupné ceny, nemá ho ako odovzdať ďalej. Token, ktorý Claude.ai dostane, nesie iba povolené rozsahy.

Iný MCP klient alebo AI aplikácia cez OAuth

Aplikácii zadáte tú istú adresu /api/mcp a nič viac — žiadny kľúč. Ďalej to ide samo:

1. Aplikácia si od nás vypýta, kam poslať prihlásenie (metadáta chráneného zdroja podľa RFC 9728).
2. Otvorí sa vaše prihlásenie do MitoOps.
3. Uvidíte obrazovku súhlasu a vyberiete rozsahy a e-shopy.
4. Po povolení je pripojenie hotové a aplikácia vidí nástroje.

Aplikácia, ktorá si sama vyberá rozsahy, ich musí uviesť v požiadavke: obrazovka súhlasu ponúkne iba to, o čo aplikácia požiadala (a na čo máte právo). Rozhranie inzeruje všetky rozsahy vrátane citlivých — vo výzve WWW-Authenticate aj v scopes_supported. Citlivé sa napriek tomu nikdy nepovolia samy: na obrazovke súhlasu sú označené a nezaškrtnuté a token sa vydá zúžený na to, čo ste povolili (scope v odpovedi tokenu).

Ako sa pripája prístupovým kľúčom

Asistent alebo program potrebuje adresu /api/mcp na vašej doméne a prístupový kľúč s MCP medzi rozhraniami. Presnú adresu vypisuje obrazovka Nastavenia → API & MCP v bloku „Kde to zapojiť“. Kľúč vydaný iba pre REST na MCP nefunguje a naopak.

Nástroje

Zoznam nástrojov sa riadi rozsahmi kľúča alebo súhlasu: asistent uvidí presne to, čo mu bolo povolené, a nič iné. Nástroj mimo rozsahu preň neexistuje.

Nástroj MCP	Rozsah	REST	Čo vráti
account_connection	stores:read	GET /account/connection	Diagnostika tohto pripojenia: aplikácia, kto a kedy povolil, udelené a neudelené rozsahy po oblastiach, e-shopy, režim zápisu cez AI a odtlačok katalógu nástrojov.
account_entitlements	account:read	GET /account/entitlements	Tarifa klienta, funkcie a limity s aktuálnym využitím.
account_team	team:read	GET /account/team	Tím klienta: mená, roly, aktívne účty, posledné prihlásenie a kto koho vedie; e-mail iba s právom na osobné údaje.
affiliate_articles_create	affiliate:write	—	zápis: Založenie vlastného článku nápovedy vo všetkých jazykoch naraz (názov a telo v zadanom jazyku); HTML sa očistí.
affiliate_articles_get	affiliate:read	GET /affiliate/articles/:key	Jeden článok nápovedy so znením (HTML) vo všetkých alebo v jednom jazyku; premenné nedosadené.
affiliate_articles_list	affiliate:read	GET /affiliate/articles	Články nápovedy partnerského portálu: kľúč, predvolený/vlastný, zapnutie, poradie, stav po jazykoch (názov, adresa, vyplnené, totožné s predvoleným).
affiliate_articles_set_state	affiliate:write	—	zápis: Zapnutie alebo vypnutie článku nápovedy pre všetky jazyky naraz; predvolený sa nemaže, iba vypína.
affiliate_articles_update	affiliate:write	—	zápis: Úprava článku nápovedy v jednom jazyku (názov, adresa, telo; HTML sa očistí) alebo obnova predvoleného znenia; vráti neznáme premenné.
affiliate_campaigns_create	affiliate:write	—	zápis: Založenie kampane na e-shope: názov, odmena (nevymýšľať), platnosť priradenia, dostupnosť, schvaľovanie konverzií.
affiliate_campaigns_get	affiliate:read	GET /affiliate/campaigns/:campaignId	Jedna kampaň partnerského programu.
affiliate_campaigns_list	affiliate:read	GET /affiliate/campaigns	Kampane partnerského programu e-shopu s odmenou, dostupnosťou a počtami.
affiliate_campaigns_update	affiliate:write	—	zápis: Úprava kampane: názov, odmena, platnosť, dostupnosť, schvaľovanie, zapnutie/vypnutie, popis pre partnerov po jazykoch.
affiliate_code_requests_decide	affiliate:write	—	zápis: Vybavenie žiadosti partnera o vlastný kód: zamietnutie s dôvodom (partner dostane e-mail). Schválenie a opakovanie založia kód na celý e-shop, preto ich z AI nevykoná nikto: žiadosť čaká na človeka v aplikácii.
affiliate_code_requests_list	affiliate:read	GET /affiliate/code-requests	Žiadosti partnerov o vlastný zľavový kód so stavom a dôvodom; čakajúce prvé.
affiliate_conversions_decide	affiliate:approve	—	zápis: Rozhodnutie o jednej provízii podľa id: approve (nová → schválená), reject (nová → zamietnutá, dôvod povinný), cancel (schválená → zrušená, dôvod povinný); vyplatená sa nevracia, rovnaké rozhodnutie druhýkrát nič nemení; partner dostane e-mail.
affiliate_conversions_get	affiliate:read	GET /affiliate/conversions/:conversionId	Detail jednej konverzie: sumy, provízia, stav provízie s dôvodom, stav objednávky v e-shope, dobropis, výplata.
affiliate_conversions_list	affiliate:read	GET /affiliate/conversions	Konverzie partnerského programu e-shopu: základ provízie a celá objednávka s DPH, provízia, stav provízie s dôvodom, stav objednávky v e-shope, väzba na výplatu.
affiliate_discount_codes_ensure	coupons:write	—	zápis: Nech má partner na e-shope zľavový kód: rozsah je povinný, najprv náhľad, potom potvrdenie; kupón sa založí cez canonical kupóny (alebo použije existujúci) a priradí partnerovi. Podľa režimu AI zápisu (Kupóny): pri Ručnom schválení sa uloží návrh pre človeka; kód na celý e-shop vždy schvaľuje človek.
affiliate_discount_codes_list	affiliate:read	GET /affiliate/discount-codes	Zľavové kódy partnerov na e-shope s počtom použití a obratom.
affiliate_documents_draft_create	affiliate:write	—	zápis: Návrh nového znenia právneho dokumentu ako koncept; živé znenie nemení — zverejní ho človek v aplikácii s rozdielom a auditom.
affiliate_documents_get	affiliate:read	GET /affiliate/documents/:key/content	Jeden právny dokument programu so znením po jazykoch (uložený text, verejné znenie, verzia, odtlačky, zdroj, PDF metadáta) a otvorenými konceptmi.
affiliate_documents_list	affiliate:read	GET /affiliate/documents	Dokumenty programu (podmienky, dohody): politika potvrdenia, podpísaná kópia, príloha e-mailu, verzie po jazykoch, pripravenosť a počty potvrdení.
affiliate_documents_update	affiliate:write	—	zápis: Politika dokumentu programu (pre koho platí, kedy sa potvrdzuje, podpísaná kópia, príloha e-mailu, zapnutie); znenie sa nahráva v aplikácii.
affiliate_email_templates_list	affiliate:read	GET /affiliate/email-templates	Šablóny e-mailov partnerom po jazykoch (predmet, zapnutie, s udalosťou aj telo) a automatické prílohy e-mailu Účet schválený.
affiliate_email_templates_update	affiliate:write	—	zápis: Úprava šablóny e-mailu partnerom v jednom jazyku (predmet, telo) alebo zapnutie/vypnutie udalosti.
affiliate_links_generate	affiliate:read	GET /affiliate/links/generate	Sledovaný partnerský odkaz na domov, produkt alebo kategóriu e-shopu kampane; po kliknutí zachová priradenie partnerovi.
affiliate_partners_get	affiliate:read	GET /affiliate/partners/:partnerId	Jeden partner programu s kampaňami, ktoré má k dispozícii.
affiliate_partners_list	affiliate:read	GET /affiliate/partners	Partneri programu so stavom, výkonom a províziami; kontakt iba s osobnými údajmi.
affiliate_partners_set_market	affiliate:write	—	zápis: Členstvo partnera v e-shope: povoliť (active, schváli aj žiadosť z portálu) alebo odobrať (revoked); kampane, kupóny a dokumenty e-shopu sa partnera týkajú iba s aktívnym členstvom.
affiliate_partners_set_state	affiliate:write	—	zápis: Rozhodnutie o účte partnera (schváliť, zamietnuť, pozastaviť, vrátiť medzi čakajúcich); schválenie pošle e-mail s dohodou.
affiliate_payouts_list	affiliate:read	GET /affiliate/payouts	Výplaty provízií partnerom so stavom; bez bankových a fakturačných údajov.
affiliate_portal_get	affiliate:read	GET /affiliate/portal	Verejný portál partnera: adresy po e-shopoch, otvorenosť registrácie s dôvodom, vlastné domény, kontaktná osoba, vzhľad a stav textov po jazykoch.
affiliate_portal_pages_update	affiliate:write	—	zápis: Vlastné texty verejného portálu v jednom jazyku (stránky prihlásenie/registrácia/prehľad, poučenie, popis programu); HTML sa očistí.
affiliate_settings	affiliate:read	GET /affiliate/settings	Nastavenie partnerského programu: provízie, kliky, minimum výplaty, privedenie.
affiliate_settings_update	affiliate:write	—	zápis: Nastavenie programu mimo peňazí: názov, registrácia, automatické schvaľovanie, kontaktná osoba, farby, odkaz na zásady.
affiliate_signatures_get	affiliate:read	GET /affiliate/signatures/:signatureId	Jeden elektronický podpis s podpísaným znením a snímkou hodnôt; nemenný záznam, PDF sa skladá v aplikácii.
affiliate_signatures_list	affiliate:read	GET /affiliate/signatures	Elektronicky podpísané dokumenty partnerov (kto, dokument, verzia, jazyk, e-shop, čas, spôsob, overenie, odtlačky, stav) a partneri, ktorým podpis chýba; iba čítanie — podpis vzniká výhradne v portáli.
affiliate_statistics	affiliate:read	GET /affiliate/statistics	Štatistika partnerského programu: vývoj po dňoch, zdroje priradenia, rebríček partnerov.
affiliate_summary	affiliate:read	GET /affiliate/summary	Prehľad partnerského programu e-shopu za obdobie: kliky, konverzie, provízie, partneri.
affiliate_variables_list	affiliate:read	GET /affiliate/variables	Register premenných obsahu a e-mailov partnerského programu: kanonické mená, aliasy, typ, plochy, príklad; voliteľná kontrola textu na neznáme premenné.
ai_instructions_get	ai-instructions:read	—	Inštrukcie AI modulu (Copywriter, webový chatbot e-shopu, interný asistent) na čítanie.
brand_soul_change_draft	brand-soul:draft	—	zápis: NÁVRH zmeny Srdca e-shopu s expectedVersion; platnou ho urobí iba človek schválením v MitoOps.
brand_soul_get	brand-soul:read	—	Srdce e-shopu: profil značky pre AI nástroje, účinné hodnoty e-shopu s pôvodom, verzie, čakajúci návrh a pripravenosť.
analytics_advertising	reports:read	GET /analytics/advertising	Reklama: výdavky, rozpočet, ROAS, PNO, CPA, MER s porovnaním; Google Ads, Meta Ads a OpenAI Ads, kliky z GA4, 6 mesiacov.
analytics_channels	analytics:read	GET /analytics/channels	Rozloženie návštev, objednávok a obratu podľa marketingových kanálov.
analytics_comparison	reports:read	GET /analytics/comparison	Obraty s porovnaním: obrat, objednávky, AOV, návštevy, CR a AI/LLM oproti predchádzajúcemu obdobiu alebo roku.
analytics_daily	reports:read	GET /analytics/daily	Obrat a objednávky po dňoch (najviac 92 dní), súčet za e-shopy alebo jeden e-shop.
analytics_funnels_catalog	analytics-funnels:read	GET /analytics/funnels/catalog	Udalosti, parametre a vlastnosti používateľa z GA4 e-shopu pre nastavenie lievika.
analytics_funnels_change	analytics-funnels:write	—	zápis: Založí, upraví alebo archivuje lievik z GA4. Náhľad, zápis s confirmation; MCP iba so zapnutým „Autonómne vykonanie“ pre Lieviky.
analytics_funnels_get	analytics-funnels:read	GET /analytics/funnels/:id	Lievik za obdobie: návštevníci krokov z GA4, nákupy a obrat z objednávok, rozpad podľa kanálov, porovnanie.
analytics_funnels_list	analytics-funnels:read	GET /analytics/funnels	Lieviky z GA4 (napr. kvíz na webe): kroky, značka návštevníka, stav a posledný import.
analytics_monthly	reports:read	GET /analytics/monthly	Obrat, objednávky a návštevy po mesiacoch (najviac 24), napríklad rok k roku.
analytics_order_coverage	analytics:read	GET /analytics/order-coverage	Pokrytie objednávok a obratu meraním v analytike.
analytics_order_heatmap	reports:read	GET /analytics/order-heatmap	Kedy prichádzajú objednávky: deň v týždni × hodina, najsilnejší deň a hodina.
analytics_overview	analytics:read	GET /analytics/overview	Návštevy, objednávky, obrat, konverzný pomer a AI/LLM podiel za obdobie.
analytics_revenue_sources	reports:read	GET /analytics/revenue-sources	Odkiaľ prišli tržby: kanály, súčty AI/LLM, MitoOps a Affiliate, rozpad akvizície podľa GA4.
analytics_seo	analytics:read	GET /analytics/seo	Search Console: kliknutia, zobrazenia, CTR a pozícia podľa dopytov alebo stránok.
approvals_pending	approvals:read	GET /approvals/pending	Čo čaká na schválenie človekom: kroky AI v Denníku AI zmien a Návrhy od AI.
automations_catalog	automations:read	GET /automations/catalog	Katalóg automatizácií: spúšťače, podmienky, operátory, akcie, šablóny; catalogVersion pre návrhy.
automations_create_draft	automations:write	—	zápis: Vytvorí VYPNUTÝ koncept automatizácie. Nezapína ani nespúšťa.
automations_get	automations:read	GET /automations/:workflowId	Jedna automatizácia s DSL a výsledkom validácie.
automations_list	automations:read	GET /automations	Automatizácie klienta so stavom a rozsahom e-shopov.
automations_options	automations:read	GET /automations/options	Číselník pre pole automatizácie (stavy, dopravy, platby, šablóny, reklamácie…): value do DSL a názov.
automations_revision_create_draft	automations:write	—	zápis: Navrhne úpravu publikovanej automatizácie ako revíziu na schválenie človekom. Bežiaca verzia sa nemení.
automations_revision_discard_draft	automations:write	—	zápis: Stiahne otvorenú revíziu publikovanej automatizácie.
automations_revision_update_draft	automations:write	—	zápis: Upraví otvorenú revíziu publikovanej automatizácie.
automations_runs	automations:read	GET /automations/:workflowId/runs	História behov jednej automatizácie.
automations_templates	automations:read	GET /automations/templates	Hotové vzory automatizácií s DSL.
automations_update_draft	automations:write	—	zápis: Upraví nepublikovaný koncept automatizácie s optimistickou súbežnosťou.
automations_validate_draft	automations:read	—	Overí návrh automatizácie bez zápisu.
campaigns_discount_compute	campaign-rules:read	GET /campaigns/discount-compute	Skutočná zľava z plnej ceny pri akcii a kóde (násobia sa), alebo dopočet druhej časti k cieľovej zľave; porovnanie s limitom e-shopu.
campaigns_discount_rules	campaign-rules:read	GET /campaigns/discount-rules	Pravidlá zliav e-shopov: či je limit zapnutý, najvyššia súhrnná zľava z plnej ceny, rozsah, režim (ceny, kódy, oboje) a provízia partnerov.
campaigns_discount_rules_configure	campaign-rules:write	—	zápis: Zmení pravidlo zliav e-shopu: najprv náhľad pred a po, zápis až s confirmation. Existujúce kódy a ceny sa nemenia.
chatbot_conversations_get	chatbot-conversations:read	GET /chatbot/conversations/:sessionId	Prepis jedného rozhovoru s webovým chatbotom aj so zdrojmi odpovedí bota.
chatbot_conversations_list	chatbot-conversations:read	GET /chatbot/conversations	Rozhovory zákazníkov s webovým chatbotom od naposledy aktívneho, s prvou otázkou; kurzor.
chatbot_outcomes	chatbot:read	GET /chatbot/outcomes	Ako dopadli rozhovory chatbota: odkedy sa meria, merané a nemerané, známy a neznámy výsledok a miera s menovateľom.
chatbot_stats	chatbot:read	GET /chatbot/stats	Štatistika webového chatbota za obdobie: lievik bublinky, otvorenia, rozhovory, výsledky, hodnotenia.
chatbot_topics	chatbot:read	GET /chatbot/topics	O čom boli rozhovory: podiely tém, produkty, typ stránky začiatku a kandidáti na medzeru v znalostiach.
claims_config_change_draft	claims-settings:draft	—	zápis: Navrhne zmenu procesov, stavov, štítkov, šablón, textov formulára a nastavení modulu reklamácií; zapíše ju až človek schválením v aplikácii.
claims_config_draft_get	claims-settings:read	GET /claims/config-drafts/:draftId	Stav návrhu zmeny nastavení reklamácií (čaká, zapísaný, zamietnutý).
claims_configuration	claims-settings:read	GET /claims/configuration	Nastavenia reklamácií: štítky, polia, spätná doprava, formulár na e-shope, typy formulára.
claims_deadlines	claims:read	GET /claims/deadlines	Otvorené reklamácie podľa lehoty: po lehote a blízko lehoty, od najnaliehavejšej, s počtami po e-shopoch.
claims_get	claims:read	GET /claims/:code	Jeden prípad s položkami a väzbami: objednávka, dobropis, spätná zásielka, skladový pohyb.
claims_list	claims:read	GET /claims	Reklamácie a vrátenia jedného e-shopu od najnovšieho.
claims_refund_options	claims-settings:read	GET /claims/refund-options	Vrátenie peňazí: zdroj variabilného symbolu, platnosť refundačného kupónu, kupón vo formulári, kedy formulár pýta číslo účtu.
claims_refund_readiness	claims:read	GET /claims/:code/refund-readiness	Prípad pred refundáciou: čo zákazník žiada, maskovaný účet, variabilný symbol, režim a či sa dá prípad zmazať.
claims_refund_settings	claims-settings:read	GET /claims/refund-settings	Refundácie reklamácií: režim, bankové účty so spôsobilosťou na platobný príkaz (maskované), predvolený a ručný účet.
claims_routes	claims-settings:read	GET /claims/routes	Spätná doprava reklamácií: trasy, adresy, profily dopravcov s ID a podporou vratky, typy prípadov.
claims_routes_change_draft	claims-routes:draft	—	zápis: Navrhne spätnú trasu (aj pre celú EÚ alebo svet) a adresu príjemcu; zapíše ich človek schválením (alebo autonómny zápis, ak ho klient zapol).
claims_settings	claims:read	GET /claims/settings	Procesy reklamácií s ID a názvami (typy, kroky, stavy, lehoty), štítky; nastavenia modulu s rozsahom claims-settings:read.
claims_statistics	claims:read	GET /claims/statistics	Štatistika reklamácií a vrátení za obdobie: počty, časy vybavenia, typy, hodnotenia, dôvody.
claims_templates	claims-settings:read	GET /claims/templates	Šablóny e-mailov (predmet, text, kedy a či sa posielajú automaticky) a protokolov reklamácií.
content_articles_search	products:read	GET /content/articles	Články blogu e-shopu s adresou na webe a náhľadovým obrázkom.
coupons_activation_link	coupons:read	GET /coupons/activation-link	Odkaz, ktorý zákazníkovi uplatní EXISTUJÚCI kupón v košíku. Kupón nevytvára.
coupons_activation_status	coupons:read	GET /coupons/activation-status	Dá sa kupón na e-shope použiť cez aktivačný odkaz: zrkadlo kupónu + stav kódu na webe.
coupons_capabilities	coupons:read	GET /coupons/capabilities	Čo o kupónoch vie platforma daného e-shopu. Čítajte pred zakladaním.
coupons_ensure	coupons:write	—	zápis: Nech kupón na vybraných e-shopoch existuje; rozsah (kategórie, produkty alebo výslovne celý e-shop) je povinný, najprv náhľad, potom potvrdenie. Pri inej výške zľavy sa NEPREPÍŠE. Podľa režimu AI zápisu (Kupóny): pri Ručnom schválení sa uloží návrh pre človeka; kupón na celý e-shop vždy schvaľuje človek.
coupons_get	coupons:read	GET /coupons/:code	Jeden kupón z evidencie MitoOps. Keď v nej nie je, odpoveď je „nenašlo sa“.
coupons_list	coupons:read	GET /coupons	Zľavové kupóny e-shopu s typom a výškou zľavy, platnosťou a odvodeným stavom.
coupons_remove	coupons:delete	—	zápis: Výslovné zmazanie kupónu: závislosti, náhľad, potvrdenie; so živou závislosťou sa nemaže. Podľa režimu AI zápisu (Kupóny): pri Ručnom schválení sa uloží návrh pre človeka.
coupons_templates_cleanup	coupons:delete	—	zápis: Uprace nepoužité šablóny kupónov MitoOps na e-shope (cudzie šablóny nikdy). Náhľad, zmazanie s confirmation. Podľa režimu AI zápisu (Kupóny): pri Ručnom schválení sa uloží návrh pre človeka.
coupons_update	coupons:write	—	zápis: Výslovná úprava existujúceho kupónu vrátane obmedzení na produkty a kategórie; náhľad, potom potvrdenie. Podľa režimu AI zápisu (Kupóny): pri Ručnom schválení sa uloží návrh pre človeka; kupón na celý e-shop vždy schvaľuje človek.
coupons_web_box_overview	coupons:read	GET /coupons/web-box	Rámiky s cenou po zadaní kódu pri produktoch na e-shope: hlavný vypínač, kupóny, nastavenie a stav.
coupons_web_box_preview	coupons:read	—	Náhľad rámika cena po zadaní kódu pri produkte: html karty produktu s rámikom, text, cena po kóde, pokrytie a dôvody. Nič nezapisuje.
coupons_web_box_set	coupons:write	—	zápis: Zapne, vypne alebo upraví rámik s cenou po zadaní kódu pre existujúci kupón; náhľad, potom potvrdenie. Podľa režimu AI zápisu (Kupóny): pri Ručnom schválení sa uloží návrh pre človeka.
coupons_web_box_stats	coupons:read	GET /coupons/web-box/stats	Zobrazenia rámika, kópie kódu a uplatnenia v košíku po kupóne a produkte.
customers_get	customers:read	GET /customers/:customerKey	Jeden zákazník z adresára — identita, e-shopy, LIFETIME aj voliteľné PERIOD peniaze, rozpis podľa e-shopu.
customers_list	customers:read	GET /customers	Adresár zákazníkov: identita (s PII maskovaním), e-shopy, jazyk, LIFETIME počty a obrat po menách; voliteľný filter nákupnej aktivity v období.
customers_performance	reports:read	GET /customers/performance	Zákazníci ako pseudonymy: počet objednávok, obrat, prvá a posledná objednávka, opakovaný nákup, LTV.
credit_notes_search	invoices:read	GET /credit-notes	Hľadanie v dobropisoch.
documents_list	invoices:read	GET /documents	Účtovné doklady jedného druhu (faktúry, zálohové faktúry, dobropisy) po stranách so životným cyklom, stavom v zdroji, filtrom platnosti a dostupnosťou PDF.
documents_pdf_link	invoices:read	—	Krátkodobý odkaz (10 minút) na PDF faktúry, zálohovej faktúry alebo dobropisu na otvorenie v prehliadači.
invoices_get	invoices:read	GET /invoices/:invoiceCode	Jedna faktúra s položkami, sumami, dobropismi a zálohovými faktúrami k nej.
invoices_search	invoices:read	GET /invoices	Hľadanie vo faktúrach.
payments_matching	payments:read	GET /payments/matching	Párovanie prijatých platieb s objednávkami: počty podľa výsledku a nespárované, nejednoznačné a chybné platby.
inventory_movements	inventory:read	GET /inventory/movements	História skladových pohybov: kedy, čo, o koľko, prečo a z akého zdroja.
inventory_product_availability	inventory:read	GET /inventory/availability	Stav zásoby pre viac položiek naraz.
inventory_product_statistics	inventory:read	GET /inventory/product-statistics	Po produktoch za obdobie: stav skladu, predané, reklamované a vrátené kusy, miera reklamácií.
inventory_stock	inventory:read	GET /inventory/stock	Stav zásoby jednej položky aj so zdrojom hodnoty.
inventory_sync_status	stock-sync:read	GET /inventory/sync-status	Stav synchronizácie skladu medzi e-shopmi: fronta, konflikty, posledný beh a kontrola zhody, mapovanie, zdravie spojenia.
inventory_valuation	inventory:read	GET /inventory/valuation	Hodnota skladu ako obrazovka: nákupná a predajná hodnota, hrubý a čistý potenciál, pod minimom, záporné, najväčšie položky; bez sád a balíkov.
messaging_deliveries	messaging:read	GET /messaging/deliveries	Doručenie e-mailov k zásielkam, objednávkam, reklamáciám a partnerom: súhrn, stavy a chyby (odrazené, spam, zablokované).
notifications_list	notifications:read	GET /notifications	Upozornenia zo zvončeka: čo hlásia moduly, závažnosť, stav, počet neprečítaných a obrazovka, ktorá to rieši.
orders_get	orders:read	GET /orders/:orderCode	Jedna uložená objednávka vrátane položiek.
orders_line_discounts	orders:read	GET /orders/:orderCode/line-discounts	Historické ceny a zľavy po položkách objednávky: pôvodná cena, zľava, kupón, zaplatená hodnota a spoľahlivosť.
orders_list	orders:read	GET /orders	Uložené objednávky, od najnovšej; filter stavu, hľadanie, úhrada, obdobie a úplný počet vo filtri.
orders_packing_queue	orders:read	GET /orders/packing-queue	Fronta balenia podľa stavov, ktoré si klient nastavil ako pripravené na balenie: počet a objednávky na e-shop.
availabilities_change_draft	availabilities:draft	—	zápis: NÁVRH zmeny číselníka dostupností (založiť, upraviť, zmazať). Do e-shopu ho zapíše až človek schválením v MitoOps.
availabilities_draft_get	products:read	GET /availabilities/drafts/:draftId	Stav návrhu zmeny číselníka dostupností: čaká na schválenie, zapísaný s výsledkom, zamietnutý, vypršaný.
availabilities_history	products:read	GET /availabilities/history	História synchronizácie dostupností: čo sa z ktorého e-shopu prenieslo kam a s akým výsledkom; obdobie, kurzor.
availabilities_list	products:read	GET /availabilities	Číselník dostupností e-shopu: názov, popis, naskladnenie, doručenie, význam pre Google, farba, predvolená úloha.
availabilities_pairing	products:read	GET /availabilities/pairing	Párovanie dostupností medzi e-shopmi: riadky s položkou každého e-shopu, návrhy, nespárované, stav synchronizácie.
availabilities_pairing_change_draft	availabilities:draft	—	zápis: NÁVRH zmeny párovania dostupností (bunka, vlastný riadok). Uloží ho až človek schválením v MitoOps; synchronizáciu nezapína.
availabilities_pairing_draft_get	products:read	GET /availabilities/pairing-drafts/:draftId	Stav návrhu zmeny párovania dostupností: čaká na schválenie, uložený, zamietnutý, vypršaný.
catalog_reconcile	products:write	—	zápis: Zosúladí zrkadlo katalógu s e-shopom: produkty a kategórie, ktoré e-shop preukázateľne nemá (dve nezávislé pozorovania), dostanú náhrobok v MitoOps. Náhľad s dôkazmi, zápis s confirmation.
categories_content_change_draft	category-content:draft	—	zápis: NÁVRH nových textov kategórií (najviac 30 naraz); do e-shopu ich zapíše až človek schválením v MitoOps.
categories_content_draft_get	category-content:read	GET /catalog/category-content-drafts/:draftId	Stav návrhu textov kategórií: čaká na schválenie, zapísaný, zamietnutý, vypršaný.
categories_content_get	category-content:read	GET /categories/:guid/content	Texty kategórie (horný a dolný popis, SEO titulok a popis) s odtlačkom a zapisovateľnosťou poľa.
categories_create	categories:write	—	zápis: Založí kategóriu e-shopu (predvolene skrytú). Najprv náhľad, zápis s confirmation; vykoná asistent po schválení karty alebo MCP so zapnutým „Autonómne vykonanie“ pre Kategórie.
categories_get	category-content:read	GET /categories/:guid	Jedna kategória so živým stavom z e-shopu vrátane viditeľnosti (true/false, null = platforma ju nevedie) a plánov od–do.
categories_list	products:read	GET /categories	Kategórie e-shopu s počtom produktov.
categories_products_assign	product-categories:write	—	zápis: Hromadne pridá produkty do kategórie alebo ich z nej odoberie (zoznam kódov alebo jednorazovo zo zdrojovej kategórie). Náhľad s počtami, zápis s confirmation, výsledok po produktoch a opakovanie neúspešných.
categories_products_list	products:read	GET /categories/:guid/products	Produkty zaradené v kategórii, stránkovane, živo z e-shopu (pri výpadku zo zrkadla s vyznačením zdroja).
categories_remove	categories:write	—	zápis: Zmaže iba prázdnu kategóriu (bez produktov a podkategórií), inak odporučí skrytie. Nevratné: z denníka sa nevráti, uloží sa snímka na ručnú obnovu. Náhľad, zápis s confirmation.
categories_update	categories:write	—	zápis: Upraví kategóriu (názov, nadradená, adresa, viditeľnosť, texty, SEO, obrázok); iba zmenené polia. Náhľad pred a po, zápis s confirmation.
categories_visibility_plan	categories:write	—	zápis: Plán zobrazenia kategórie od–do alebo jeho zrušenie. Náhľad, zápis s confirmation.
categories_visibility_plans_list	category-content:read	GET /categories/visibility-plans	Plány zobrazenia kategórií od–do: čas, stav, pôvodná viditeľnosť, posledný zápis a chyba.
product_logistics_get	product-logistics:read	GET /product-logistics/:code	Hmotnosť a rozmery predajného balenia variantu naživo z e-shopu (kg, cm), zdedené polia, revízia a posledné zápisy.
product_logistics_list_missing	product-logistics:read	GET /product-logistics/missing	Kódy e-shopu bez hmotnosti alebo rozmerov (alebo s neoverenými jednotkami); s codes hodnoty z kópie so zdrojom a istotou.
product_logistics_update_confirmed	product-logistics:write	—	zápis: Potvrdený zápis hmotnosti a rozmerov do e-shopu s kontrolou revízie, kľúčom idempotencie a kontrolným čítaním.
product_logistics_update_preview	product-logistics:read	—	Náhľad zmeny hmotnosti a rozmerov bez zápisu: pred a po, varovania (jednotky, doprava v pokladni, 30 kg), revízia.
products_availability_update	product-stock:write	—	zápis: Zmení dostupnosť produktu na sklade a po vypredaní a objednávanie po vypredaní; počet kusov nie. Náhľad, zápis s confirmation.
products_categories_get	products:read	GET /products/:code/categories	Všetky kategórie produktu po e-shopoch živo z e-shopu: hlavná a ďalšie zaradenia vrátane skrytých kategórií.
products_categories_update	product-categories:write	—	zápis: Pridá a odoberie ďalšie kategórie produktu a voliteľne zmení hlavnú; ostatné zaradenia zachová. Náhľad pred a po, zápis s confirmation.
products_category_assign	product-categories:write	—	zápis: Zmení hlavnú kategóriu produktu na vybraných e-shopoch. Náhľad pred a po, zápis s confirmation.
products_changes	products:read	GET /products/changes	Denník zmien produktovej karty: pole, e-shop, kedy, odkiaľ a náhľad starej a novej hodnoty; ceny iba s právom.
products_content_change_draft	product-content:draft	—	zápis: NÁVRH nových textov produktov (najviac 30 naraz); do e-shopu ich zapíše až človek schválením v MitoOps.
products_content_draft_get	product-content:read	GET /catalog/product-content-drafts/:draftId	Stav návrhu textov produktov: čaká na schválenie, zapísaný s upozorneniami e-shopu, zamietnutý, vypršaný.
products_content_get	product-content:read	GET /products/:code/content	Texty produktu z e-shopu (popis, krátky popis, SEO titulok a popis) s odtlačkom a zapisovateľnosťou poľa.
products_content_policy	product-content:read	GET /product-content/policy	Politika obsahu na e-shope bez volania e-shopu: čo tento prístup smie čítať a navrhovať, ktoré polia platforma zapíše, režim schvaľovania a autonómny zápis, limity a odtlačky.
products_create	products:write	—	zápis: Založí nový produkt na vybraných e-shopoch, vždy SKRYTÝ; zverejní ho človek. Náhľad, zápis s confirmation.
products_gallery_edit	product-gallery:write	—	zápis: Galéria produktu ako v editore: pridať z https adresy, nahradiť, odobrať, poradie, hlavný obrázok, popis. Náhľad, zápis s confirmation.
products_get	products:read	GET /products/:code	Jeden produkt podľa kódu vrátane zaradenia a ceny z karty.
products_offer	products:read	GET /products/:code/offer	Ponuka produktu v e-shope: či ho e-shop ešte má, viditeľnosť, objednateľnosť, dostupnosť a cena s menou, DPH a cenou v predajnej mene e-shopu.
products_prices_update	product-prices:write	—	zápis: Zmení ceny produktu (cena, prečiarknutá, akčná s dátumom od a do, koeficient; nákupná iba s právom). Náhľad pred a po, zápis s confirmation.
products_remove	products:write	—	zápis: NEVRATNE zmaže produkt, iba živo skrytý, bez zásoby a bez predajov (napr. testovací). Náhľad, zmazanie s confirmation.
products_search	products:read	GET /products	Hľadanie produktov podľa názvu, kódu, EAN alebo PLU; filter kategórie, aktívnosti a pod minimom s úplným počtom; stav v e-shope, produkty zmazané v e-shope iba na požiadanie.
products_update	products:write	—	zápis: Upraví produkt na vybraných e-shopoch: názov, texty a SEO, identifikátory a údaje výrobcu; ceny, dostupnosť ani zaradenie nie. Náhľad pred a po, zápis s confirmation.
products_visibility_get	products:read	GET /products/:code/visibility	Živý stav produktu po e-shopoch: viditeľnosť (aj surový stav platformy), objednateľnosť a indexovateľnosť na čítanie, bežiaci plán od–do.
products_visibility_plans_list	products:read	GET /catalog/products/visibility-plans	Plány viditeľnosti produktov od–do: čas, stav, pôvodný stav e-shopu, posledný zápis, chyba a posledné kolo plánovača.
products_visibility_plan	product-visibility:write	—	zápis: Plán viditeľnosti produktu od–do alebo jeho zrušenie s režimom (safe nikdy nezverejní). Náhľad, zápis s confirmation.
products_visibility_update	product-visibility:write	—	zápis: Skryje alebo zobrazí produkt na vybraných e-shopoch; objednateľnosť ani indexovanie nemení. Náhľad zo živého stavu, zápis s confirmation a kontrolným čítaním.
reports_cost_groups	reports:read	GET /reports/cost-groups	Kategórie a štítky nákladov a rozloženie skupín v Nákladoch.
reports_costs_change	report-costs:write	—	zápis: Založí, upraví alebo vyradí ručný náklad. Náhľad, zápis s confirmation; vykoná asistent po schválení karty alebo MCP so zapnutým „Autonómne vykonanie“ pre Náklady.
reports_costs_list	reports:read	GET /reports/costs	Ručné aj automatické náklady so sumou, ktorá sa započíta do obdobia; firemné a po e-shopoch.
reports_export_create	report-exports:write	—	zápis: Vygeneruje report (xlsx, docx, pdf) za obdobie; vráti runId, súbor sa stiahne cez REST. Údaje nemení.
reports_financial_summary	reports:read	GET /reports/financial-summary	Finančný súhrn obdobia: obrat, DPH, objednávky, AOV; s právami aj nákup, hrubý zisk, náklady a výsledok.
reports_history_get	reports:read	GET /reports/history/:runId	Stav jedného exportu a jeho súbory s adresou na stiahnutie cez REST.
reports_history_list	reports:read	GET /reports/history	História vygenerovaných reportov so súbormi, veľkosťou a SHA256.
reports_layout_get	reports:read	GET /reports/layout	Rozloženie exportu reportu: obálka, poradie a zapnutie hárkov a sekcií, zlomy strán.
reports_layout_update	reports:write	—	zápis: Uloží rozloženie exportu (poradie a zapnutie hárkov a sekcií). Náhľad, zápis s confirmation.
reports_notes_get	reports:read	GET /reports/notes	Poznámka k reportom, ktorá ide do Word a PDF výkazu.
reports_notes_update	reports:write	—	zápis: Prepíše poznámku k reportom (HTML sa očistí). Náhľad, zápis s confirmation.
reports_order_status_rules	reports:read	GET /reports/order-status-rules	Ktoré stavy objednávok sa rátajú do obratu, po e-shopoch, s počtom a obratom v stave.
reports_summary_all	reports:read	GET /reports/summary-all	Súhrn viacerých e-shopov ako pri „Všetky“: celok, rozpad po e-shopoch, firemné náklady raz, computedAt a dataAsOf.
sales_order_performance	reports:read	GET /sales/order-performance	Obrat po objednávkach v EUR so súčtami za celé obdobie; s právom aj nákup, hrubý zisk a marža na objednávku.
sales_product_performance	reports:read	GET /sales/product-performance	Predaje po produktoch z dokladov; s právom aj nákupná cena v čase predaja a marža.
reviews_get	reviews:read	GET /reviews/:kind/:reviewId	Jedna recenzia s históriou odpovedí, jazykom, tónom a podpisom e-shopu a čakajúcim návrhom odpovede.
reviews_list	reviews:read	GET /reviews	Recenzie obchodu a produktov jedného e-shopu: hviezdičky, text, produkt, odpoveď e-shopu, čakajúci návrh; filtre a obdobie.
reviews_reply_create_draft	reviews:draft	—	zápis: NÁVRH odpovede na recenziu. Na web ho zverejní až človek schválením v MitoOps (alebo autonómny režim, ak ho vlastník zapol).
reviews_reply_draft_get	reviews:read	GET /reviews/reply-drafts/:draftId	Stav návrhu odpovede na recenziu: čaká na schválenie, zverejnený, zamietnutý, vypršaný.
reviews_statistics	reviews:read	GET /reviews/statistics	Štatistika recenzií e-shopu za obdobie: počet, bez odpovede, priemer, počet podľa hviezdičiek a po druhoch.
reviews_web_overview	reviews:read	GET /reviews/web-display	Blok recenzií na stránke produktu (skript na webe): či je zapnutý, podpora platformy a nastavenie (od akého hodnotenia, koľko, vlastné áno/nie, texty).
reviews_web_set	reviews-web:write	—	zápis: Zapne, vypne alebo upraví blok recenzií na stránke produktu: najprv náhľad s pokrytím a ukážkou, zápis až s confirmation. Do e-shopu nič nezapisuje.
search_console_query	search-console:read	GET /search-console/query	Search Console po dňoch, dopytoch, stránkach, krajinách a zariadeniach, so stránkovaním a odtlačkom.
search_console_status	search-console:read	GET /search-console/status	Stav Search Console e-shopu: pripojenie, property, oprávnenie, synchronizácia a rozsah archívu.
shipping_carriers	shipping:read	GET /shipping/carriers	Pripojení dopravcovia a ich profily, bez prístupových údajov.
shipping_overview	shipping:read	GET /shipping/overview	Prehľad expedície: na zabalenie, čaká na odovzdanie, na ceste, chyby dopravcu, dobierky, s rozpisom po e-shopoch.
shipping_packing_performance	shipping:read	GET /shipping/packing-performance	Výkon balenia po ľuďoch: počet zabalených objednávok, čas balenia (priemer a medián), čas do zabalenia a do odovzdania, porovnanie s tímom.
shipping_pickups	shipping:read	GET /shipping/pickups	Zvoz po dopravcoch: dokedy objednať, dokedy prevzatie, čo čaká na zvoz a objednané zvozy.
shipping_returns	shipping:read	GET /shipping/returns	Spätné zásielky (vratky) so stavom a reklamáciou, súčty na ceste a nevybavené po e-shopoch.
shipping_shipment_detail	shipping:read	GET /shipping/shipments/:shipmentId	Jedna zásielka so všetkými udalosťami sledovania.
shipping_shipments	shipping:read	GET /shipping/shipments	Zásielky jedného e-shopu s dopravcom, krajinou a časmi odovzdania a doručenia.
shipping_stats	shipping:read	GET /shipping/stats	Štatistiky doručovania podľa dopravcov: počty, úspešnosť, medián a p90 času doručenia, krajiny.
stores_integration_status	stores:read	GET /stores/integration-status	Stav MitoOps kódu na webe po e-shopoch: nainštalované, verzia, moduly, pripravenosť kupónu z adresy.
stores_list	stores:read	GET /stores	Zoznam e-shopov klienta aj s ich kódom.
purchasing_advisor	purchasing:read	GET /purchasing/advisor	Nákupný návrh: čo dokúpiť a koľko, naliehavosť, stav, minimum a odhad potreby; globálne za jeden sklad.
suppliers_get	purchasing:read	GET /suppliers/:supplierId	Jeden dodávateľ s ponukami produktov a nákladovými zložkami.
suppliers_list	purchasing:read	GET /suppliers	Dodávatelia klienta s počtom ponúk a napárovaných produktov.
webhooks_deliveries	webhooks:read	GET /webhooks/endpoints/:endpointId/deliveries	Denník doručení jedného endpointu bez tela.
webhooks_endpoint	webhooks:read	GET /webhooks/endpoints/:endpointId	Jeden webhook endpoint s počtom čakajúcich doručení.
webhooks_endpoints	webhooks:read	GET /webhooks/endpoints	Webhook endpointy klienta bez tajomstiev a stav fronty.
webhooks_events	webhooks:read	GET /webhooks/events	Katalóg udalostí odchádzajúcich webhookov, obálka a podpis.

Meno, e-mail, telefón a ulica zákazníka sú v orders_list, orders_get, claims_list a claims_get iba s rozsahom personal-data:read; bez neho odpoveď nesie krajinu a mesto. To isté platí pre kontakt dodávateľa a partnera programu (affiliate_partners_*). Rozsah nemá vlastný nástroj.

V adresári zákazníkov (customers_list, customers_get) rozhoduje ten istý rozsah o mene, firme, e-maile, telefóne a marketingovom pohlaví; bez neho zostane pseudonym, e-shopy, krajina, jazyk, počty a dátumy. Obrat a LTV sú navyše za reports:read. Marketingové pohlavie je odhad z krstného mena (genderSource: "name_inference"), nie údaj, ktorý by zákazník uviedol — asistent ho tak má aj podávať. Bankové a daňové údaje partnerov sa nevydávajú nikdy.

Webový chatbot — témy rozhovorov. chatbot_topics (ten istý rozsah chatbot:read) odpovie jedným volaním na otázku „o čom to bolo“: podiel rozhovorov po témach z uzavretej taxonómie (doprava, platba, vrátenie, výber produktu, parametre, používanie, vzdelávacie otázky…), miera vyriešenia a počet kandidátov na medzeru v znalostiach po téme, najčastejšie produkty (na ktoré sa zákazníci pýtali a ktoré bot odporučil), z akého typu stránky rozhovory začínajú a vývoj po dňoch. Vyhodnotenie je deterministické — stojí na zdrojoch odpovedí, odporúčaných produktoch a slovníku kľúčových slov, takže dve volania nad tým istým obdobím dajú to isté číslo. Vracia iba súčty: text zákazníka sa doň nedostane žiadnou cestou, ani ako „najčastejšia otázka“. Podiel ide vždy s počtom — pri malom počte rozhovorov je percento nespoľahlivé. chatbot_conversations_list má filtre topic a knowledgeGapCandidate; prepis konkrétneho rozhovoru je ďalej za citlivým rozsahom a iba v rámci retencie.

Webový chatbot. Štatistika (chatbot_stats, rozsah chatbot:read) vracia iba súčty: koľkým návštevám stránky sa ukázala bublinka a koľko z nich na ňu kliklo, otvorenia okna, počet rozhovorov a správ, čo bot vybavil, hodnotenia zákazníkov a lievik registrácie na newsletter. Rozhovory zákazníkov (chatbot_conversations_list, chatbot_conversations_get) sú za vlastným citlivým rozsahom chatbot-conversations:read, ktorý na obrazovke súhlasu zaškrtnete vedome: zákazník je v evidencii iba náhodný kľúč rozhovoru (bez IP, cookie, mena či e-mailu), e-mail, telefón a IBAN, ktoré napísal do textu, dostane asistent iba s personal-data:read — inak namiesto nich vidí značku [e-mail], [telefón], [iban]. Rozhovory sa vydávajú iba v rámci retencie e-shopu (nastavenie História v AI centre); e-shop s retenciou nula nevydá nič. Zobrazenia bublinky sa do 21. 9. 2026 rátali pri každom vyskočení hlášky; od 22. 9. 2026 je zobrazenie jedna návšteva stránky a measurementChanges v odpovedi hovorí, či zvolené obdobie mieša obe merania.

Každý nástroj má náprotivok v REST nad tou istou schopnosťou. Odpovede sa líšia obálkou, obchodné údaje sú zhodné. Pravidlá obdobia, stránkovania a význam finančných polí sú v REST rozhraní.

Súhrnné nástroje (shipping_stats, analytics_*, reports_financial_summary) vracajú hotové čísla z aplikácie — asistent nemusí sťahovať tisíce záznamov a počítať sám. Surové zoznamy (shipping_shipments, orders_list) zostávajú pre podrobný pohľad.

Na čo sa dá pýtať

Po pripojení odpovie Claude.ai z údajov MitoOps napríklad na:

• „Aké bolo percentuálne rozloženie dopravy za august?“ — shipping_stats
• „Aký bol medián času doručenia DHL a GLS?“ a „Koľko bolo nedoručených a vrátených?“ — shipping_stats
• „Do ktorých krajín sme cez DHL posielali?“ — shipping_stats (pole countries)
• „Aký bol obrat a konverzný pomer za august?“ — analytics_overview alebo reports_financial_summary
• „Koľko objednávok a obratu prišlo z ChatGPT?“ — analytics_channels
• „Aké dopyty mali najvyššie CTR?“ — analytics_seo
• „Aká je marža produktu X za posledný mesiac?“ — sales_product_performance (s purchase-prices:read)
• „Na čo sa zákazníci najčastejšie pýtali chatbota tento mesiac a o čom napísať článok na blog?“ — chatbot_conversations_list a chatbot_conversations_get (s chatbot-conversations:read)
• „Koľko rozhovorov mal chatbot a koľko z nich vybavil bez podpory?“ — chatbot_stats
• „Aké dostupnosti má e-shop SK a ktoré sú predvolené?“ (availabilities_list)
• „Pridaj na e-shop SK dostupnosť Predpredaj október s významom predpredaj a doručením do 14 dní“ (availabilities_change_draft s availabilities:draft; vznikne návrh, ktorý zapíšete schválením v aplikácii)
• „Ktoré dostupnosti na e-shope CZ nie sú spárované so SK?“ (availabilities_pairing)
• „Na ktoré 5★ recenzie na e-shope SK sme ešte neodpovedali? Priprav na ne odpovede.“ (reviews_list, potom reviews_reply_create_draft s reviews:draft; vzniknú návrhy, ktoré zverejníte schválením v aplikácii)
• „Uprav zapnutú automatizáciu 12 tak, aby posielala upozornenie iba pri doprave Kuriér“ (automations_options pre dopravu, potom automations_revision_create_draft; bežiaca verzia sa nezmení, kým revíziu nepublikujete v editore)
• „Aké e-maily posielajú reklamácie automaticky a čo v nich stojí po nemecky?“ (claims_templates s claims-settings:read)
• „Premenuj stav reklamácie Čaká na tovar na Čakáme na zásielku“ (claims_settings pre ID, potom claims_config_change_draft s claims-settings:draft; zapíšete schválením v aplikácii)

Čítanie a úzke zápisy: automatizácie, kupón, partnerský program, dostupnosti, reklamácie

Prevádzkové dáta (objednávky, stav zásob, produkty, doklady, zásielky) sa cez MCP iba čítajú. Každý zápis stojí za vlastným citlivým rozsahom: koncept automatizácie, zľavový kupón, správa partnerského programu, rozhodnutie o provízii, návrh zmeny číselníka dostupností, ktorý do e-shopu zapíše až človek, a návrh zmeny nastavení reklamácií, ktorý tiež zapíše až človek.

Koncept automatizácie — s rozsahom automations:write je to vypnutý koncept: s rozsahom automations:write môže asistent podľa katalógu (automations_catalog) navrhnúť pravidlo a uložiť ho ako koncept, alebo upraviť koncept, ktorý ešte nikto nepublikoval. Koncept sa objaví v Automatizácie ako každý rozrobený návrh — zapnúť, publikovať alebo spustiť ho môžete iba vy v aplikácii. Publikovanú automatizáciu asistent priamo nezmení.

Revízia bežiacej automatizácie. Aj publikovanú a zapnutú automatizáciu môže asistent s rozsahom automations:write upraviť, ale iba návrhom: automations_revision_create_draft (vstup workflowId, expectedPublishedVersion z automations_get, catalogVersion, celé nové dsl, note a clientRequestId) uloží revíziu vedľa bežiacej verzie. Bežiaca automatizácia sa nemení a beží ďalej. Na jednu automatizáciu je najviac jedna otvorená revízia; upraví sa cez automations_revision_update_draft s expectedRevisionVersion a zahodí cez automations_revision_discard_draft. Odpoveď nesie approvalUrl, odkaz do editora automatizácie. Tam človek s právom upravovať automatizácie revíziu uvidí v hornom paneli, načíta ju do editora (tlačidlo Načítať návrh do editora), skontroluje a publikuje bežným tlačidlom; automatizácia zostane zapnutá. Alebo ju zamietne. Keď medzitým niekto publikoval inú verziu, revízia sa uzavrie (REVISION_STALE) a treba pripraviť novú. Otvorenú revíziu aj históriu vráti automations_get (openRevision, revisions).

Číselníky polí a overenie hodnôt. Polia, ktoré sa v editore vyberajú zo zoznamu (stav objednávky, doprava, platba, profil dopravcu, šablóna upozornenia, typ, stav, štítok a šablóny reklamácie, webhook endpoint a ďalšie), majú v katalógu zdroj. automations_options so source a market vráti ich hodnoty [{ value, name }] presne v tvare, ktorý editor ukladá (ID stavu, GUID dopravy a platby, ID stavu reklamácie); bez source vypíše zdroje a či sú pre každý e-shop iné (perShop). Validácia (automations_validate_draft) aj uloženie konceptu či revízie odmietne hodnotu, ktorá v e-shope neexistuje (FIELD_UNKNOWN_OPTION), a zástupný text typu DOPLNIT_… alebo TODO (FIELD_PLACEHOLDER). Keď sa zoznam nedá overiť (e-shop neodpovedal, zoznam je orezaný), príde iba upozornenie FIELD_OPTIONS_UNVERIFIED. orders_get a orders_list nesú statusId, shippingGuid a paymentGuid, teda tie isté hodnoty, s ktorými pracujú podmienky automatizácie.

Rozsah automations:write je citlivý: na obrazovke súhlasu nie je predznačený, ponúkne sa iba človeku s právom automatizácie upravovať, existujúce pripojenia ho nedostanú a obnova tokenu ho nerozšíri. Objednávky, produkty, stav zásob, doklady, refundácie, reklamačné prípady ani zásielky sa cez MCP meniť nedajú; číselník dostupností e-shopu a nastavenia reklamácií sa menia iba návrhom, ktorý schváli človek v aplikácii (nižšie). Webhook endpointy sa cez MCP iba čítajú. Prístupové údaje k dopravcom, e-shopu ani k analytike sa cez MCP nedajú prečítať.

Zľavový kupón — s rozsahom coupons:write asistent založí kupón podľa parametrov, ktoré zadáte (coupons_ensure, aj kupón partnera affiliate_discount_codes_ensure), a výslovne upraví existujúci (coupons_update, náhľad a potvrdenie); mazanie má vlastný rozsah coupons:delete a kupón so živou závislosťou sa nezmaže.

Správa partnerského programu — s rozsahom affiliate:write asistent rozhodne o účte partnera (affiliate_partners_set_state: schváliť, zamietnuť, pozastaviť; partner dostane e-mail aj s PDF dohody podľa politiky dokumentov), vybaví žiadosť o vlastný kód (affiliate_code_requests_decide), upraví nastavenie programu mimo peňazí (affiliate_settings_update: názov, registrácia, kontaktná osoba, farby), texty portálu v jednom jazyku (affiliate_portal_pages_update), články nápovedy (affiliate_articles_create, affiliate_articles_update aj s obnovou predvoleného znenia, affiliate_articles_set_state; mazanie zvonku nie), šablóny e-mailov (affiliate_email_templates_update), kampane (affiliate_campaigns_create, affiliate_campaigns_update), politiku dokumentov (affiliate_documents_update) a členstvo partnera v e-shope (affiliate_partners_set_market: povoliť alebo odobrať). Znenie právnych dokumentov si prečíta (affiliate_documents_get: text po jazykoch, verzia, odtlačky, koncepty) a nové znenie navrhne iba ako koncept (affiliate_documents_draft_create; aj privacyNotice v affiliate_portal_pages_update je od tejto verzie koncept) — živé znenie zverejní človek v aplikácii s rozdielom a auditom. Register premenných obsahu a e-mailov (kanonické mená, aliasy, typ, plochy) vydá affiliate_variables_list; affiliate_email_templates_list vracia mená premenných, nie indexy. Výplaty, základ provízie ani nahranie súboru dokumentu cez MCP neexistujú — zostávajú v aplikácii.

Rozhodnutie o provízii — s vlastným citlivým rozsahom affiliate:approve (právo schvaľovanie provízií, nie správa programu) asistent najprv prečíta čakajúce provízie aj so stavom objednávky v e-shope (affiliate_conversions_list s state=new, detail affiliate_conversions_get: základ provízie revenue, celá objednávka s DPH revenueTotal, orderState open/completed/cancelled, orderPaid, dobropis), zhrnie ich a až na výslovný pokyn používateľa rozhodne o jednej konkrétnej konverzii (affiliate_conversions_decide: approve, reject alebo cancel, pri zamietnutí a zrušení s povinným dôvodom, ktorý partner dostane e-mailom). Platí ten istý stavový automat ako v aplikácii: vyplatená provízia sa nevracia, zrušená a zamietnutá sú koncové, rovnaké rozhodnutie druhýkrát nič nemení (changed: false). Hromadné schválenie zvonku neexistuje — na sto konverzií je sto volaní, každé s auditom. Od W-AFF10 nesie každá konverzia aj approvalPolicy (spôsob schvaľovania kampane, lehota, povolené stavy objednávky, zaplatenie) a approvalEligibility — či by ju hodinová automatika teraz schválila a prečo nie (minimum_age_not_reached, order_state_not_allowed, order_not_paid, order_cancelled, fully_refunded, approval_manual…), ten istý výpočet ako v aplikácii; zoznam má filtre orderPaid, minCommission, orderState a stránkovanie offset + hasMore, takže „prejdi nové konverzie za dva mesiace, ukáž nezaplatené alebo tie nad 20 €“ je jedno až niekoľko čítaní. Podmienky kampane nastaví affiliate_campaigns_update (approval, approveAfterDays, requiredOrderStatusIds, paidRequired) s rozsahom affiliate:write. Výplaty partnerom sa cez MCP iba čítajú (affiliate_payouts_list) — vystaviť dávku, vygenerovať doklad, odoslať ho partnerovi ani podať príkaz do banky asistent nevie; to zostáva v aplikácii pod rukou prevádzkovateľa.

Návrh zmeny číselníka dostupností. S citlivým rozsahom availabilities:draft asistent pripraví návrh, ako na jednom e-shope založiť, upraviť alebo zmazať dostupnosti (availabilities_change_draft, iba MCP). Do e-shopu nezapíše nič: návrh overí, uloží v MitoOps na 24 hodín a vráti draftId, náhľad po položkách (preview s poliami pred a po, warnings a errors), expiresAt a approvalUrl, odkaz na obrazovku Sklad → Dostupnosti, kde návrh čaká v karte Správa. Tam ho človek s oprávnením schváli tlačidlom Schváliť a zapísať alebo zamietne a zápis prebehne s jeho právami v čase kliknutia. Keď sa číselník e-shopu od návrhu zmení, schválenie nezapíše nič a návrh skončí ako failed. Stav a výsledok po položkách vráti availabilities_draft_get: pending, writing, executed, partial, failed, rejected alebo expired. Keď náhľad hlási blokovanie, návrh nevznikne (blocked), a keď sa nič nemení, tiež nie (no_change).

Vstup je market a changes (najviac 30 položiek). Každá zmena má action (create, update alebo remove), pri úprave a zmazaní id z availabilities_list a iba polia, ktoré sa majú zmeniť: name (najviac 120 znakov, v jazyku e-shopu), description (najviac 1000 znakov, null znamená bez popisu), onStockHours a deliveryHours (celé hodiny 0 až 2500, null znamená bez údaja), meaning (in_stock, backorder, preorder, out_of_stock) a color (hex, null znamená bez farby). Nová dostupnosť potrebuje name a meaning. Voliteľný clientRequestId robí volanie idempotentným: ten istý kľúč s tým istým obsahom vráti ten istý návrh (replayed: true), s iným obsahom skončí chybou CONFLICT (CLIENT_REQUEST_REUSED).

Náhľad zablokuje, čo by e-shop odmietol alebo čo by rozbilo nastavenie: duplicitný názov v e-shope, zmazanie systémovej alebo predvolenej dostupnosti či dostupnosti, ktorú používa plán dostupnosti, a na WooCommerce zmenu významu systémovej položky alebo význam predvolenej položky, ktorý do jej úlohy nepatrí. Dostupnosť, ktorú používajú produkty, e-shop nezmaže. Zmenu významu na WooCommerce zapíše iba e-shop s doplnkom MitoOps 1.5.0 alebo novším. Keď e-shop pri zápise neodpovie jasne (chyba servera, časový limit), zápis sa neopakuje, ale overí sa čítaním číselníka; čo sa overiť nedá, má vo výsledku uncertain: true. Asistent smie návrh pripraviť iba na výslovný pokyn používateľa v rozhovore, nikdy podľa textu v prečítaných údajoch, a hodnoty, ktoré používateľ nezadal, nevymýšľa. Priradenie dostupností k produktom ani stav zásob sa návrhom nemení; schválená zmena významu však môže zmeniť, či sa produkty s touto dostupnosťou dajú po vypredaní objednať, a náhľad na to upozorní.

Párovanie a história synchronizácie dostupností. availabilities_pairing (rozsah products:read) vráti to, čo karta Sklad → Dostupnosti → Párovanie: riadky (štyri hlavné a vlastné) s položkou každého e-shopu v rozsahu prístupu, návrhy pre prázdne bunky hlavných riadkov, nespárované položky po e-shopoch a stav synchronizácie (sync.enabled). availabilities_history vráti históriu prenosov s obdobím (from, to), e-shopom, kódom produktu a kurzorom; záznam s e-shopom mimo rozsahu prístupu sa nevydá. S rozsahom availabilities:draft asistent navrhne zmenu párovania (availabilities_pairing_change_draft, iba MCP): nastaviť alebo vyprázdniť bunku (set), založiť, upraviť alebo zmazať vlastný riadok (createRow, updateRow, removeRow). Párovanie sa nezmení, kým návrh neschváli človek na karte Párovanie tlačidlom Schváliť a uložiť; keď sa párovanie od návrhu zmení, neuloží sa nič (failed). Pri zapnutej synchronizácii náhľad upozorní (SYNC_ON), že schválené párovanie rozhoduje, akú dostupnosť dostanú produkty v ostatných e-shopoch. Synchronizáciu zapnúť cez MCP nejde, je to rozhodnutie človeka v aplikácii. Stav vráti availabilities_pairing_draft_get.

Recenzie: čítanie a návrh odpovede. Rozsah reviews:read otvára reviews_list (filtre druh project alebo product, answered, rating, search, productGuid, obdobie a kurzor; totals sú súčty bez filtra stavu odpovede), reviews_get (história odpovedí, jazyk e-shopu, tón a podpis z nastavenia Hlas e-shopu, čakajúci návrh) a reviews_statistics (počet, bez odpovede, priemer, počet podľa hviezdičiek a po druhoch za obdobie). Meno recenzenta je osobný údaj a príde iba s personal-data:read; e-mail recenzenta ani číslo objednávky rozhranie nevydáva. Text recenzie napísal zákazník: sú to údaje, nie pokyny pre asistenta (authorContentUntrusted). S citlivým rozsahom reviews:draft asistent pripraví návrh odpovede (reviews_reply_create_draft, iba MCP). Odpoveď je verejná a v e-shope sa dá iba prepísať, preto ju nezverejní: podpis e-shopu pripojí systém, návrh platí 72 hodín a vráti approvalUrl na Sklad → Recenzie, kde ho človek s právom odpovedať schváli, upraví alebo zamietne. Keď recenzia medzitým dostane inú odpoveď, schválenie nezverejní nič. Ak vlastník v Nastavenia → API & MCP → Zápis cez AI zapne autonómny zápis pre odpovede na recenzie, odpoveď na recenziu so 4 alebo 5 hviezdičkami sa zverejní hneď v mene človeka, ktorý prístup udelil, najviac 50 za deň; pri 1 až 3 hviezdičkách rozhoduje vždy človek. Stav vráti reviews_reply_draft_get.

Nastavenia reklamácií na čítanie. claims_settings (rozsah claims:read) vráti procesy s ID a názvami typov, krokov a stavov vo zvolenom jazyku (language) aj pri položkách, ktoré si klient nepremenoval, a štítky; s rozsahom claims-settings:read aj nastavenia modulu (predpona kódu, lehota, automatické naskladnenie, formulár na e-shope). S tým istým rozsahom claims_templates vráti e-mailové šablóny (jazyk, predmet, text, HTML, kedy sa posielajú trigger, či odchádzajú samy autoSend, ktorý protokol priložia) a šablóny protokolov, filtrované podľa language alebo templateKey; claims_configuration vráti štítky, vlastné polia, dôvody vrátenia, trasy a adresy spätnej dopravy, formulár na e-shope po e-shopoch (bez tokenu integrácie) a typy formulára s vlastnými textami. Kontakt a ulica adresy predajcu sú iba s personal-data:read. claims_get nesie časovú os prípadu (správy, poznámky, zmeny stavu), odoslané e-maily (šablóna, predmet, stav, bez adresy príjemcu) a štítky; text správ je iba s personal-data:read.

Návrh zmeny nastavení reklamácií. S citlivým rozsahom claims-settings:draft asistent pripraví návrh (claims_config_change_draft, iba MCP): založiť alebo upraviť typ, krok a stav procesu (názvy po jazykoch, farba, predvolený a uzatvárací stav, lehota), štítok, text e-mailovej šablóny v jednom jazyku, jej automatické odoslanie a text šablóny protokolu. Mazanie nie je. Do nastavení nezapíše nič: návrh overí tými istými pravidlami ako obrazovka (napríklad neznáma premenná v šablóne ho zablokuje), uloží ho v MitoOps na 72 hodín a vráti draftId, náhľad (preview, pole pred a po, errors), expiresAt a approvalUrl, odkaz na Reklamácie → Nastavenia, kde návrh čaká v paneli Návrhy zmien na schválenie. Človek s právom spravovať nastavenia ho schváli (Schváliť a zapísať) alebo zamietne. Návrh sa zapíše celý, alebo vôbec: keď sa niektorá hodnota od prípravy návrhu zmenila, nezapíše sa nič a návrh skončí ako failed. Stav vráti claims_config_draft_get (pending, executed, failed, rejected, expired); keď náhľad hlási chybu, návrh nevznikne (blocked), a keď sa nič nemení, tiež nie (no_change). ID a kľúče berie asistent z claims_settings a claims_templates; clientRequestId robí volanie idempotentným.

Recepty. Server ponúka MCP prompts sales_drop_diagnosis (diagnostika poklesu predajov), winback_campaign (kampaň na návrat zákazníkov) , weekend_promotion (víkendová akcia) a campaign_360 (kampaň so skrytou kategóriou, produktmi, bannerom, kupónom a zobrazením od–do). Recept je iba postup: povie asistentovi, ktoré nástroje použiť a v akom poradí. Žiadne právo navyše nemá, každý krok prejde rozsahom, tarifou a potvrdením svojho nástroja.

Nástroje nesú anotácie podľa revízie protokolu (readOnlyHint, destructiveHint, idempotentHint); automations_create_draft je idempotentný cez clientRequestId, automations_update_draft vyžaduje expectedVersion a pri zmene katalógu vráti CATALOG_CHANGED; automations_revision_create_draft je idempotentný cez clientRequestId a automations_revision_update_draft vyžaduje expectedRevisionVersion.

Povolenie sa dá odobrať

Zrušením povolenia v Nastavenia → API & MCP prestanú platiť všetky prístupy, ktoré z neho vznikli — okamžite, nie po vypršaní. To isté sa stane, keď konektor odpojíte v Claude.ai.

Verzie protokolu

Server hovorí revíziou 2026-07-28 aj staršími (2025-11-25, 2025-06-18, 2025-03-26). Klient si vyberie sám podľa toho, čo pošle; staršie klientske knižnice sa teda pripoja bez úpravy.

Novšia revízia je bez úvodného handshaku a bez relácie: každá požiadavka nesie vlastnú verziu a povinné hlavičky MCP-Protocol-Version, Mcp-Method a pri volaní nástroja Mcp-Name. Ak sa hlavička rozíde s telom, odpoveď je 400 — smerovať podľa hlavičiek a vykonávať podľa tela by znamenalo dva zdroje pravdy o tom istom volaní.

Súvisiace

• Prehľad
• REST rozhranie
• Odchádzajúce webhooky
• Dostupnosti