MCP interfész

Röviden

A MitoOps szabványos távoli MCP-szervert (Model Context Protocol) biztosít a /api/mcp címen, amelyen keresztül egy kompatibilis AI-alkalmazás maga kéri le az adatokat. Ugyanazokra a képességekre épül, mint a REST: nem egy második interfész saját lekérdezésekkel, hanem egy másik módja annak, hogy ugyanazt kérdezze meg.

Az MCP nem a modell tulajdonsága, hanem az alkalmazásé, amelyben a modell fut (a kliensé). Minden olyan alkalmazás csatlakozhat, amely támogatja a távoli MCP-t HTTP-n keresztül OAuth-tal vagy hozzáférési kulccsal. A Claude.ai éles üzemben ellenőrzött kliens: pontos folyamatát lent találja, más alkalmazásra a következő szakasz általános folyamata vonatkozik. Az általunk nem tesztelt klienseket nem nyilvánítjuk ellenőrzöttnek.

Kétféleképpen igazolhatja magát:

• hozzáférési kulccsal, amelyet az alkalmazásban állít ki: saját programhoz vagy olyan szerverhez, amely szervert hív;
• OAuth-on keresztül, ha a csatlakozó AI-alkalmazás ezt támogatja: ilyenkor Ön jelentkezik be, és a jóváhagyási képernyőn kiválasztja, mit olvashat az alkalmazás.

A token mindkét esetben az Authorization: Bearer fejlécben utazik, és mindkét esetben ugyanaz a jogosultsági hatókör érvényes: amit a kulcs vagy a hozzájárulás nem fed le, azt az eszköz nem adja vissza.

A Claude.ai csatlakoztatása: ellenőrzött csatlakozás lépésről lépésre

A Claude.ai nem az egyes webáruházakhoz csatlakozik, hanem a MitoOpshoz, ahhoz a réteghez, amely már összefogja az összes webáruháza adatait. Nincs szüksége kulcsra, Client ID-ra vagy titokra. A Claude.ai mindent maga derít ki az interfész címéből.

1. A Claude.ai-ban nyissa meg a Settings (Beállítások) → Customize → Connectors menüt (csapatcsomagnál előbb adminisztrátorként az Organization settings → Connectors alatt).
2. Kattintson az Add custom connector (Egyéni csatlakozó hozzáadása) gombra.
3. A Name mezőbe írja be: MitoOps.
4. Az URL mezőbe illessze be az MCP-interfész címét a Beállítások → API & MCP képernyőről, https://<az Ön címe>/api/mcp formában, például https://app.mitoops.com/api/mcp.
5. Az Advanced settings részt hagyja üresen: a Claude.ai a saját hosztolt kliens-metaadatait használja (OAuth). Kattintson az Add gombra.
6. A csatlakozónál kattintson a Connect (Csatlakozás) gombra.
7. Megnyílik a MitoOps bejelentkezés (a második faktorral együtt, ha használja). Jelentkezzen be.
8. Megjelenik a jóváhagyási képernyő: melyik alkalmazás, melyik kliens, mit olvashat és mely webáruházakra vonatkozik. A jogosultságok az alkalmazás területei szerint vannak csoportosítva (értékesítés, raktár, szállítás, marketing, partnerprogram, automatizálások). Az olvasás előre be van jelölve, az érzékeny adatok és a piszkozatok előkészítése nem; a közvetlen hatású változtatások (például kuponok törlése vagy kiküldés jóváhagyása) egyenként a becsukott Speciális jogosultságok részben vannak. Minden csoportnál szerepel, pontosan mit tartalmaz.
9. Ellenőrizze a hatóköröket. Az érzékenyek (például Kimutatások, Beszerzési árak, Ügyfelek személyes adatai, Beszállítók és beszerzés, Automatizációk: tervezetek, Elérhetőségek: módosítási javaslatok és Reklamációk: beállítások módosítási javaslatai) nincsenek bejelölve. Ha a Claude-nak látnia kell az árrést és a személyes adatokat, vagy automatizálási piszkozatokat és módosításokat, illetve az elérhetőségek vagy a reklamációs beállítások módosítását kell javasolnia, jelölje be őket tudatosan. A reklamációk sablonjait és beállításait a Reklamációk: beállítások és sablonok hatókör olvassa. Válassza ki a webáruházakat.
10. Kattintson az Engedélyezés gombra. A Claude.ai visszatér a saját oldalára, és a csatlakozó csatlakoztatva van.
11. A beszélgetésben kattintson a + → Connectors elemre, és kapcsolja be a MitoOps csatlakozót.

2026. szeptember 2. előtt csatlakoztatott csatlakozó

Ha a csatlakozót korábban csatlakoztatta, a Claude.ai gyorsítótárában régebbi metaadatok vannak, és a jóváhagyási képernyő csak a négy alapvető hatókört kínálta fel. Bontsa a csatlakozó kapcsolatát (Disconnect), majd csatlakoztassa újra (Connect): minden hatókör megjelenik, beleértve az érzékenyeket és az újakat is (expedíció, analitika, készletek).

Amit a jóváhagyási képernyőn bejelöl, az érvényes, és soha nem több annál, amire Ön maga jogosult. Akinek az alkalmazásban nincs jogosultsága a beszerzési árakhoz, az nem is tudja továbbadni. A token, amelyet a Claude.ai megkap, csak az engedélyezett hatóköröket hordozza.

Más MCP-kliens vagy AI-alkalmazás OAuth-on keresztül

Az alkalmazásnak ugyanazt a /api/mcp címet adja meg, és semmi mást, kulcsot sem. A többi magától történik:

1. Az alkalmazás lekéri tőlünk, hová küldje a bejelentkezést (a védett erőforrás metaadatai az RFC 9728 szerint).
2. Megnyílik az Ön MitoOps bejelentkezése.
3. Megjelenik a jóváhagyási képernyő, ahol kiválasztja a hatóköröket és a webáruházakat.
4. Az engedélyezés után a kapcsolat kész, és az alkalmazás látja az eszközöket.

Az az alkalmazás, amely maga választja ki a hatóköröket, köteles azokat feltüntetni a kérésben: a jóváhagyási képernyő csak azt kínálja fel, amit az alkalmazás kért (és amire Önnek jogosultsága van). Az interfész az összes hatókört meghirdeti, az érzékenyeket is: a WWW-Authenticate kihívásban és a scopes_supported mezőben egyaránt. Az érzékeny hatókörök ennek ellenére soha nem engedélyeződnek maguktól: a jóváhagyási képernyőn külön jelölve, bejelöletlenül szerepelnek, a token pedig arra szűkítve kerül kiadásra, amit Ön engedélyezett (scope a token válaszában).

Csatlakozás hozzáférési kulccsal

Az asszisztensnek vagy a programnak szüksége van az Ön domainjén futó /api/mcp címre és egy olyan hozzáférési kulcsra, amelynek interfészei között szerepel az MCP. A pontos címet a Beállítások → API & MCP képernyő írja ki a „Hová kell beírni” blokkban. A csak REST-hez kiadott kulcs MCP-n nem működik, és fordítva.

Eszközök

Az eszközök listája a kulcs vagy a hozzájárulás hatóköreihez igazodik: az asszisztens pontosan azt látja, amit engedélyeztek neki, és semmi mást. A hatókörön kívüli eszköz számára nem létezik.

MCP-eszköz	Hatókör	REST	Mit ad vissza
account_connection	stores:read	GET /account/connection	A kapcsolat diagnosztikája: az alkalmazás, ki és mikor adott hozzáférést, megadott és hiányzó jogosultságok területenként, webáruházak és az AI-írási mód.
account_entitlements	account:read	GET /account/entitlements	A fiók tarifája, funkciói és limitjei az aktuális kihasználtsággal.
affiliate_articles_create	affiliate:write	—	írás: Saját súgócikk létrehozása egyszerre minden nyelven (cím és törzs a megadott nyelven); a HTML megtisztításra kerül.
affiliate_articles_get	affiliate:read	GET /affiliate/articles/:key	Egy súgócikk szövegével (HTML) minden nyelven vagy egy nyelven; a változók nincsenek behelyettesítve.
affiliate_articles_list	affiliate:read	GET /affiliate/articles	A partnerportál súgócikkei: kulcs, alapértelmezett/saját, bekapcsolás, sorrend, nyelvenkénti állapot (cím, URL, kitöltöttség, egyezés az alapértelmezettel).
affiliate_articles_set_state	affiliate:write	—	írás: Súgócikk be- vagy kikapcsolása egyszerre minden nyelvre; az alapértelmezett cikk nem törlődik, csak kikapcsol.
affiliate_articles_update	affiliate:write	—	írás: Súgócikk szerkesztése egy nyelven (cím, URL, törzs; a HTML megtisztításra kerül) vagy az alapértelmezett szöveg visszaállítása; visszaadja az ismeretlen változókat.
affiliate_campaigns_create	affiliate:write	—	írás: Kampány létrehozása a webáruházban: név, jutalom (nem szabad kitalálni), a hozzárendelés érvényessége, elérhetőség, a konverziók jóváhagyása.
affiliate_campaigns_get	affiliate:read	GET /affiliate/campaigns/:campaignId	A partnerprogram egy kampánya.
affiliate_campaigns_list	affiliate:read	GET /affiliate/campaigns	A webáruház partnerprogramjának kampányai jutalommal, elérhetőséggel és darabszámokkal.
affiliate_campaigns_update	affiliate:write	—	írás: Kampány szerkesztése: név, jutalom, érvényesség, elérhetőség, jóváhagyás, be-/kikapcsolás, a partnereknek szóló leírás nyelvenként.
affiliate_code_requests_decide	affiliate:write	—	írás: A partner saját kódra vonatkozó kérelmének intézése: a jóváhagyás a kódot azonnal létrehozza a kampányok webáruházaiban vásárlói kedvezménnyel (ehhez a coupons:write is szükséges), a retry megismétli a létrehozást, az elutasításhoz indoklás kell; a partner e-mailt kap.
affiliate_code_requests_list	affiliate:read	GET /affiliate/code-requests	A partnerek saját kedvezménykódra vonatkozó kérelmei állapottal és indoklással; a függőben lévők elöl.
affiliate_conversions_decide	affiliate:approve	—	írás: Döntés egy jutalékról azonosító alapján: approve (új → jóváhagyott), reject (új → elutasított, indoklás kötelező), cancel (jóváhagyott → visszavont, indoklás kötelező); a kifizetett jutalék nem fordítható vissza, ugyanaz a döntés másodszor nem változtat semmit; a partner e-mailt kap.
affiliate_conversions_get	affiliate:read	GET /affiliate/conversions/:conversionId	Egy konverzió részletei: összegek, jutalék, a jutalék állapota indoklással, a rendelés állapota a webáruházban, jóváíró számla, kifizetés.
affiliate_conversions_list	affiliate:read	GET /affiliate/conversions	A webáruház partnerprogramjának konverziói: a jutalék alapja és a teljes rendelés áfával, jutalék, a jutalék állapota indoklással, a rendelés állapota a webáruházban, kapcsolat a kifizetéssel.
affiliate_discount_codes_ensure	coupons:write	—	írás: Gondoskodik róla, hogy a partnernek legyen kedvezménykódja a webáruházban: a kupon a kanonikus kuponokon keresztül jön létre (vagy egy meglévő kerül felhasználásra), és a partnerhez rendelődik; a webáruházbeli megjegyzés automatikusan készül.
affiliate_discount_codes_list	affiliate:read	GET /affiliate/discount-codes	A partnerek kedvezménykódjai a webáruházban a felhasználások számával és a forgalommal.
affiliate_documents_draft_create	affiliate:write	—	írás: Jogi dokumentum új szövegének javaslata piszkozatként; az élő szöveget nem módosítja, azt ember teszi közzé az alkalmazásban különbségkimutatással és auditnaplóval.
affiliate_documents_get	affiliate:read	GET /affiliate/documents/:key/content	A program egy jogi dokumentuma nyelvenkénti szöveggel (tárolt szöveg, nyilvános szöveg, verzió, ujjlenyomatok, forrás, PDF-metaadatok) és a nyitott piszkozatokkal.
affiliate_documents_list	affiliate:read	GET /affiliate/documents	A program dokumentumai (feltételek, megállapodások): megerősítési szabályzat, aláírt példány, e-mail-melléklet, nyelvenkénti verziók, készültség és a megerősítések száma.
affiliate_documents_update	affiliate:write	—	írás: A programdokumentum szabályzata (kire vonatkozik, mikor kell megerősíteni, aláírt példány, e-mail-melléklet, bekapcsolás); a szöveget az alkalmazásban kell feltölteni.
affiliate_email_templates_list	affiliate:read	GET /affiliate/email-templates	A partnereknek szóló e-mail-sablonok nyelvenként (tárgy, bekapcsolás, eseménnyel együtt a törzs is) és a „Fiók jóváhagyva” e-mail automatikus mellékletei.
affiliate_email_templates_update	affiliate:write	—	írás: A partnereknek szóló e-mail-sablon szerkesztése egy nyelven (tárgy, törzs) vagy egy esemény be-/kikapcsolása.
affiliate_links_generate	affiliate:read	GET /affiliate/links/generate	Követett partnerlink a kampány webáruházának kezdőlapjára, egy termékre vagy kategóriára; kattintás után megőrzi a partnerhez rendelést.
affiliate_partners_get	affiliate:read	GET /affiliate/partners/:partnerId	A program egy partnere a számára elérhető kampányokkal.
affiliate_partners_list	affiliate:read	GET /affiliate/partners	A program partnerei állapottal, teljesítménnyel és jutalékokkal; kapcsolattartási adatok csak a személyes adatokkal.
affiliate_partners_set_market	affiliate:write	—	írás: A partner tagsága a webáruházban: engedélyezés (active, a portálról érkezett kérelmet is jóváhagyja) vagy visszavonás (revoked); a webáruház kampányai, kuponjai és dokumentumai csak aktív tagság esetén vonatkoznak a partnerre.
affiliate_partners_set_state	affiliate:write	—	írás: Döntés a partner fiókjáról (jóváhagyás, elutasítás, felfüggesztés, visszahelyezés a várakozók közé); a jóváhagyás e-mailt küld a megállapodással.
affiliate_payouts_list	affiliate:read	GET /affiliate/payouts	A partnereknek járó jutalékok kifizetései állapottal; banki és számlázási adatok nélkül.
affiliate_portal_get	affiliate:read	GET /affiliate/portal	A partner nyilvános portálja: címek webáruházanként, a regisztráció nyitottsága indoklással, saját domainek, kapcsolattartó, megjelenés és a szövegek állapota nyelvenként.
affiliate_portal_pages_update	affiliate:write	—	írás: A nyilvános portál saját szövegei egy nyelven (bejelentkezési/regisztrációs/áttekintő oldal, adatkezelési tájékoztató, programleírás); a HTML megtisztításra kerül.
affiliate_settings	affiliate:read	GET /affiliate/settings	A partnerprogram beállításai: jutalékok, kattintások, kifizetési minimum, ajánlás.
affiliate_settings_update	affiliate:write	—	írás: A program nem pénzügyi beállításai: név, regisztráció, automatikus jóváhagyás, kapcsolattartó, színek, hivatkozás az adatvédelmi elvekre.
affiliate_signatures_get	affiliate:read	GET /affiliate/signatures/:signatureId	Egy elektronikus aláírás az aláírt szöveggel és az értékek pillanatképével; megváltoztathatatlan rekord, a PDF az alkalmazásban áll össze.
affiliate_signatures_list	affiliate:read	GET /affiliate/signatures	A partnerek elektronikusan aláírt dokumentumai (ki, dokumentum, verzió, nyelv, webáruház, idő, mód, ellenőrzés, ujjlenyomatok, állapot) és azok a partnerek, akiktől hiányzik az aláírás; csak olvasás, aláírás kizárólag a portálon jön létre.
affiliate_statistics	affiliate:read	GET /affiliate/statistics	A partnerprogram statisztikája: napi alakulás, a hozzárendelés forrásai, partnerrangsor.
affiliate_summary	affiliate:read	GET /affiliate/summary	A webáruház partnerprogramjának áttekintése az időszakra: kattintások, konverziók, jutalékok, partnerek.
affiliate_variables_list	affiliate:read	GET /affiliate/variables	A partnerprogram tartalmi és e-mail-változóinak nyilvántartása: kanonikus nevek, aliasok, típus, felületek, példa; a szöveg opcionális ellenőrzése ismeretlen változókra.
analytics_advertising	reports:read	GET /analytics/advertising	Hirdetés: költés, keret, ROAS, reklámköltés aránya, CPA, átlagos rendelésérték és MER összehasonlítással; Google Ads és Meta Ads, kattintások a GA4-ből, 6 hónap.
analytics_channels	analytics:read	GET /analytics/channels	A látogatások, rendelések és a forgalom megoszlása marketingcsatornák szerint.
analytics_comparison	reports:read	GET /analytics/comparison	Árbevétel összehasonlítással: árbevétel, rendelések, AOV, látogatások, CR és AI/LLM az előző időszakhoz vagy évhez képest.
analytics_monthly	reports:read	GET /analytics/monthly	Árbevétel, rendelések és látogatások havonta (legfeljebb 24), például év/év összevetéshez.
analytics_order_coverage	analytics:read	GET /analytics/order-coverage	A rendelések és a forgalom lefedettsége az analitikai méréssel.
analytics_order_heatmap	reports:read	GET /analytics/order-heatmap	Mikor érkeznek a rendelések: a hét napja × óra, legerősebb nap és óra.
analytics_overview	analytics:read	GET /analytics/overview	Látogatások, rendelések, forgalom, konverziós arány és az AI/LLM részaránya az időszakban.
analytics_revenue_sources	reports:read	GET /analytics/revenue-sources	Honnan jött az árbevétel: csatornák, AI/LLM, MitoOps és Affiliate összesítők, akvizíció a GA4 szerint.
analytics_seo	analytics:read	GET /analytics/seo	Search Console: kattintások, megjelenések, CTR és pozíció lekérdezések vagy oldalak szerint.
automations_catalog	automations:read	GET /automations/catalog	Az automatizálások katalógusa: indítók, feltételek, operátorok, műveletek, sablonok; catalogVersion a javaslatokhoz.
automations_create_draft	automations:write	—	írás: KIKAPCSOLT automatizálási piszkozatot hoz létre. Nem kapcsol be és nem futtat semmit.
automations_get	automations:read	GET /automations/:workflowId	Egy automatizálás a DSL-lel és a validálás eredményével.
automations_list	automations:read	GET /automations	A fiók automatizálásai állapottal és a webáruházak körével.
automations_options	automations:read	GET /automations/options	Értéklista egy automatizálási mezőhöz (állapotok, szállítási módok, fizetési módok, sablonok, reklamációk…): a DSL-be kerülő value és a név.
automations_revision_create_draft	automations:write	—	írás: A közzétett automatizálás módosítását revízióként javasolja, amelyet ember hagy jóvá. A futó verzió nem változik.
automations_revision_discard_draft	automations:write	—	írás: Visszavonja a közzétett automatizálás nyitott revízióját.
automations_revision_update_draft	automations:write	—	írás: Módosítja a közzétett automatizálás nyitott revízióját.
automations_runs	automations:read	GET /automations/:workflowId/runs	Egy automatizálás futásainak előzményei.
automations_templates	automations:read	GET /automations/templates	Kész automatizálási minták DSL-lel.
automations_update_draft	automations:write	—	írás: Módosítja a közzé nem tett automatizálási piszkozatot optimista párhuzamosságkezeléssel.
automations_validate_draft	automations:read	—	Írás nélkül ellenőrzi az automatizálási javaslatot.
chatbot_conversations_get	chatbot-conversations:read	GET /chatbot/conversations/:sessionId	Egy webes chatbot-beszélgetés átirata a bot válaszainak forrásaival együtt.
chatbot_conversations_list	chatbot-conversations:read	GET /chatbot/conversations	Az ügyfelek beszélgetései a webes chatbottal a legutóbb aktívtól kezdve, az első kérdéssel; kurzor.
chatbot_outcomes	chatbot:read	GET /chatbot/outcomes	How web chatbot conversations ended: since when the outcome is measured, measured and unmeasured conversations, known and unknown outcome, resolved, unresolved, bot error and resolution rate with its denominator; N/A with a reason when the denominator is zero. Totals only.
chatbot_stats	chatbot:read	GET /chatbot/stats	A webes chatbot statisztikája az időszakra: a buborék tölcsére, megnyitások, beszélgetések, eredmények, értékelések.
chatbot_topics	chatbot:read	GET /chatbot/topics	Miről szóltak a beszélgetések: a témák részaránya, termékek, a kezdőoldal típusa és a tudáshiány-jelöltek.
claims_config_change_draft	claims-settings:draft	—	írás: Javaslatot tesz a reklamációs folyamatok, állapotok, címkék, sablonok, űrlapszövegek és modulbeállítások módosítására; csak akkor íródik be, ha egy ember jóváhagyja az alkalmazásban.
claims_config_draft_get	claims-settings:read	GET /claims/config-drafts/:draftId	A reklamációs beállítások módosítási javaslatának állapota (várakozik, beírva, elutasítva).
claims_configuration	claims-settings:read	GET /claims/configuration	A reklamációk beállításai: címkék, mezők, visszaszállítás, űrlap a webáruházban, az űrlap típusai.
claims_get	claims:read	GET /claims/:code	Egy eset tételekkel és kapcsolatokkal: rendelés, jóváíró számla, visszaküldemény, készletmozgás.
claims_list	claims:read	GET /claims	Egy webáruház reklamációi és visszaküldései a legújabbtól.
claims_refund_options	claims-settings:read	GET /claims/refund-options	Refunds: variable symbol source, refund coupon validity, coupon in the form, when the form asks for an account number.
claims_refund_readiness	claims:read	GET /claims/:code/refund-readiness	Claim before a refund: what the customer requests, masked account, variable symbol, mode and whether the claim can be deleted.
claims_refund_settings	claims-settings:read	GET /claims/refund-settings	Reklamációs visszatérítések: mód, bankszámlák fizetési megbízásra való alkalmassággal (maszkolva), alapértelmezett és kézi számla.
claims_routes	claims-settings:read	GET /claims/routes	Reklamációk visszaszállítása: útvonalak, címek, futárprofilok azonosítókkal és visszaküldési támogatással, ügytípusok.
claims_routes_change_draft	claims-routes:draft	—	írás: Visszaküldési útvonalat (az egész EU-ra vagy világra is) és címzett címet javasol; jóváhagyással írja be egy ember (vagy autonóm írás, ha az ügyfél bekapcsolta).
claims_settings	claims:read	GET /claims/settings	A reklamációk folyamatai azonosítókkal és nevekkel (típusok, lépések, állapotok, határidők), címkék; a modul beállításai a claims-settings:read hatókörrel.
claims_statistics	claims:read	GET /claims/statistics	A reklamációk és visszaküldések statisztikája az időszakra: darabszámok, intézési idők, típusok, értékelések, okok.
claims_templates	claims-settings:read	GET /claims/templates	Reklamációs e-mail-sablonok (tárgy, szöveg, mikor és hogy automatikusan mennek-e ki) és jegyzőkönyv-sablonok.
content_articles_search	products:read	GET /content/articles	A webáruház blogcikkei a webes címmel és előnézeti képpel.
coupons_activation_link	coupons:read	GET /coupons/activation-link	Hivatkozás, amely a vásárló kosarában érvényesít egy MEGLÉVŐ kupont. Kupont nem hoz létre.
coupons_activation_status	coupons:read	GET /coupons/activation-status	Használható-e a kupon a webáruházban aktiváló hivatkozáson keresztül: a kupon tükre + a kód állapota a weben.
coupons_capabilities	coupons:read	GET /coupons/capabilities	Mit tud a kuponokról az adott webáruház platformja. Létrehozás előtt olvassa el.
coupons_ensure	coupons:write	—	írás: Gondoskodik róla, hogy a kupon létezzen a kiválasztott webáruházakban. Eltérő kedvezménymérték esetén NEM íródik felül.
coupons_get	coupons:read	GET /coupons/:code	Egy kupon a MitoOps nyilvántartásából. Ha nincs benne, a válasz „nem található”.
coupons_list	coupons:read	GET /coupons	A webáruház kedvezménykuponjai a kedvezmény típusával és mértékével, érvényességgel és származtatott állapottal.
coupons_remove	coupons:delete	—	írás: A kupon kifejezett törlése: függőségek, előnézet, megerősítés; élő függőség esetén nem törlődik.
coupons_update	coupons:write	—	írás: Meglévő kupon kifejezett módosítása, beleértve a termékekre és kategóriákra vonatkozó korlátozásokat; előnézet, majd megerősítés.
customers_get	customers:read	GET /customers/:customerKey	Egy ügyfél az ügyféladatbázisból: identitás, webáruházak, LIFETIME és opcionálisan PERIOD pénzösszegek, bontás webáruházanként.
customers_list	customers:read	GET /customers	Ügyféladatbázis: identitás (PII-maszkolással), webáruházak, nyelv, LIFETIME darabszámok és forgalom pénznemenként; opcionális szűrő a vásárlási aktivitásra az időszakban.
customers_performance	reports:read	GET /customers/performance	Ügyfelek pszeudonimként: rendelések száma, forgalom, első és utolsó rendelés, ismételt vásárlás, LTV.
credit_notes_search	invoices:read	GET /credit-notes	Keresés a jóváíró számlákban.
documents_list	invoices:read	GET /documents	Egy fajta könyvelési bizonylatai (számlák, előlegszámlák, jóváírások) oldalanként életciklussal, forrásbeli állapottal, érvényességi szűrővel és PDF-elérhetőséggel.
documents_pdf_link	invoices:read	—	Rövid élettartamú (10 perces) hivatkozás számla, előlegszámla vagy jóváírás PDF-jére a böngészőben való megnyitáshoz.
invoices_get	invoices:read	GET /invoices/:invoiceCode	Egy számla tételekkel, összegekkel, a hozzá tartozó jóváíró számlákkal és előlegszámlákkal.
invoices_search	invoices:read	GET /invoices	Keresés a számlákban.
inventory_movements	inventory:read	GET /inventory/movements	A készletmozgások előzményei: mikor, mi, mennyivel, miért és milyen forrásból.
inventory_product_availability	inventory:read	GET /inventory/availability	Több tétel készletszintje egyszerre.
inventory_stock	inventory:read	GET /inventory/stock	Egy tétel készletszintje az érték forrásával együtt.
orders_get	orders:read	GET /orders/:orderCode	Egy tárolt rendelés a tételekkel együtt.
orders_list	orders:read	GET /orders	Egy webáruház tárolt rendelései a legújabbtól.
availabilities_change_draft	availabilities:draft	—	írás: Az elérhetőséglista módosítási JAVASLATA (létrehozás, szerkesztés, törlés). A webáruházba csak akkor kerül be, amikor ember jóváhagyja a MitoOpsban.
availabilities_draft_get	products:read	GET /availabilities/drafts/:draftId	Az elérhetőséglista módosítási javaslatának állapota: jóváhagyásra vár, eredménnyel beírva, elutasítva, lejárt.
availabilities_list	products:read	GET /availabilities	A webáruház elérhetőséglistája: név, leírás, készletre kerülés, kézbesítés, jelentés a Google számára, szín, alapértelmezett szerep.
categories_content_change_draft	category-content:draft	—	írás: Új kategóriaszövegek JAVASLATA (egyszerre legfeljebb 30); a webshopba csak egy ember írja be jóváhagyással a MitoOps-ban.
categories_content_draft_get	category-content:read	GET /catalog/category-content-drafts/:draftId	Kategóriaszöveg-javaslat állapota: jóváhagyásra vár, beírva, elutasítva, lejárt.
categories_content_get	category-content:read	GET /categories/:guid/content	A kategória szövegei (felső és alsó leírás, SEO-cím és -leírás) lenyomattal és írhatósággal.
categories_list	products:read	GET /categories	A webáruház kategóriái a termékek számával.
products_content_change_draft	product-content:draft	—	írás: Új termékszövegek JAVASLATA (egyszerre legfeljebb 30); a webshopba csak egy ember írja be jóváhagyással a MitoOps-ban.
products_content_draft_get	product-content:read	GET /catalog/product-content-drafts/:draftId	Termékszöveg-javaslat állapota: jóváhagyásra vár, beírva a webshop figyelmeztetéseivel, elutasítva, lejárt.
products_content_get	product-content:read	GET /products/:code/content	A termék szövegei a webshopból (leírás, rövid leírás, SEO-cím és -leírás) lenyomattal és írhatósággal.
products_content_policy	product-content:read	GET /product-content/policy	A webshop tartalomszabályzata a webshop hívása nélkül: mit olvashat és javasolhat ez a hozzáférés, mely mezőket írja a platform, jóváhagyási mód és önálló írás, korlátok és lenyomatok.
products_get	products:read	GET /products/:code	Egy termék kód alapján, a besorolással és a termékkártyán szereplő árral együtt.
products_search	products:read	GET /products	Termékek keresése név, kód, EAN vagy PLU alapján.
reports_financial_summary	reports:read	GET /reports/financial-summary	Az időszak pénzügyi összesítője: forgalom, áfa, rendelések, AOV; jogosultságokkal a beszerzés, a bruttó nyereség, a költségek és az eredmény is.
sales_order_performance	reports:read	GET /sales/order-performance	Forgalom rendelésenként EUR-ban, összesítéssel a teljes időszakra; jogosultsággal a beszerzés, a bruttó nyereség és az árrés is rendelésenként.
sales_product_performance	reports:read	GET /sales/product-performance	Értékesítés termékenként a bizonylatokból; jogosultsággal az eladáskori beszerzési ár és az árrés is.
search_console_query	search-console:read	GET /search-console/query	Search Console napok, lekérdezések, oldalak, országok és eszközök szerint, lapozással és tartalomhash-sel.
search_console_status	search-console:read	GET /search-console/status	A webáruház Search Console-állapota: kapcsolat, tulajdon, jogosultság, szinkronizálás és az archívum terjedelme.
shipping_carriers	shipping:read	GET /shipping/carriers	Csatlakoztatott szállítók és profiljaik, hozzáférési adatok nélkül.
shipping_shipment_detail	shipping:read	GET /shipping/shipments/:shipmentId	Egy küldemény az összes követési eseménnyel.
shipping_shipments	shipping:read	GET /shipping/shipments	Egy webáruház küldeményei a szállítóval, az országgal, valamint az átadás és a kézbesítés idejével.
shipping_stats	shipping:read	GET /shipping/stats	Kézbesítési statisztikák szállítónként: darabszámok, sikerességi arány, a kézbesítési idő mediánja és p90 értéke, országok.
stores_integration_status	stores:read	GET /stores/integration-status	A MitoOps-kód állapota a weben webáruházanként: telepítve, verzió, modulok, a címből érvényesített kupon készenléte.
stores_list	stores:read	GET /stores	A fiók webáruházainak listája a kódjukkal együtt.
suppliers_get	purchasing:read	GET /suppliers/:supplierId	Egy beszállító a termékajánlataival és költségösszetevőivel.
suppliers_list	purchasing:read	GET /suppliers	A fiók beszállítói az ajánlatok és a párosított termékek számával.
webhooks_deliveries	webhooks:read	GET /webhooks/endpoints/:endpointId/deliveries	Egy végpont kézbesítési naplója törzs nélkül.
webhooks_endpoint	webhooks:read	GET /webhooks/endpoints/:endpointId	Egy webhook végpont a függő kézbesítések számával.
webhooks_endpoints	webhooks:read	GET /webhooks/endpoints	A fiók webhook végpontjai titkok nélkül, és a sor állapota.
webhooks_events	webhooks:read	GET /webhooks/events	A kimenő webhookok eseménykatalógusa, a boríték és az aláírás.

Az ügyfél neve, e-mail-címe, telefonszáma és utcacíme az orders_list, orders_get, claims_list és claims_get eszközökben csak a personal-data:read hatókörrel szerepel; nélküle a válasz az országot és a várost tartalmazza. Ugyanez vonatkozik a beszállító és a programpartner kapcsolattartási adataira (affiliate_partners_*). A hatókörnek nincs saját eszköze.

Az ügyféladatbázisban (customers_list, customers_get) ugyanez a hatókör dönt a névről, a cégről, az e-mail-címről, a telefonszámról és a marketing célú nemről; nélküle a pszeudonim, a webáruházak, az ország, a nyelv, a darabszámok és a dátumok maradnak. A forgalom és az LTV ezen felül a reports:read hatókörhöz kötött. A marketing célú nem a keresztnévből készült becslés (genderSource: "name_inference"), nem olyan adat, amelyet az ügyfél megadott, és az asszisztensnek is így kell közölnie. A partnerek banki és adóadatai soha nem kerülnek kiadásra.

Webes chatbot: a beszélgetések témái. A chatbot_topics (ugyanaz a chatbot:read hatókör) egyetlen hívással válaszol arra a kérdésre, hogy „miről szólt”: a beszélgetések részaránya témánként egy zárt taxonómiából (szállítás, fizetés, visszaküldés, termékválasztás, paraméterek, használat, ismeretterjesztő kérdések…), a megoldási arány és a tudáshiány-jelöltek száma témánként, a leggyakoribb termékek (amelyekről az ügyfelek kérdeztek, és amelyeket a bot ajánlott), milyen típusú oldalról indulnak a beszélgetések, valamint a napi alakulás. A kiértékelés determinisztikus: a válaszok forrásaira, az ajánlott termékekre és egy kulcsszószótárra épül, így két hívás ugyanarra az időszakra ugyanazt a számot adja. Csak összesítéseket ad vissza: az ügyfél szövege semmilyen úton nem kerül bele, még „leggyakoribb kérdésként” sem. A részarány mindig a darabszámmal együtt érkezik: kevés beszélgetésnél a százalék nem megbízható. A chatbot_conversations_list topic és knowledgeGapCandidate szűrővel rendelkezik; egy konkrét beszélgetés átirata továbbra is az érzékeny hatókör mögött van, és csak a megőrzési időn belül érhető el.

Webes chatbot. A statisztika (chatbot_stats, chatbot:read hatókör) csak összesítéseket ad vissza: hány oldallátogatásnál jelent meg a buborék, és ezek közül hányan kattintottak rá, az ablak megnyitásai, a beszélgetések és üzenetek száma, mit intézett el a bot, az ügyfelek értékelései és a hírlevél-feliratkozás tölcsére. Az ügyfelek beszélgetései (chatbot_conversations_list, chatbot_conversations_get) saját, érzékeny chatbot-conversations:read hatókör mögött vannak, amelyet a jóváhagyási képernyőn tudatosan jelöl be: az ügyfél a nyilvántartásban csak egy véletlenszerű beszélgetéskulcs (IP-cím, cookie, név vagy e-mail-cím nélkül), azt az e-mail-címet, telefonszámot és IBAN-t pedig, amelyet a szövegbe írt, az asszisztens csak a personal-data:read hatókörrel kapja meg, egyébként helyettük a [e-mail], [telefón], [iban] jelölést látja. A beszélgetések csak a webáruház megőrzési idején belül kerülnek kiadásra (az AI központ Előzmények beállítása); a nulla megőrzési idejű webáruház semmit sem ad ki. A buborék megjelenéseit 2026. szeptember 21-ig az üzenet minden felugrásakor számolták; 2026. szeptember 22-től egy megjelenés egy oldallátogatást jelent, és a válaszban a measurementChanges jelzi, hogy a választott időszak keveri-e a két mérést.

Minden eszköznek van REST-megfelelője ugyanazon a képességen. A válaszok a borítékban különböznek, az üzleti adatok azonosak. Az időszak és a lapozás szabályait, valamint a pénzügyi mezők jelentését a REST interfész oldal írja le.

Az összesítő eszközök (shipping_stats, analytics_*, reports_financial_summary) kész számokat adnak vissza az alkalmazásból: az asszisztensnek nem kell rekordok ezreit letöltenie és maga számolnia. A nyers listák (shipping_shipments, orders_list) a részletes nézethez maradnak.

Mit kérdezhet

Csatlakozás után a Claude.ai a MitoOps adataiból válaszol például ezekre a kérdésekre:

• „Mi volt a szállítási módok százalékos megoszlása augusztusban?” (shipping_stats)
• „Mennyi volt a DHL és a GLS kézbesítési idejének mediánja?” és „Hány küldemény maradt kézbesítetlen, és hány jött vissza?” (shipping_stats)
• „Mely országokba küldtünk DHL-lel?” (shipping_stats, countries mező)
• „Mennyi volt a forgalom és a konverziós arány augusztusban?” (analytics_overview vagy reports_financial_summary)
• „Hány rendelés és mennyi forgalom jött a ChatGPT-ből?” (analytics_channels)
• „Mely lekérdezéseknek volt a legmagasabb a CTR-je?” (analytics_seo)
• „Mekkora az X termék árrése az elmúlt hónapban?” (sales_product_performance, a purchase-prices:read hatókörrel)
• „Mit kérdeztek az ügyfelek a legtöbbször a chatbottól ebben a hónapban, és miről írjunk blogcikket?” (chatbot_conversations_list és chatbot_conversations_get, a chatbot-conversations:read hatókörrel)
• „Hány beszélgetése volt a chatbotnak, és ebből hányat intézett el ügyfélszolgálat nélkül?” (chatbot_stats)
• „Milyen elérhetőségei vannak az SK webáruháznak, és melyek az alapértelmezettek?” (availabilities_list)
• „Adj hozzá az SK webáruházhoz egy Előrendelés október elérhetőséget előrendelés jelentéssel és 14 napon belüli kézbesítéssel” (availabilities_change_draft az availabilities:draft hatókörrel; javaslat jön létre, amelyet Ön az alkalmazásban jóváhagyással ír be)
• „Módosítsd a 12-es bekapcsolt automatizálást úgy, hogy csak Futár szállítási módnál küldjön értesítést” (automations_options a szállítási módhoz, majd automations_revision_create_draft; a futó verzió nem változik, amíg a revíziót közzé nem teszi a szerkesztőben)
• „Milyen e-maileket küldenek a reklamációk automatikusan, és mi áll bennük németül?” (claims_templates a claims-settings:read hatókörrel)
• „Nevezd át az Árura vár reklamációs állapotot erre: Várjuk a küldeményt” (claims_settings az azonosítóhoz, majd claims_config_change_draft a claims-settings:draft hatókörrel; Ön írja be jóváhagyással az alkalmazásban)

Olvasás és szűk körű írás: automatizálás, kupon, partnerprogram, elérhetőségek, reklamációk

Az üzemi adatok (rendelések, készletszint, termékek, bizonylatok, küldemények) MCP-n keresztül csak olvashatók. Minden írás saját érzékeny hatókörhöz kötött: automatizálási piszkozat, kedvezménykupon, a partnerprogram kezelése, döntés a jutalékról, az elérhetőséglista módosítási javaslata, amelyet csak ember ír be a webáruházba, és a reklamációs beállítások módosítási javaslata, amelyet szintén csak ember ír be.

Automatizálási piszkozat. Az automations:write hatókörrel ez kikapcsolt piszkozat: az automations:write hatókörrel az asszisztens a katalógus (automations_catalog) alapján szabályt javasolhat és piszkozatként mentheti, vagy módosíthat egy olyan piszkozatot, amelyet még senki nem tett közzé. A piszkozat az Automatizálás alatt jelenik meg, mint bármely folyamatban lévő javaslat: bekapcsolni, közzétenni vagy futtatni csak Ön tudja az alkalmazásban. A közzétett automatizálást az asszisztens közvetlenül nem módosítja.

Futó automatizálás revíziója. Az asszisztens az automations:write hatókörrel a közzétett és bekapcsolt automatizálást is módosíthatja, de csak javaslattal: az automations_revision_create_draft (bemenet: workflowId, expectedPublishedVersion az automations_get eszközből, catalogVersion, a teljes új dsl, note és clientRequestId) a revíziót a futó verzió mellé menti. A futó automatizálás nem változik, és tovább fut. Egy automatizáláshoz legfeljebb egy nyitott revízió tartozik; az automations_revision_update_draft eszközzel módosítható az expectedRevisionVersion megadásával, és az automations_revision_discard_draft eszközzel elvethető. A válasz tartalmazza az approvalUrl hivatkozást az automatizálás szerkesztőjére. Ott az automatizálások szerkesztésére jogosult személy a felső panelen látja a revíziót, betölti a szerkesztőbe (Javaslat betöltése a szerkesztőbe gomb), ellenőrzi, és a szokásos gombbal közzéteszi; az automatizálás bekapcsolva marad. Vagy elutasítja. Ha közben valaki másik verziót tett közzé, a revízió lezárul (REVISION_STALE), és újat kell készíteni. A nyitott revíziót és az előzményeket az automations_get adja vissza (openRevision, revisions).

Mezők értéklistái és az értékek ellenőrzése. Azoknak a mezőknek, amelyeket a szerkesztőben listából választ ki (rendelés állapota, szállítási mód, fizetési mód, szállítói profil, értesítési sablon, a reklamáció típusa, állapota, címkéje és sablonjai, webhook végpont és további mezők), a katalógusban forrásuk van. Az automations_options a source és a market megadásával visszaadja az értékeiket [{ value, name }] pontosan abban a formában, ahogyan a szerkesztő menti őket (állapotazonosító, a szállítási és fizetési mód GUID-ja, a reklamációs állapot azonosítója); source nélkül kilistázza a forrásokat, és azt, hogy webáruházanként eltérnek-e (perShop). A validálás (automations_validate_draft) és a piszkozat vagy revízió mentése is elutasítja azt az értéket, amely a webáruházban nem létezik (FIELD_UNKNOWN_OPTION), valamint az olyan helyőrző szöveget, mint a DOPLNIT_… vagy a TODO (FIELD_PLACEHOLDER). Ha a listát nem lehet ellenőrizni (a webáruház nem válaszolt, a lista csonkolt), csak FIELD_OPTIONS_UNVERIFIED figyelmeztetés érkezik. Az orders_get és az orders_list tartalmazza a statusId, shippingGuid és paymentGuid mezőt, vagyis ugyanazokat az értékeket, amelyekkel az automatizálás feltételei dolgoznak.

Az automations:write hatókör érzékeny: a jóváhagyási képernyőn nincs előre bejelölve, csak az automatizálások szerkesztésére jogosult személynek jelenik meg, a meglévő kapcsolatok nem kapják meg, és a token frissítése sem bővíti ki. A rendelések, termékek, készletszint, bizonylatok, visszatérítések, reklamációs esetek és küldemények MCP-n keresztül nem módosíthatók; a webáruház elérhetőséglistája és a reklamációs beállítások csak olyan javaslattal változnak, amelyet ember hagy jóvá az alkalmazásban (lásd lent). A webhook végpontok MCP-n keresztül csak olvashatók. A szállítók, a webáruház és az analitika hozzáférési adatai MCP-n keresztül nem olvashatók ki.

Kedvezménykupon. A coupons:write hatókörrel az asszisztens az Ön által megadott paraméterek szerint kupont hoz létre (coupons_ensure, a partner kuponját is az affiliate_discount_codes_ensure eszközzel), és kifejezetten módosít egy meglévőt (coupons_update, előnézet és megerősítés); a törlésnek saját coupons:delete hatóköre van, és az élő függőséggel rendelkező kupon nem törlődik.

A partnerprogram kezelése. Az affiliate:write hatókörrel az asszisztens dönt a partner fiókjáról (affiliate_partners_set_state: jóváhagyás, elutasítás, felfüggesztés; a partner e-mailt kap, a dokumentumszabályzat szerint a megállapodás PDF-jével együtt), intézi a saját kódra vonatkozó kérelmet (affiliate_code_requests_decide), módosítja a program nem pénzügyi beállításait (affiliate_settings_update: név, regisztráció, kapcsolattartó, színek), a portál szövegeit egy nyelven (affiliate_portal_pages_update), a súgócikkeket (affiliate_articles_create, affiliate_articles_update az alapértelmezett szöveg visszaállításával is, affiliate_articles_set_state; kívülről törölni nem lehet), az e-mail-sablonokat (affiliate_email_templates_update), a kampányokat (affiliate_campaigns_create, affiliate_campaigns_update), a dokumentumszabályzatot (affiliate_documents_update) és a partner tagságát a webáruházban (affiliate_partners_set_market: engedélyezés vagy visszavonás). A jogi dokumentumok szövegét elolvassa (affiliate_documents_get: szöveg nyelvenként, verzió, ujjlenyomatok, piszkozatok), új szöveget pedig csak piszkozatként javasol (affiliate_documents_draft_create; ettől a verziótól az affiliate_portal_pages_update eszközben a privacyNotice is piszkozat): az élő szöveget ember teszi közzé az alkalmazásban különbségkimutatással és auditnaplóval. A tartalmi és e-mail-változók nyilvántartását (kanonikus nevek, aliasok, típus, felületek) az affiliate_variables_list adja ki; az affiliate_email_templates_list a változók nevét adja vissza, nem az indexüket. Kifizetés, a jutalék alapjának módosítása és dokumentumfájl feltöltése MCP-n keresztül nem létezik: ezek az alkalmazásban maradnak.

Döntés a jutalékról. Saját érzékeny affiliate:approve hatókörrel (ez a jutalékok jóváhagyása jogosultság, nem a program kezelése) az asszisztens először elolvassa a függőben lévő jutalékokat a rendelés webáruházbeli állapotával együtt (affiliate_conversions_list a state=new paraméterrel, a részletek az affiliate_conversions_get eszközzel: a jutalék alapja revenue, a teljes rendelés áfával revenueTotal, orderState open/completed/cancelled, orderPaid, jóváíró számla), összefoglalja őket, és csak a felhasználó kifejezett utasítására dönt egyetlen konkrét konverzióról (affiliate_conversions_decide: approve, reject vagy cancel, elutasításnál és visszavonásnál kötelező indoklással, amelyet a partner e-mailben megkap). Ugyanaz az állapotgép érvényes, mint az alkalmazásban: a kifizetett jutalék nem fordítható vissza, a visszavont és az elutasított állapot végleges, ugyanaz a döntés másodszor nem változtat semmit (changed: false). Tömeges jóváhagyás kívülről nem létezik: száz konverzióhoz száz hívás kell, mindegyik auditnaplóval. A W-AFF10 óta minden konverzió tartalmazza az approvalPolicy mezőt (a kampány jóváhagyási módja, határidő, engedélyezett rendelésállapotok, fizetési feltétel) és az approvalEligibility mezőt is: hogy az óránkénti automatika most jóváhagyná-e, és ha nem, miért nem (minimum_age_not_reached, order_state_not_allowed, order_not_paid, order_cancelled, fully_refunded, approval_manual…), ugyanazzal a számítással, mint az alkalmazásban; a listának orderPaid, minCommission és orderState szűrője, valamint offset + hasMore lapozása van, így a „nézd át az elmúlt két hónap új konverzióit, mutasd a fizetetlen rendelésűeket vagy a 20 € felettieket” kérés egy vagy néhány olvasással megoldható. A kampány feltételeit az affiliate_campaigns_update állítja be (approval, approveAfterDays, requiredOrderStatusIds, paidRequired) az affiliate:write hatókörrel. A partnereknek járó kifizetések MCP-n keresztül csak olvashatók (affiliate_payouts_list): kifizetési köteget kiállítani, bizonylatot generálni, azt a partnernek elküldeni vagy banki átutalási megbízást benyújtani az asszisztens nem tud; ez az alkalmazásban, az üzemeltető kezében marad.

Az elérhetőséglista módosítási javaslata. Az érzékeny availabilities:draft hatókörrel az asszisztens javaslatot készít arra, hogyan hozzon létre, módosítson vagy töröljön elérhetőségeket egy webáruházban (availabilities_change_draft, csak MCP). A webáruházba semmit nem ír be: a javaslatot ellenőrzi, 24 órára elmenti a MitoOpsban, és visszaadja a draftId azonosítót, a tételenkénti előnézetet (preview a mezők korábbi és új értékével, warnings és errors), az expiresAt értéket és az approvalUrl hivatkozást a Raktár → Elérhetőségek képernyőre, ahol a javaslat a Kezelés fülön várakozik. Ott a jogosultsággal rendelkező személy a Jóváhagyás és írás gombbal jóváhagyja vagy elutasítja, és az írás a kattintás pillanatában az ő jogosultságaival történik. Ha a webáruház listája a javaslat óta megváltozott, a jóváhagyás semmit sem ír be, és a javaslat failed állapottal zárul. Az állapotot és a tételenkénti eredményt az availabilities_draft_get adja vissza: pending, writing, executed, partial, failed, rejected vagy expired. Ha az előnézet blokkolást jelez, javaslat nem jön létre (blocked), és akkor sem, ha semmi sem változik (no_change).

A bemenet a market és a changes (legfeljebb 30 tétel). Minden módosításnak van action értéke (create, update vagy remove), szerkesztésnél és törlésnél id értéke az availabilities_list eszközből, és csak a módosítandó mezőket tartalmazza: name (legfeljebb 120 karakter, a webáruház nyelvén), description (legfeljebb 1000 karakter, a null leírás nélkülit jelent), onStockHours és deliveryHours (egész órák 0 és 2500 között, a null azt jelenti, hogy nincs adat), meaning (in_stock, backorder, preorder, out_of_stock) és color (hex, a null szín nélkülit jelent). Az új elérhetőséghez name és meaning szükséges. Az opcionális clientRequestId idempotenssé teszi a hívást: ugyanaz a kulcs ugyanazzal a tartalommal ugyanazt a javaslatot adja vissza (replayed: true), eltérő tartalommal CONFLICT hibával (CLIENT_REQUEST_REUSED) végződik.

Az előnézet blokkolja azt, amit a webáruház elutasítana, vagy ami elrontaná a beállítást: duplikált név a webáruházban, rendszer- vagy alapértelmezett elérhetőség törlése, illetve olyané, amelyet elérhetőségi terv használ, WooCommerce-en pedig egy rendszertétel jelentésének módosítása, vagy az alapértelmezett tételnél olyan jelentés, amely nem illik a szerepéhez. A termékek által használt elérhetőséget a webáruház nem törli. A jelentés módosítását WooCommerce-en csak az a webáruház írja be, amelyen a MitoOps bővítmény 1.5.0-s vagy újabb verziója fut. Ha a webáruház az írás során nem ad egyértelmű választ (szerverhiba, időtúllépés), az írás nem ismétlődik meg, hanem a lista beolvasásával ellenőrizzük; ami nem ellenőrizhető, annál az eredményben uncertain: true szerepel. Az asszisztens csak a felhasználó kifejezett, a beszélgetésben adott utasítására készíthet javaslatot, soha nem a beolvasott adatokban lévő szöveg alapján, és nem talál ki olyan értékeket, amelyeket a felhasználó nem adott meg. A javaslat nem módosítja sem az elérhetőségek termékekhez rendelését, sem a készletszintet; a jóváhagyott jelentésmódosítás azonban megváltoztathatja, hogy az adott elérhetőségű termékek elfogyás után rendelhetők-e, és erre az előnézet figyelmeztet.

Reklamációs beállítások olvasásra. A claims_settings (claims:read hatókör) visszaadja a folyamatokat a típusok, lépések és állapotok azonosítóival és neveivel a választott nyelven (language), azoknál a tételeknél is, amelyeket a fiók nem nevezett át, valamint a címkéket; a claims-settings:read hatókörrel a modul beállításait is (kódelőtag, határidő, automatikus készletre vétel, űrlap a webáruházban). Ugyanezzel a hatókörrel a claims_templates visszaadja az e-mail-sablonokat (nyelv, tárgy, szöveg, HTML, mikor mennek ki: trigger, maguktól mennek-e ki: autoSend, melyik jegyzőkönyvet csatolják) és a jegyzőkönyv-sablonokat, language vagy templateKey szerint szűrve; a claims_configuration visszaadja a címkéket, az egyéni mezőket, a visszaküldés okait, a visszaszállítás útvonalait és címeit, a webáruházbeli űrlapot webáruházanként (az integrációs token nélkül) és az űrlaptípusokat a saját szövegeikkel. Az eladó címéhez tartozó kapcsolattartási adatok és utcacím csak a personal-data:read hatókörrel érhetők el. A claims_get tartalmazza az eset idővonalát (üzenetek, megjegyzések, állapotváltozások), az elküldött e-maileket (sablon, tárgy, állapot, a címzett címe nélkül) és a címkéket; az üzenetek szövegét csak a personal-data:read hatókörrel.

A reklamációs beállítások módosítási javaslata. Az érzékeny claims-settings:draft hatókörrel az asszisztens javaslatot készít (claims_config_change_draft, csak MCP): a folyamat típusának, lépésének és állapotának létrehozása vagy szerkesztése (nevek nyelvenként, szín, alapértelmezett és lezáró állapot, határidő), címke, egy e-mail-sablon szövege egy nyelven, annak automatikus küldése és a jegyzőkönyv-sablon szövege. Törlés nincs. A beállításokba semmit nem ír be: a javaslatot ugyanazokkal a szabályokkal ellenőrzi, mint a képernyő (például egy ismeretlen változó a sablonban blokkolja), 72 órára elmenti a MitoOpsban, és visszaadja a draftId azonosítót, az előnézetet (preview, a mező korábbi és új értéke, errors), az expiresAt értéket és az approvalUrl hivatkozást a Reklamációk → Beállítások oldalra, ahol a javaslat a Jóváhagyásra váró módosítási javaslatok panelen várakozik. A beállítások kezelésére jogosult személy jóváhagyja (Jóváhagyás és mentés) vagy elutasítja. A javaslat vagy teljes egészében beíródik, vagy egyáltalán nem: ha valamelyik érték a javaslat elkészítése óta megváltozott, semmi sem íródik be, és a javaslat failed állapottal zárul. Az állapotot a claims_config_draft_get adja vissza (pending, executed, failed, rejected, expired); ha az előnézet hibát jelez, javaslat nem jön létre (blocked), és akkor sem, ha semmi sem változik (no_change). Az azonosítókat és kulcsokat az asszisztens a claims_settings és a claims_templates eszközből veszi; a clientRequestId idempotenssé teszi a hívást.

Az eszközök a protokollrevízió szerinti annotációkat hordozzák (readOnlyHint, destructiveHint, idempotentHint); az automations_create_draft a clientRequestId révén idempotens, az automations_update_draft megköveteli az expectedVersion értéket, és a katalógus változásakor CATALOG_CHANGED választ ad; az automations_revision_create_draft a clientRequestId révén idempotens, az automations_revision_update_draft pedig megköveteli az expectedRevisionVersion értéket.

Az engedély visszavonható

Ha az engedélyt a Beállítások → API & MCP alatt visszavonja, minden belőle keletkezett hozzáférés érvényét veszti, mégpedig azonnal, nem a lejáratkor. Ugyanez történik, ha a csatlakozót a Claude.ai-ban leválasztja.

Protokollverziók

A szerver a 2026-07-28 revízióval és a régebbiekkel (2025-11-25, 2025-06-18, 2025-03-26) is kommunikál. A kliens maga választ aszerint, hogy mit küld; a régebbi kliensoldali könyvtárak tehát módosítás nélkül csatlakoznak.

Az újabb revízió kezdeti kézfogás és munkamenet nélkül működik: minden kérés a saját verzióját és a kötelező MCP-Protocol-Version és Mcp-Method fejlécet, eszközhívásnál pedig az Mcp-Name fejlécet is hordozza. Ha egy fejléc eltér a törzstől, a válasz 400: a fejlécek szerinti irányítás és a törzs szerinti végrehajtás két igazságforrást jelentene ugyanarról a hívásról.

Kapcsolódó oldalak

• Áttekintés
• REST interfész
• Kimenő webhookok
• Elérhetőségek