MCP sučelje

Ukratko

MitoOps pruža standardni udaljeni MCP poslužitelj (Model Context Protocol) na adresi /api/mcp, putem kojeg kompatibilna AI aplikacija sama traži podatke. Stoji nad istim sposobnostima kao REST: to nije drugo sučelje s vlastitim upitima, nego drugi način da se pita isto.

MCP nije svojstvo modela, nego aplikacije u kojoj model radi (klijenta). Povezuje se svaka aplikacija koja podržava udaljeni MCP putem HTTP-a s OAuthom ili s pristupnim ključem. Claude.ai je klijent provjeren u produkciji: njegov točan postupak je u nastavku; za drugu aplikaciju vrijedi opći postupak u sljedećem dijelu. Klijente koje nismo testirali ne proglašavamo provjerenima.

Identitet se može dokazati na dva načina:

• pristupnim ključem, koji izdajete u aplikaciji: za vlastiti program ili poslužitelj koji poziva poslužitelj;
• putem OAutha, kada se povezuje AI aplikacija koja to podržava: tada se prijavljujete Vi i aplikaciji na zaslonu privole odabirete što smije čitati.

U oba slučaja token ide u zaglavlju Authorization: Bearer i u oba vrijedi isti opseg ovlaštenja: ono što ključ ili privola ne obuhvaćaju, alat neće vratiti.

Kako povezati Claude.ai: provjereno povezivanje korak po korak

Claude.ai se ne povezuje na pojedine web trgovine, nego na MitoOps: na sloj koji već povezuje podatke svih Vaših web trgovina. Ne treba Vam nikakav ključ, Client ID ni tajna. Claude.ai sve sam saznaje iz adrese sučelja.

1. U Claude.ai otvorite Settings (Postavke) → Customize → Connectors (na timskom planu najprije Organization settings → Connectors kao administrator).
2. Pritisnite Add custom connector (Dodaj vlastiti konektor).
3. U polje Name upišite MitoOps.
4. U polje URL umetnite adresu MCP sučelja sa zaslona Postavke → API & MCP, u obliku https://<vaša adresa>/api/mcp, na primjer https://app.mitoops.com/api/mcp.
5. Advanced settings ostavite prazno: Claude.ai koristi vlastite hostirane metapodatke klijenta (OAuth). Pritisnite Add.
6. Uz konektor pritisnite Connect (Poveži).
7. Otvara se prijava u MitoOps (i s drugim faktorom, ako ga imate). Prijavite se.
8. Vidjet ćete zaslon privole: koja aplikacija, koji klijent, što smije čitati i na koje se web trgovine to odnosi. Dopuštenja su grupirana po područjima aplikacije (prodaja, skladište, dostava, marketing, partnerski program, automatizacije). Čitanje je unaprijed označeno, osjetljivi podaci i priprema nacrta nisu; promjene s izravnim učinkom (na primjer brisanje kupona ili odobrenje slanja) navedene su pojedinačno u sklopljenom dijelu Napredna dopuštenja. Uz svaku skupinu stoji što točno uključuje.
9. Provjerite opsege. Osjetljivi (na primjer Izvještaji, Nabavne cijene, Osobni podaci kupaca, Dobavljači i nabava, Automatizacije: nacrti, Dostupnosti: nacrti izmjena i Reklamacije: nacrti promjena postavki) nisu označeni. Ako Claude treba vidjeti maržu, osobne podatke, predlagati koncepte i izmjene automatizacija ili izmjene dostupnosti ili postavki reklamacija, označite ih svjesno. Predloške i postavke reklamacija čita opseg Reklamacije: postavke i predlošci. Odaberite web trgovine.
10. Pritisnite Dopusti. Claude.ai se vraća na svoju stranicu i konektor je povezan.
11. U razgovoru pritisnite + → Connectors i uključite konektor MitoOps.

Konektor povezan prije 2. 9. 2026.

Ako ste konektor povezali ranije, Claude.ai ima u predmemoriji starije metapodatke i na zaslonu privole nudio je samo četiri osnovna opsega. Konektor odspojite (Disconnect) i ponovno povežite (Connect): ponudit će se svi opsezi, uključujući osjetljive i nove (otprema, analitika, zalihe).

Ono što označite na zaslonu privole, to vrijedi, i nikada više nego što smijete sami. Tko u aplikaciji nema pravo na nabavne cijene, nema ga kako predati dalje. Token koji dobiva Claude.ai nosi samo dopuštene opsege.

Drugi MCP klijent ili AI aplikacija putem OAutha

Aplikaciji unosite istu adresu /api/mcp i ništa više: nikakav ključ. Dalje ide samo:

1. Aplikacija od nas traži kamo poslati prijavu (metapodaci zaštićenog resursa prema RFC 9728).
2. Otvara se Vaša prijava u MitoOps.
3. Vidite zaslon privole i odabirete opsege i web trgovine.
4. Nakon dopuštenja povezivanje je gotovo i aplikacija vidi alate.

Aplikacija koja sama odabire opsege mora ih navesti u zahtjevu: zaslon privole nudi samo ono što je aplikacija zatražila (i na što imate pravo). Sučelje oglašava sve opsege, uključujući osjetljive: u izazovu WWW-Authenticate i u scopes_supported. Osjetljivi se ipak nikada ne dopuštaju sami: na zaslonu privole su označeni i nisu odabrani, a token se izdaje sužen na ono što ste dopustili (scope u odgovoru tokena).

Kako se povezuje pristupnim ključem

Asistent ili program treba adresu /api/mcp na Vašoj domeni i pristupni ključ s MCP među sučeljima. Točnu adresu ispisuje zaslon Postavke → API & MCP u bloku „Gdje to povezati“. Ključ izdan samo za REST ne radi na MCP-u, i obrnuto.

Alati

Popis alata ravna se prema opsezima ključa ili privole: asistent vidi točno ono što mu je dopušteno i ništa drugo. Alat izvan opsega za njega ne postoji.

MCP alat	Opseg	REST	Što vraća
account_connection	stores:read	GET /account/connection	Dijagnostika ove veze: aplikacija, tko je i kada odobrio pristup, odobrena i nedostajuća dopuštenja po područjima, trgovine i način upisa putem AI.
account_entitlements	account:read	GET /account/entitlements	Tarifa klijenta, funkcije i ograničenja s trenutačnom iskorištenošću.
affiliate_articles_create	affiliate:write	—	pisanje: Otvaranje vlastitog članka pomoći na svim jezicima odjednom (naziv i tijelo na zadanom jeziku); HTML se čisti.
affiliate_articles_get	affiliate:read	GET /affiliate/articles/:key	Jedan članak pomoći s tekstom (HTML) na svim ili na jednom jeziku; varijable nisu umetnute.
affiliate_articles_list	affiliate:read	GET /affiliate/articles	Članci pomoći partnerskog portala: ključ, zadani/vlastiti, uključenost, redoslijed, stanje po jezicima (naziv, adresa, ispunjeno, isto kao zadano).
affiliate_articles_set_state	affiliate:write	—	pisanje: Uključivanje ili isključivanje članka pomoći za sve jezike odjednom; zadani se ne briše, samo isključuje.
affiliate_articles_update	affiliate:write	—	pisanje: Uređivanje članka pomoći na jednom jeziku (naziv, adresa, tijelo; HTML se čisti) ili vraćanje zadanog teksta; vraća nepoznate varijable.
affiliate_campaigns_create	affiliate:write	—	pisanje: Otvaranje kampanje na web trgovini: naziv, nagrada (ne izmišljati), valjanost dodjele, dostupnost, odobravanje konverzija.
affiliate_campaigns_get	affiliate:read	GET /affiliate/campaigns/:campaignId	Jedna kampanja partnerskog programa.
affiliate_campaigns_list	affiliate:read	GET /affiliate/campaigns	Kampanje partnerskog programa web trgovine s nagradom, dostupnošću i brojevima.
affiliate_campaigns_update	affiliate:write	—	pisanje: Uređivanje kampanje: naziv, nagrada, valjanost, dostupnost, odobravanje, uključivanje/isključivanje, opis za partnere po jezicima.
affiliate_code_requests_decide	affiliate:write	—	pisanje: Rješavanje zahtjeva partnera za vlastiti kod: odobrenje odmah otvara kod u web trgovinama kampanja s popustom za kupca (zahtijeva i coupons:write), retry ponavlja otvaranje, odbijanje zahtijeva razlog; partner dobiva e-poruku.
affiliate_code_requests_list	affiliate:read	GET /affiliate/code-requests	Zahtjevi partnera za vlastiti kod za popust sa stanjem i razlogom; najprije oni koji čekaju.
affiliate_conversions_decide	affiliate:approve	—	pisanje: Odluka o jednoj proviziji prema id-u: approve (nova → odobrena), reject (nova → odbijena, razlog obavezan), cancel (odobrena → otkazana, razlog obavezan); isplaćena se ne vraća, ista odluka drugi put ništa ne mijenja; partner dobiva e-poruku.
affiliate_conversions_get	affiliate:read	GET /affiliate/conversions/:conversionId	Detalj jedne konverzije: iznosi, provizija, stanje provizije s razlogom, status narudžbe u web trgovini, odobrenje, isplata.
affiliate_conversions_list	affiliate:read	GET /affiliate/conversions	Konverzije partnerskog programa web trgovine: osnovica provizije i cijela narudžba s PDV-om, provizija, stanje provizije s razlogom, status narudžbe u web trgovini, veza na isplatu.
affiliate_discount_codes_ensure	coupons:write	—	pisanje: Osigurava da partner na web trgovini ima kod za popust: kupon se otvara putem kanonskih kupona (ili se koristi postojeći) i dodjeljuje partneru; napomena u web trgovini nastaje automatski.
affiliate_discount_codes_list	affiliate:read	GET /affiliate/discount-codes	Kodovi za popust partnera na web trgovini s brojem korištenja i prometom.
affiliate_documents_draft_create	affiliate:write	—	pisanje: Prijedlog novog teksta pravnog dokumenta kao koncept; stvarni tekst ne mijenja: objavljuje ga osoba u aplikaciji s razlikom i revizijom.
affiliate_documents_get	affiliate:read	GET /affiliate/documents/:key/content	Jedan pravni dokument programa s tekstom po jezicima (spremljeni tekst, javni tekst, verzija, otisci, izvor, PDF metapodaci) i otvorenim konceptima.
affiliate_documents_list	affiliate:read	GET /affiliate/documents	Dokumenti programa (uvjeti, sporazumi): pravila potvrde, potpisana kopija, privitak e-poruke, verzije po jezicima, spremnost i broj potvrda.
affiliate_documents_update	affiliate:write	—	pisanje: Pravila dokumenta programa (za koga vrijedi, kada se potvrđuje, potpisana kopija, privitak e-poruke, uključenost); tekst se učitava u aplikaciji.
affiliate_email_templates_list	affiliate:read	GET /affiliate/email-templates	Predlošci e-poruka partnerima po jezicima (predmet, uključenost, s događajem i tijelo) i automatski prilozi e-poruke Račun odobren.
affiliate_email_templates_update	affiliate:write	—	pisanje: Uređivanje predloška e-poruke partnerima na jednom jeziku (predmet, tijelo) ili uključivanje/isključivanje događaja.
affiliate_links_generate	affiliate:read	GET /affiliate/links/generate	Praćena partnerska poveznica na početnu stranicu, proizvod ili kategoriju web trgovine kampanje; nakon klika zadržava dodjelu partneru.
affiliate_partners_get	affiliate:read	GET /affiliate/partners/:partnerId	Jedan partner programa s kampanjama koje ima na raspolaganju.
affiliate_partners_list	affiliate:read	GET /affiliate/partners	Partneri programa sa stanjem, učinkom i provizijama; kontakt samo s osobnim podacima.
affiliate_partners_set_market	affiliate:write	—	pisanje: Članstvo partnera u web trgovini: dopustiti (active, odobrava i zahtjev iz portala) ili oduzeti (revoked); kampanje, kuponi i dokumenti web trgovine odnose se na partnera samo s aktivnim članstvom.
affiliate_partners_set_state	affiliate:write	—	pisanje: Odluka o računu partnera (odobriti, odbiti, suspendirati, vratiti među one koji čekaju); odobrenje šalje e-poruku sa sporazumom.
affiliate_payouts_list	affiliate:read	GET /affiliate/payouts	Isplate provizija partnerima sa stanjem; bez bankovnih podataka i podataka za naplatu.
affiliate_portal_get	affiliate:read	GET /affiliate/portal	Javni portal partnera: adrese po web trgovinama, otvorenost registracije s razlogom, vlastite domene, kontaktna osoba, izgled i stanje tekstova po jezicima.
affiliate_portal_pages_update	affiliate:write	—	pisanje: Vlastiti tekstovi javnog portala na jednom jeziku (stranice prijava/registracija/pregled, obavijest, opis programa); HTML se čisti.
affiliate_settings	affiliate:read	GET /affiliate/settings	Postavke partnerskog programa: provizije, klikovi, minimum isplate, dovođenje.
affiliate_settings_update	affiliate:write	—	pisanje: Postavke programa osim novca: naziv, registracija, automatsko odobravanje, kontaktna osoba, boje, poveznica na pravila.
affiliate_signatures_get	affiliate:read	GET /affiliate/signatures/:signatureId	Jedan elektronički potpis s potpisanim tekstom i snimkom vrijednosti; nepromjenjiv zapis, PDF se slaže u aplikaciji.
affiliate_signatures_list	affiliate:read	GET /affiliate/signatures	Elektronički potpisani dokumenti partnera (tko, dokument, verzija, jezik, web trgovina, vrijeme, način, provjera, otisci, stanje) i partneri kojima potpis nedostaje; samo čitanje: potpis nastaje isključivo u portalu.
affiliate_statistics	affiliate:read	GET /affiliate/statistics	Statistika partnerskog programa: kretanje po danima, izvori dodjele, ljestvica partnera.
affiliate_summary	affiliate:read	GET /affiliate/summary	Pregled partnerskog programa web trgovine za razdoblje: klikovi, konverzije, provizije, partneri.
affiliate_variables_list	affiliate:read	GET /affiliate/variables	Registar varijabli sadržaja i e-poruka partnerskog programa: kanonski nazivi, aliasi, vrsta, površine, primjer; neobavezna provjera teksta na nepoznate varijable.
analytics_advertising	reports:read	GET /analytics/advertising	Oglašavanje: troškovi, proračun, ROAS, udio troška u prihodu, CPA, prosječna narudžba i MER s usporedbom; Google Ads i Meta Ads, klikovi iz GA4, 6 mjeseci.
analytics_channels	analytics:read	GET /analytics/channels	Raspodjela posjeta, narudžbi i prometa prema marketinškim kanalima.
analytics_comparison	reports:read	GET /analytics/comparison	Promet s usporedbom: promet, narudžbe, AOV, posjeti, CR i AI/LLM u odnosu na prethodno razdoblje ili godinu.
analytics_monthly	reports:read	GET /analytics/monthly	Promet, narudžbe i posjeti po mjesecima (najviše 24), na primjer godina na godinu.
analytics_order_coverage	analytics:read	GET /analytics/order-coverage	Pokrivenost narudžbi i prometa mjerenjem u analitici.
analytics_order_heatmap	reports:read	GET /analytics/order-heatmap	Kada stižu narudžbe: dan u tjednu × sat, najjači dan i sat.
analytics_overview	analytics:read	GET /analytics/overview	Posjete, narudžbe, promet, stopa konverzije i AI/LLM udio za razdoblje.
analytics_revenue_sources	reports:read	GET /analytics/revenue-sources	Odakle je došao promet: kanali, zbrojevi za AI/LLM, MitoOps i Affiliate, akvizicija prema GA4.
analytics_seo	analytics:read	GET /analytics/seo	Search Console: klikovi, prikazi, CTR i pozicija prema upitima ili stranicama.
automations_catalog	automations:read	GET /automations/catalog	Katalog automatizacija: okidači, uvjeti, operatori, radnje, predlošci; catalogVersion za nacrte.
automations_create_draft	automations:write	—	pisanje: Izrađuje ISKLJUČENI koncept automatizacije. Ne uključuje ga niti pokreće.
automations_get	automations:read	GET /automations/:workflowId	Jedna automatizacija s DSL-om i rezultatom validacije.
automations_list	automations:read	GET /automations	Automatizacije klijenta sa stanjem i opsegom web trgovina.
automations_options	automations:read	GET /automations/options	Šifrarnik za polje automatizacije (statusi, dostave, plaćanja, predlošci, reklamacije…): value za DSL i naziv.
automations_revision_create_draft	automations:write	—	pisanje: Predlaže izmjenu objavljene automatizacije kao reviziju za odobrenje od strane osobe. Verzija koja radi ne mijenja se.
automations_revision_discard_draft	automations:write	—	pisanje: Povlači otvorenu reviziju objavljene automatizacije.
automations_revision_update_draft	automations:write	—	pisanje: Uređuje otvorenu reviziju objavljene automatizacije.
automations_runs	automations:read	GET /automations/:workflowId/runs	Povijest pokretanja jedne automatizacije.
automations_templates	automations:read	GET /automations/templates	Gotovi predlošci automatizacija s DSL-om.
automations_update_draft	automations:write	—	pisanje: Uređuje neobjavljeni koncept automatizacije s optimističnom istodobnošću.
automations_validate_draft	automations:read	—	Provjerava nacrt automatizacije bez zapisa.
chatbot_conversations_get	chatbot-conversations:read	GET /chatbot/conversations/:sessionId	Prijepis jednog razgovora s web chatbotom, uključujući izvore odgovora bota.
chatbot_conversations_list	chatbot-conversations:read	GET /chatbot/conversations	Razgovori kupaca s web chatbotom od posljednjeg aktivnog, s prvim pitanjem; kursor.
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	Statistika web chatbota za razdoblje: lijevak oblačića, otvaranja, razgovori, rezultati, ocjene.
chatbot_topics	chatbot:read	GET /chatbot/topics	O čemu su bili razgovori: udjeli tema, proizvodi, vrsta početne stranice i kandidati za prazninu u znanju.
claims_config_change_draft	claims-settings:draft	—	pisanje: Predlaže promjenu procesa, stanja, oznaka, predložaka, tekstova obrasca i postavki modula reklamacija; zapisuje je tek čovjek odobrenjem u aplikaciji.
claims_config_draft_get	claims-settings:read	GET /claims/config-drafts/:draftId	Stanje nacrta promjene postavki reklamacija (čeka, zapisan, odbijen).
claims_configuration	claims-settings:read	GET /claims/configuration	Postavke reklamacija: oznake, polja, povratni prijevoz, obrazac na web trgovini, vrste obrasca.
claims_get	claims:read	GET /claims/:code	Jedan predmet sa stavkama i vezama: narudžba, odobrenje, povratna pošiljka, skladišno kretanje.
claims_list	claims:read	GET /claims	Reklamacije i povrati jedne web trgovine od najnovijeg.
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	Povrati po reklamacijama: način, bankovni računi s prikladnošću za platni nalog (maskirani), zadani i ručni račun.
claims_routes	claims-settings:read	GET /claims/routes	Povratni prijevoz reklamacija: rute, adrese, profili prijevoznika s ID-jevima i podrškom za povrat, vrste slučajeva.
claims_routes_change_draft	claims-routes:draft	—	pisanje: Predlaže povratnu rutu (i za cijelu EU ili svijet) i adresu primatelja; zapisuje ih čovjek odobrenjem (ili autonomni zapis, ako ga je klijent uključio).
claims_settings	claims:read	GET /claims/settings	Procesi reklamacija s ID-ovima i nazivima (vrste, koraci, stanja, rokovi), oznake; postavke modula s opsegom claims-settings:read.
claims_statistics	claims:read	GET /claims/statistics	Statistika reklamacija i povrata za razdoblje: brojevi, vremena rješavanja, vrste, ocjene, razlozi.
claims_templates	claims-settings:read	GET /claims/templates	Predlošci e-poruka (predmet, tekst, kada i šalju li se automatski) i zapisnika reklamacija.
content_articles_search	products:read	GET /content/articles	Članci bloga web trgovine s adresom na webu i slikom za pregled.
coupons_activation_link	coupons:read	GET /coupons/activation-link	Poveznica koja kupcu primjenjuje POSTOJEĆI kupon u košarici. Ne izrađuje kupon.
coupons_activation_status	coupons:read	GET /coupons/activation-status	Može li se kupon na web trgovini koristiti putem aktivacijske poveznice: zrcalo kupona + stanje koda na webu.
coupons_capabilities	coupons:read	GET /coupons/capabilities	Što platforma te web trgovine zna o kuponima. Pročitajte prije otvaranja.
coupons_ensure	coupons:write	—	pisanje: Osigurava da kupon na odabranim web trgovinama postoji. Kod drugog iznosa popusta NE PREPISUJE se.
coupons_get	coupons:read	GET /coupons/:code	Jedan kupon iz evidencije MitoOps. Kada ga u njoj nema, odgovor je „nije pronađeno“.
coupons_list	coupons:read	GET /coupons	Kuponi za popust web trgovine s vrstom i iznosom popusta, valjanošću i izvedenim stanjem.
coupons_remove	coupons:delete	—	pisanje: Izričito brisanje kupona: ovisnosti, pregled, potvrda; sa živom ovisnošću ne briše se.
coupons_update	coupons:write	—	pisanje: Izričito uređivanje postojećeg kupona, uključujući ograničenja na proizvode i kategorije; pregled, zatim potvrda.
customers_get	customers:read	GET /customers/:customerKey	Jedan kupac iz imenika: identitet, web trgovine, LIFETIME i neobavezni PERIOD novac, raščlamba po web trgovini.
customers_list	customers:read	GET /customers	Imenik kupaca: identitet (s maskiranjem PII), web trgovine, jezik, LIFETIME brojevi i promet po valutama; neobavezni filtar kupovne aktivnosti u razdoblju.
customers_performance	reports:read	GET /customers/performance	Kupci kao pseudonimi: broj narudžbi, promet, prva i posljednja narudžba, ponovna kupnja, LTV.
credit_notes_search	invoices:read	GET /credit-notes	Pretraživanje odobrenja.
documents_list	invoices:read	GET /documents	Računovodstveni dokumenti jedne vrste (računi, predračuni, odobrenja) po stranicama sa životnim ciklusom, stanjem u izvoru, filtrom valjanosti i dostupnošću PDF-a.
documents_pdf_link	invoices:read	—	Kratkotrajna poveznica (10 minuta) na PDF računa, predračuna ili odobrenja za otvaranje u pregledniku.
invoices_get	invoices:read	GET /invoices/:invoiceCode	Jedan račun sa stavkama, iznosima, odobrenjima i predračunima uz njega.
invoices_search	invoices:read	GET /invoices	Pretraživanje računa.
inventory_movements	inventory:read	GET /inventory/movements	Povijest skladišnih kretanja: kada, što, za koliko, zašto i iz kojeg izvora.
inventory_product_availability	inventory:read	GET /inventory/availability	Stanje zalihe za više stavki odjednom.
inventory_stock	inventory:read	GET /inventory/stock	Stanje zalihe jedne stavke, uključujući izvor vrijednosti.
orders_get	orders:read	GET /orders/:orderCode	Jedna spremljena narudžba, uključujući stavke.
orders_list	orders:read	GET /orders	Spremljene narudžbe jedne web trgovine, od najnovije.
availabilities_change_draft	availabilities:draft	—	pisanje: NACRT izmjene šifrarnika dostupnosti (otvoriti, urediti, izbrisati). U web trgovinu upisuje ga tek osoba odobrenjem u MitoOps.
availabilities_draft_get	products:read	GET /availabilities/drafts/:draftId	Stanje nacrta izmjene šifrarnika dostupnosti: čeka odobrenje, zapisan s rezultatom, odbijen, istekao.
availabilities_list	products:read	GET /availabilities	Šifrarnik dostupnosti web trgovine: naziv, opis, uskladištenje, dostava, značenje za Google, boja, zadana uloga.
categories_content_change_draft	category-content:draft	—	pisanje: PRIJEDLOG novih tekstova kategorija (najviše 30 odjednom); u web trgovinu ih upisuje tek čovjek odobrenjem u MitoOps.
categories_content_draft_get	category-content:read	GET /catalog/category-content-drafts/:draftId	Stanje prijedloga tekstova kategorija: čeka odobrenje, upisan, odbijen, istekao.
categories_content_get	category-content:read	GET /categories/:guid/content	Tekstovi kategorije (gornji i donji opis, SEO naslov i opis) s otiskom i mogućnošću upisa.
categories_list	products:read	GET /categories	Kategorije web trgovine s brojem proizvoda.
products_content_change_draft	product-content:draft	—	pisanje: PRIJEDLOG novih tekstova proizvoda (najviše 30 odjednom); u web trgovinu ih upisuje tek čovjek odobrenjem u MitoOps.
products_content_draft_get	product-content:read	GET /catalog/product-content-drafts/:draftId	Stanje prijedloga tekstova proizvoda: čeka odobrenje, upisan s upozorenjima web trgovine, odbijen, istekao.
products_content_get	product-content:read	GET /products/:code/content	Tekstovi proizvoda iz web trgovine (opis, kratki opis, SEO naslov i opis) s otiskom i mogućnošću upisa.
products_content_policy	product-content:read	GET /product-content/policy	Pravila sadržaja web trgovine bez poziva web trgovini: što ovaj pristup smije čitati i predlagati, koja polja platforma upisuje, način odobravanja i autonomni upis, ograničenja i otisci.
products_get	products:read	GET /products/:code	Jedan proizvod prema šifri, uključujući razvrstavanje i cijenu s kartice.
products_search	products:read	GET /products	Pretraživanje proizvoda prema nazivu, šifri, EAN-u ili PLU-u.
reports_financial_summary	reports:read	GET /reports/financial-summary	Financijski sažetak razdoblja: promet, PDV, narudžbe, AOV; s pravima i nabava, bruto dobit, troškovi i rezultat.
sales_order_performance	reports:read	GET /sales/order-performance	Promet po narudžbama u EUR sa zbrojevima za cijelo razdoblje; s pravom i nabava, bruto dobit i marža po narudžbi.
sales_product_performance	reports:read	GET /sales/product-performance	Prodaja po proizvodima iz dokumenata; s pravom i nabavna cijena u trenutku prodaje i marža.
search_console_query	search-console:read	GET /search-console/query	Search Console po danima, upitima, stranicama, zemljama i uređajima, sa straničenjem i sažetkom sadržaja.
search_console_status	search-console:read	GET /search-console/status	Stanje Search Consolea trgovine: veza, svojstvo, dopuštenje, sinkronizacija i opseg arhiva.
shipping_carriers	shipping:read	GET /shipping/carriers	Povezane dostavne službe i njihovi profili, bez pristupnih podataka.
shipping_shipment_detail	shipping:read	GET /shipping/shipments/:shipmentId	Jedna pošiljka sa svim događajima praćenja.
shipping_shipments	shipping:read	GET /shipping/shipments	Pošiljke jedne web trgovine s dostavnom službom, zemljom i vremenima predaje i dostave.
shipping_stats	shipping:read	GET /shipping/stats	Statistike dostave prema dostavnim službama: brojevi, uspješnost, medijan i p90 vremena dostave, zemlje.
stores_integration_status	stores:read	GET /stores/integration-status	Stanje MitoOps koda na webu po web trgovinama: instalirano, verzija, moduli, spremnost kupona iz adrese.
stores_list	stores:read	GET /stores	Popis web trgovina klijenta, uključujući njihov kod.
suppliers_get	purchasing:read	GET /suppliers/:supplierId	Jedan dobavljač s ponudama proizvoda i troškovnim sastavnicama.
suppliers_list	purchasing:read	GET /suppliers	Dobavljači klijenta s brojem ponuda i uparenih proizvoda.
webhooks_deliveries	webhooks:read	GET /webhooks/endpoints/:endpointId/deliveries	Dnevnik dostava jednog endpointa bez tijela.
webhooks_endpoint	webhooks:read	GET /webhooks/endpoints/:endpointId	Jedan webhook endpoint s brojem dostava koje čekaju.
webhooks_endpoints	webhooks:read	GET /webhooks/endpoints	Webhook endpointi klijenta bez tajni i stanje reda čekanja.
webhooks_events	webhooks:read	GET /webhooks/events	Katalog događaja odlaznih webhookova, omotnica i potpis.

Ime, e-pošta, telefon i ulica kupca nalaze se u orders_list, orders_get, claims_list i claims_get samo s opsegom personal-data:read; bez njega odgovor nosi zemlju i mjesto. Isto vrijedi za kontakt dobavljača i partnera programa (affiliate_partners_*). Opseg nema vlastiti alat.

U imeniku kupaca (customers_list, customers_get) isti opseg odlučuje o imenu, tvrtki, e-pošti, telefonu i marketinškom spolu; bez njega ostaju pseudonim, web trgovine, zemlja, jezik, brojevi i datumi. Promet i LTV dodatno su iza reports:read. Marketinški spol procjena je iz imena (genderSource: "name_inference"), a ne podatak koji bi kupac naveo: asistent ga tako treba i predstavljati. Bankovni i porezni podaci partnera nikada se ne izdaju.

Web chatbot: teme razgovora. chatbot_topics (isti opseg chatbot:read) jednim pozivom odgovara na pitanje „o čemu je bilo“: udio razgovora po temama iz zatvorene taksonomije (dostava, plaćanje, povrat, odabir proizvoda, parametri, korištenje, edukativna pitanja…), stopu rješavanja i broj kandidata za prazninu u znanju po temi, najčešće proizvode (o kojima su kupci pitali i koje je bot preporučio), s koje vrste stranice razgovori počinju i kretanje po danima. Procjena je deterministička: počiva na izvorima odgovora, preporučenim proizvodima i rječniku ključnih riječi, pa dva poziva nad istim razdobljem daju isti broj. Vraća samo zbrojeve: tekst kupca u nju ne dolazi ni na koji način, ni kao „najčešće pitanje“. Udio uvijek ide s brojem: kod malog broja razgovora postotak je nepouzdan. chatbot_conversations_list ima filtre topic i knowledgeGapCandidate; prijepis konkretnog razgovora i dalje je iza osjetljivog opsega i samo u okviru razdoblja čuvanja.

Web chatbot. Statistika (chatbot_stats, opseg chatbot:read) vraća samo zbrojeve: kolikom je broju posjeta stranici prikazan oblačić i koliko je od njih kliknulo na njega, otvaranja prozora, broj razgovora i poruka, što je bot riješio, ocjene kupaca i lijevak registracije za newsletter. Razgovori kupaca (chatbot_conversations_list, chatbot_conversations_get) nalaze se iza vlastitog osjetljivog opsega chatbot-conversations:read, koji na zaslonu privole označavate svjesno: kupac je u evidenciji samo nasumični ključ razgovora (bez IP-a, kolačića, imena ili e-pošte), a e-poštu, telefon i IBAN koje je napisao u tekst asistent dobiva samo s personal-data:read: inače umjesto njih vidi oznaku [e-mail], [telefón], [iban]. Razgovori se izdaju samo u okviru razdoblja čuvanja web trgovine (postavka Povijest u AI centru); web trgovina s razdobljem čuvanja nula ne izdaje ništa. Prikazi oblačića do 21. 9. 2026. brojali su se pri svakom iskakanju poruke; od 22. 9. 2026. prikaz je jedan posjet stranici, a measurementChanges u odgovoru govori miješa li odabrano razdoblje oba mjerenja.

Svaki alat ima parnjak u REST-u nad istom sposobnošću. Odgovori se razlikuju omotnicom, a poslovni podaci su jednaki. Pravila razdoblja, straničenja i značenje financijskih polja nalaze se u REST sučelju.

Zbirni alati (shipping_stats, analytics_*, reports_financial_summary) vraćaju gotove brojke iz aplikacije: asistent ne mora preuzimati tisuće zapisa i računati sam. Sirovi popisi (shipping_shipments, orders_list) ostaju za detaljan pogled.

Što se može pitati

Nakon povezivanja Claude.ai iz podataka MitoOps odgovara na primjer na:

• „Kakva je bila postotna raspodjela dostave za kolovoz?“: shipping_stats
• „Koliki je bio medijan vremena dostave DHL-a i GLS-a?“ i „Koliko je bilo nedostavljenih i vraćenih?“: shipping_stats
• „U koje smo zemlje slali putem DHL-a?“: shipping_stats (polje countries)
• „Koliki su bili promet i stopa konverzije za kolovoz?“: analytics_overview ili reports_financial_summary
• „Koliko je narudžbi i prometa došlo iz ChatGPT-a?“: analytics_channels
• „Koji su upiti imali najviši CTR?“: analytics_seo
• „Kolika je marža proizvoda X za posljednji mjesec?“: sales_product_performance (s purchase-prices:read)
• „Što su kupci ovaj mjesec najčešće pitali chatbot i o čemu napisati članak za blog?“: chatbot_conversations_list i chatbot_conversations_get (s chatbot-conversations:read)
• „Koliko je razgovora imao chatbot i koliko ih je riješio bez podrške?“: chatbot_stats
• „Koje dostupnosti ima web trgovina SK i koje su zadane?“ (availabilities_list)
• „Dodaj na web trgovinu SK dostupnost Pretprodaja listopad sa značenjem pretprodaja i dostavom do 14 dana“ (availabilities_change_draft s availabilities:draft; nastaje nacrt koji upisujete odobrenjem u aplikaciji)
• „Uredi uključenu automatizaciju 12 tako da šalje upozorenje samo kod dostave Kurir“ (automations_options za dostavu, zatim automations_revision_create_draft; verzija koja radi ne mijenja se dok reviziju ne objavite u uređivaču)
• „Koje e-poruke reklamacije šalju automatski i što u njima piše na njemačkom?“ (claims_templates s claims-settings:read)
• „Preimenuj stanje reklamacije Čekanje robe u Čekamo pošiljku“ (claims_settings za ID, zatim claims_config_change_draft s claims-settings:draft; upisujete odobrenjem u aplikaciji)

Čitanje i uski zapisi: automatizacije, kupon, partnerski program, dostupnosti, reklamacije

Operativni podaci (narudžbe, stanje zaliha, proizvodi, dokumenti, pošiljke) putem MCP-a se samo čitaju. Svaki zapis stoji iza vlastitog osjetljivog opsega: koncept automatizacije, kupon za popust, upravljanje partnerskim programom, odluka o proviziji, nacrt izmjene šifrarnika dostupnosti, koji u web trgovinu upisuje tek osoba, i nacrt promjene postavki reklamacija, koji također upisuje tek osoba.

Koncept automatizacije: s opsegom automations:write to je isključeni koncept: s opsegom automations:write asistent može prema katalogu (automations_catalog) predložiti pravilo i spremiti ga kao koncept, ili urediti koncept koji još nitko nije objavio. Koncept se pojavljuje u Automatizacije kao svaki započeti nacrt: uključiti, objaviti ili pokrenuti ga možete samo Vi u aplikaciji. Objavljenu automatizaciju asistent izravno ne mijenja.

Revizija automatizacije koja radi. I objavljenu i uključenu automatizaciju asistent s opsegom automations:write može urediti, ali samo prijedlogom: automations_revision_create_draft (ulaz workflowId, expectedPublishedVersion iz automations_get, catalogVersion, cijeli novi dsl, note i clientRequestId) sprema reviziju uz verziju koja radi. Automatizacija koja radi ne mijenja se i radi dalje. Po automatizaciji je najviše jedna otvorena revizija; uređuje se putem automations_revision_update_draft s expectedRevisionVersion, a odbacuje putem automations_revision_discard_draft. Odgovor nosi approvalUrl, poveznicu u uređivač automatizacije. Ondje osoba s pravom uređivanja automatizacija vidi reviziju na gornjoj ploči, učitava je u uređivač (gumb Učitaj prijedlog u uređivač), provjerava i objavljuje uobičajenim gumbom; automatizacija ostaje uključena. Ili je odbija. Kada je u međuvremenu netko objavio drugu verziju, revizija se zatvara (REVISION_STALE) i treba pripremiti novu. Otvorenu reviziju i povijest vraća automations_get (openRevision, revisions).

Šifrarnici polja i provjera vrijednosti. Polja koja se u uređivaču biraju s popisa (status narudžbe, dostava, plaćanje, profil dostavne službe, predložak upozorenja, vrsta, stanje, oznaka i predlošci reklamacije, webhook endpoint i drugo) u katalogu imaju izvor. automations_options sa source i market vraća njihove vrijednosti [{ value, name }] točno u obliku koji uređivač sprema (ID statusa, GUID dostave i plaćanja, ID stanja reklamacije); bez source ispisuje izvore i jesu li za svaku web trgovinu drukčiji (perShop). Validacija (automations_validate_draft) i spremanje koncepta ili revizije odbijaju vrijednost koja u web trgovini ne postoji (FIELD_UNKNOWN_OPTION) i zamjenski tekst tipa DOPLNIT_… ili TODO (FIELD_PLACEHOLDER). Kada se popis ne može provjeriti (web trgovina nije odgovorila, popis je skraćen), stiže samo upozorenje FIELD_OPTIONS_UNVERIFIED. orders_get i orders_list nose statusId, shippingGuid i paymentGuid, dakle iste vrijednosti s kojima rade uvjeti automatizacije.

Opseg automations:write je osjetljiv: na zaslonu privole nije unaprijed označen, nudi se samo osobi s pravom uređivanja automatizacija, postojeća povezivanja ga ne dobivaju, a obnova tokena ga ne proširuje. Narudžbe, proizvodi, stanje zaliha, dokumenti, povrati novca, reklamacijski predmeti ni pošiljke ne mogu se mijenjati putem MCP-a; šifrarnik dostupnosti web trgovine i postavke reklamacija mijenjaju se samo nacrtom koji odobrava osoba u aplikaciji (u nastavku). Webhook endpointi putem MCP-a se samo čitaju. Pristupni podaci za dostavne službe, web trgovinu ni analitiku ne mogu se pročitati putem MCP-a.

Kupon za popust: s opsegom coupons:write asistent otvara kupon prema parametrima koje zadate (coupons_ensure, i kupon partnera affiliate_discount_codes_ensure) i izričito uređuje postojeći (coupons_update, pregled i potvrda); brisanje ima vlastiti opseg coupons:delete, a kupon sa živom ovisnošću ne briše se.

Upravljanje partnerskim programom: s opsegom affiliate:write asistent odlučuje o računu partnera (affiliate_partners_set_state: odobriti, odbiti, suspendirati; partner dobiva e-poruku i PDF sporazuma prema pravilima dokumenata), rješava zahtjev za vlastiti kod (affiliate_code_requests_decide), uređuje postavke programa osim novca (affiliate_settings_update: naziv, registracija, kontaktna osoba, boje), tekstove portala na jednom jeziku (affiliate_portal_pages_update), članke pomoći (affiliate_articles_create, affiliate_articles_update i s vraćanjem zadanog teksta, affiliate_articles_set_state; brisanje izvana ne), predloške e-poruka (affiliate_email_templates_update), kampanje (affiliate_campaigns_create, affiliate_campaigns_update), pravila dokumenata (affiliate_documents_update) i članstvo partnera u web trgovini (affiliate_partners_set_market: dopustiti ili oduzeti). Tekst pravnih dokumenata čita (affiliate_documents_get: tekst po jezicima, verzija, otisci, koncepti), a novi tekst predlaže samo kao koncept (affiliate_documents_draft_create; i privacyNotice u affiliate_portal_pages_update je od ove verzije koncept): stvarni tekst objavljuje osoba u aplikaciji s razlikom i revizijom. Registar varijabli sadržaja i e-poruka (kanonski nazivi, aliasi, vrsta, površine) daje affiliate_variables_list; affiliate_email_templates_list vraća nazive varijabli, a ne indekse. Isplate, osnovica provizije ni učitavanje datoteke dokumenta putem MCP-a ne postoje: ostaju u aplikaciji.

Odluka o proviziji: s vlastitim osjetljivim opsegom affiliate:approve (pravo odobravanje provizija, a ne upravljanje programom) asistent najprije čita provizije koje čekaju, zajedno sa statusom narudžbe u web trgovini (affiliate_conversions_list sa state=new, detalj affiliate_conversions_get: osnovica provizije revenue, cijela narudžba s PDV-om revenueTotal, orderState open/completed/cancelled, orderPaid, odobrenje), sažima ih i tek na izričitu uputu korisnika odlučuje o jednoj konkretnoj konverziji (affiliate_conversions_decide: approve, reject ili cancel, pri odbijanju i otkazivanju s obaveznim razlogom, koji partner dobiva e-poštom). Vrijedi isti automat stanja kao u aplikaciji: isplaćena provizija ne vraća se, otkazana i odbijena su završne, ista odluka drugi put ništa ne mijenja (changed: false). Skupno odobrenje izvana ne postoji: za sto konverzija je sto poziva, svaki s revizijom. Od W-AFF10 svaka konverzija nosi i approvalPolicy (način odobravanja kampanje, rok, dopušteni statusi narudžbe, plaćanje) i approvalEligibility: bi li je automatika koja radi svaki sat sada odobrila i zašto ne (minimum_age_not_reached, order_state_not_allowed, order_not_paid, order_cancelled, fully_refunded, approval_manual…), isti izračun kao u aplikaciji; popis ima filtre orderPaid, minCommission, orderState i straničenje offset + hasMore, pa je „prođi nove konverzije za dva mjeseca, pokaži neplaćene ili one iznad 20 €“ jedno do nekoliko čitanja. Uvjete kampanje postavlja affiliate_campaigns_update (approval, approveAfterDays, requiredOrderStatusIds, paidRequired) s opsegom affiliate:write. Isplate partnerima putem MCP-a se samo čitaju (affiliate_payouts_list): izdati seriju, generirati dokument, poslati ga partneru ni predati nalog banci asistent ne može; to ostaje u aplikaciji pod kontrolom operatera.

Nacrt izmjene šifrarnika dostupnosti. S osjetljivim opsegom availabilities:draft asistent priprema nacrt o tome kako na jednoj web trgovini otvoriti, urediti ili izbrisati dostupnosti (availabilities_change_draft, samo MCP). U web trgovinu ništa ne upisuje: nacrt provjerava, sprema ga u MitoOps na 24 sata i vraća draftId, pregled po stavkama (preview s poljima prije i poslije, warnings i errors), expiresAt i approvalUrl, poveznicu na zaslon Skladište → Dostupnosti, gdje nacrt čeka na kartici Upravljanje. Ondje ga osoba s ovlaštenjem odobrava gumbom Odobri i zapiši ili odbacuje, a upis se provodi s njezinim pravima u trenutku klika. Kada se šifrarnik web trgovine od nacrta promijeni, odobrenje ništa ne upisuje i nacrt završava kao failed. Stanje i rezultat po stavkama vraća availabilities_draft_get: pending, writing, executed, partial, failed, rejected ili expired. Kada pregled javlja blokadu, nacrt ne nastaje (blocked), a kada se ništa ne mijenja, također ne (no_change).

Ulaz je market i changes (najviše 30 stavki). Svaka izmjena ima action (create, update ili remove), kod uređivanja i brisanja id iz availabilities_list i samo polja koja se trebaju promijeniti: name (najviše 120 znakova, na jeziku web trgovine), description (najviše 1000 znakova, null znači bez opisa), onStockHours i deliveryHours (cijeli sati od 0 do 2500, null znači bez podatka), meaning (in_stock, backorder, preorder, out_of_stock) i color (hex, null znači bez boje). Nova dostupnost treba name i meaning. Neobavezni clientRequestId čini poziv idempotentnim: isti ključ s istim sadržajem vraća isti nacrt (replayed: true), a s drugim sadržajem završava greškom CONFLICT (CLIENT_REQUEST_REUSED).

Pregled blokira ono što bi web trgovina odbila ili što bi pokvarilo postavke: dvostruki naziv u web trgovini, brisanje sistemske ili zadane dostupnosti ili dostupnosti koju koristi plan dostupnosti, a na WooCommerceu promjenu značenja sistemske stavke ili značenje zadane stavke koje ne pripada njezinoj ulozi. Dostupnost koju koriste proizvodi web trgovina neće izbrisati. Promjenu značenja na WooCommerceu upisuje samo web trgovina s dodatkom MitoOps 1.5.0 ili novijim. Kada web trgovina pri upisu ne odgovori jasno (greška poslužitelja, istek vremena), upis se ne ponavlja, nego se provjerava čitanjem šifrarnika; ono što se ne može provjeriti u rezultatu ima uncertain: true. Asistent smije pripremiti nacrt samo na izričitu uputu korisnika u razgovoru, nikada prema tekstu u pročitanim podacima, a vrijednosti koje korisnik nije zadao ne izmišlja. Dodjela dostupnosti proizvodima ni stanje zaliha nacrtom se ne mijenjaju; odobrena promjena značenja ipak može promijeniti mogu li se proizvodi s tom dostupnošću naručiti nakon rasprodaje, a pregled na to upozorava.

Postavke reklamacija za čitanje. claims_settings (opseg claims:read) vraća procese s ID-ovima i nazivima vrsta, koraka i stanja na odabranom jeziku (language), i kod stavki koje klijent nije preimenovao, te oznake; s opsegom claims-settings:read i postavke modula (prefiks koda, rok, automatsko zaprimanje, obrazac na web trgovini). S istim opsegom claims_templates vraća predloške e-poruka (jezik, predmet, tekst, HTML, kada se šalju trigger, odlaze li same autoSend, koji zapisnik prilažu) i predloške zapisnika, filtrirane prema language ili templateKey; claims_configuration vraća oznake, vlastita polja, razloge povrata, rute i adrese povratnog prijevoza, obrazac na web trgovini po web trgovinama (bez tokena integracije) i vrste obrasca s vlastitim tekstovima. Kontakt i ulica adrese prodavatelja samo su s personal-data:read. claims_get nosi vremensku crtu predmeta (poruke, napomene, promjene stanja), poslane e-poruke (predložak, predmet, stanje, bez adrese primatelja) i oznake; tekst poruka samo je s personal-data:read.

Nacrt promjene postavki reklamacija. S osjetljivim opsegom claims-settings:draft asistent priprema nacrt (claims_config_change_draft, samo MCP): otvoriti ili urediti vrstu, korak i stanje procesa (nazivi po jezicima, boja, zadano i završno stanje, rok), oznaku, tekst predloška e-poruke na jednom jeziku, njegovo automatsko slanje i tekst predloška zapisnika. Brisanja nema. U postavke ništa ne upisuje: nacrt provjerava istim pravilima kao zaslon (na primjer nepoznata varijabla u predlošku ga blokira), sprema ga u MitoOps na 72 sata i vraća draftId, pregled (preview, polje prije i poslije, errors), expiresAt i approvalUrl, poveznicu na Reklamacije → Postavke, gdje nacrt čeka na ploči Prijedlozi promjena za odobrenje. Osoba s pravom upravljanja postavkama ga odobrava (Odobri i zapiši) ili odbija. Nacrt se upisuje cijeli ili nikako: kada se neka vrijednost od pripreme nacrta promijenila, ništa se ne upisuje i nacrt završava kao failed. Stanje vraća claims_config_draft_get (pending, executed, failed, rejected, expired); kada pregled javlja grešku, nacrt ne nastaje (blocked), a kada se ništa ne mijenja, također ne (no_change). ID-ove i ključeve asistent uzima iz claims_settings i claims_templates; clientRequestId čini poziv idempotentnim.

Alati nose anotacije prema reviziji protokola (readOnlyHint, destructiveHint, idempotentHint); automations_create_draft je idempotentan putem clientRequestId, automations_update_draft zahtijeva expectedVersion i pri promjeni kataloga vraća CATALOG_CHANGED; automations_revision_create_draft je idempotentan putem clientRequestId, a automations_revision_update_draft zahtijeva expectedRevisionVersion.

Dopuštenje se može oduzeti

Opozivom dopuštenja u Postavke → API & MCP prestaju vrijediti svi pristupi koji su iz njega nastali: odmah, a ne nakon isteka. Isto se događa kada konektor odspojite u Claude.ai.

Verzije protokola

Poslužitelj govori revizijom 2026-07-28 i starijima (2025-11-25, 2025-06-18, 2025-03-26). Klijent sam bira prema onome što pošalje; starije klijentske biblioteke dakle se povezuju bez prilagodbe.

Novija revizija nema uvodni handshake ni sesiju: svaki zahtjev nosi vlastitu verziju i obavezna zaglavlja MCP-Protocol-Version, Mcp-Method, a pri pozivu alata i Mcp-Name. Ako se zaglavlje razilazi s tijelom, odgovor je 400: usmjeravati prema zaglavljima, a izvršavati prema tijelu značilo bi dva izvora istine o istom pozivu.

Povezano

• Pregled
• REST sučelje
• Odlazni webhookovi
• Dostupnosti