MCP rozhraní

Ověřenoověřeno 2026-09-03

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í.

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í.

V Claude.ai otevřete Settings (Nastavení) → Customize → Connectors (na týmovém plánu nejprve Organization settings → Connectors jako správce).
Stiskněte Add custom connector (Přidat vlastní konektor).
Do pole Name napište MitoOps.
Do pole URL vložte adresu rozhraní MCP z obrazovky Nastavení → API & MCP — ve tvaru https://<vaše adresa>/api/mcp, například https://app.mitoops.com/api/mcp.
Advanced settings nechte prázdné: Claude.ai použije vlastní hostovaná metadata klienta (OAuth). Stiskněte Add.
U konektoru stiskněte Connect (Připojit).
Otevře se přihlášení do MitoOps (i s druhým faktorem, pokud jej máte). Přihlaste se.
Uvidíte obrazovku souhlasu: která aplikace, který klient, co smí číst a kterých e-shopů se to týká.
Zkontrolujte rozsahy. Citlivé (Výkazy, Nákupní ceny, Osobní údaje zákazníků, Dodavatelé a nákup a Automatizace – návrhy) nejsou zaškrtnuté — pokud má Claude vidět marži, osobní údaje nebo navrhovat vypnuté koncepty automatizací, zaškrtněte je vědomě. Vyberte e-shopy.
Stiskněte Povolit. Claude.ai se vrátí na svou stránku a konektor je připojen.
V rozhovoru stiskněte + → Connectors a konektor MitoOps zapněte.

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:

Aplikace si od nás vyžádá, kam poslat přihlášení (metadata chráněného zdroje podle RFC 9728).
Otevře se vaše přihlášení do MitoOps.
Uvidíte obrazovku souhlasu a vyberete rozsahy a e-shopy.
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_entitlements`	`account:read`	`GET /account/entitlements`	Tarif klienta, funkce a limity s aktuálním využitím.
`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: schválení kód rezervuje, zamítnutí vyžaduje důvod; partner dostane e-mail.
`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_list`	`affiliate:read`	`GET /affiliate/conversions`	Konverze partnerského programu e-shopu s provizí, stavem a vazbou na výplatu.
`affiliate_discount_codes_ensure`	`coupons:write`	—	zápis: Ať má partner na e-shopu slevový kód: kupón se založí přes kanonické kupóny (nebo se použije existující) a přiřadí partnerovi; poznámka v e-shopu vzniká automaticky.
`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_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, podepsaná 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_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_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.
`analytics_channels`	`analytics:read`	`GET /analytics/channels`	Kanály návštěvnosti včetně ChatGPT a dalších AI zdrojů.
`analytics_order_coverage`	`analytics:read`	`GET /analytics/order-coverage`	Pokrytí objednávek měřením.
`analytics_overview`	`analytics:read`	`GET /analytics/overview`	Návštěvy, objednávky, obrat, konverzní poměr, AOV, podíl AI zdrojů.
`analytics_seo`	`analytics:read`	`GET /analytics/seo`	Search Console podle dotazů nebo stránek.
`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_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.
`claims_get`	`claims:read`	`GET /claims/:code`	Jedna reklamace s položkami, refundacemi a zpětnými zásilkami.
`claims_list`	`claims:read`	`GET /claims`	Reklamace a vrácení jednoho e-shopu s vazbami na objednávku.
`claims_settings`	`claims:read`	`GET /claims/settings`	Procesy reklamací (typy, kroky, stavy, lhůty); nastavení modulu jen s právem na ně.
`claims_statistics`	`claims:read`	`GET /claims/statistics`	Statistika reklamací a vrácení za období: počty, doby vyřízení, typy, hodnocení, důvody.
`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. Při jiné výši slevy se NEPŘEPÍŠE.
`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.
`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í.
`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.
`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.
`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_stock`	`inventory:read`	`GET /inventory/stock`	Stav zásoby jedné položky i se zdrojem hodnoty.
`orders_get`	`orders:read`	`GET /orders/:orderCode`	Jedna uložená objednávka včetně položek.
`orders_list`	`orders:read`	`GET /orders`	Uložené objednávky jednoho e-shopu, od nejnovější.
`categories_list`	`products:read`	`GET /categories`	Kategorie e-shopu s počtem produktů.
`products_get`	`products:read`	`GET /products/:code`	Jeden produkt podle kódu včetně zařazení a ceny z karty.
`products_search`	`products:read`	`GET /products`	Hledání produktů podle názvu, kódu, EAN nebo PLU.
`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.
`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í.
`shipping_carriers`	`shipping:read`	`GET /shipping/carriers`	Připojení dopravci a profily, bez přístupových údajů.
`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.
`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.
`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.

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)

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

Provozní data (objednávky, sklad, produkty, doklady, zásilky) se přes MCP jen čtou. Zápisy jsou tři a každý stojí za vlastním citlivým rozsahem.

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 nezmění (vytvoří nový návrh).

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, sklad, doklady, refundace, reklamace ani zásilky se přes MCP měnit nedají a 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) a politiku dokumentů (affiliate_documents_update). Schvalování konverzí, výplaty, základ provize ani nahrání souboru dokumentu přes MCP neexistují — zůstávají v aplikaci.

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.

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í.