Preskočiť na obsah

MCP rozhranie

Overené

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.

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

Sekcia „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) → CustomizeConnectors (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 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.
  9. Skontrolujte rozsahy. Citlivé (Výkazy, Nákupné ceny, Osobné údaje zákazníkov, Dodávatelia a nákup a Automatizácie – návrhy) nie sú zaškrtnuté — ak má Claude vidieť maržu, osobné údaje alebo navrhovať vypnuté koncepty automatizácií, zaškrtnite ich vedome. 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.

Č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

Sekcia „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

Sekcia „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.

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_entitlements account:read GET /account/entitlements Tarifa klienta, funkcie a limity s aktuálnym využitím.
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: schválenie kód rezervuje, zamietnutie vyžaduje dôvod; partner dostane e-mail.
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_list affiliate:read GET /affiliate/conversions Konverzie partnerského programu e-shopu s províziou, stavom a väzbou na výplatu.
affiliate_discount_codes_ensure coupons:write zápis: Nech má partner na e-shope zľavový kód: kupón sa založí cez canonical kupóny (alebo použije existujúci) a priradí partnerovi; poznámka v e-shope vzniká automaticky.
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_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_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_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.
analytics_channels analytics:read GET /analytics/channels Rozloženie návštev, objednávok a obratu podľa marketingových kanálov.
analytics_order_coverage analytics:read GET /analytics/order-coverage Pokrytie objednávok a obratu meraním v analytike.
analytics_overview analytics:read GET /analytics/overview Návštevy, objednávky, obrat, konverzný pomer a AI/LLM podiel za obdobie.
analytics_seo analytics:read GET /analytics/seo Search Console: kliknutia, zobrazenia, CTR a pozícia podľa dopytov alebo stránok.
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_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.
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_settings claims:read GET /claims/settings Procesy reklamácií (typy, kroky, stavy, lehoty); nastavenia modulu iba s právom na ne.
claims_statistics claims:read GET /claims/statistics Štatistika reklamácií a vrátení za obdobie: počty, časy vybavenia, typy, hodnotenia, dôvody.
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. Pri inej výške zľavy sa NEPREPÍŠE.
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.
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.
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.
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.
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_stock inventory:read GET /inventory/stock Stav zásoby jednej položky aj so zdrojom hodnoty.
orders_get orders:read GET /orders/:orderCode Jedna uložená objednávka vrátane položiek.
orders_list orders:read GET /orders Uložené objednávky jedného e-shopu, od najnovšej.
categories_list products:read GET /categories Kategórie e-shopu s počtom produktov.
products_get products:read GET /products/:code Jeden produkt podľa kódu vrátane zaradenia a ceny z karty.
products_search products:read GET /products Hľadanie produktov podľa názvu, kódu, EAN alebo PLU.
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.
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.
shipping_carriers shipping:read GET /shipping/carriers Pripojení dopravcovia a ich profily, bez prístupových údajov.
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.
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.

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.

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)

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

Sekcia „Čítanie a úzke zápisy: koncept automatizácie, kupón, partnerský program“

Prevádzkové dáta (objednávky, sklad, produkty, doklady, zásielky) sa cez MCP iba čítajú. Zápisy sú tri a každý stojí za vlastným citlivým rozsahom.

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 nezmení (vytvorí nový návrh).

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, sklad, doklady, refundácie, reklamácie ani zásielky sa cez MCP meniť nedajú a 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) a politiku dokumentov (affiliate_documents_update). Schvaľovanie konverzií, výplaty, základ provízie ani nahranie súboru dokumentu cez MCP neexistujú — zostávajú v aplikácii.

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.

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