Vmesnik MCP

Na kratko

MitoOps ponuja standardni oddaljeni strežnik MCP (Model Context Protocol) na naslovu /api/mcp, prek katerega si združljiva aplikacija AI podatke pridobi sama. Temelji na istih zmožnostih kot REST: ni drugi vmesnik z lastnimi poizvedbami, temveč drug način, kako vprašati isto.

MCP ni lastnost modela, temveč aplikacije, v kateri model teče (odjemalca). Poveže se lahko vsaka aplikacija, ki podpira oddaljeni MCP prek HTTP z OAuth ali z dostopnim ključem. Claude.ai je v produkciji preverjen odjemalec: njegov natančen postopek je spodaj, za drugo aplikacijo velja splošni postopek v naslednjem razdelku. Odjemalcev, ki jih nismo preizkusili, ne razglašamo za preverjene.

Identificirate se lahko na dva načina:

• z dostopnim ključem, ki ga izdate v aplikaciji: za lasten program ali za strežnik, ki kliče strežnik;
• prek OAuth, ko se poveže aplikacija AI, ki to podpira: takrat se prijavite vi in na zaslonu soglasja aplikaciji izberete, kaj sme brati.

V obeh primerih žeton potuje v glavi Authorization: Bearer in v obeh velja isti obseg pravic: česar ključ ali soglasje ne zajema, tega orodje ne vrne.

Kako povezati Claude.ai: preverjena povezava korak za korakom

Claude.ai se ne povezuje s posameznimi spletnimi trgovinami, temveč z MitoOps, s plastjo, ki podatke vseh vaših trgovin že združuje.

Ne potrebujete nobenega ključa, Client ID ali skrivnosti. Claude.ai vse ugotovi sam iz naslova vmesnika.

1. V Claude.ai odprite Settings (Nastavitve) → Customize → Connectors (pri ekipnem naročniškem paketu ga mora najprej dodati skrbnik v Organization settings → Connectors).
2. Kliknite Add custom connector (Dodaj lasten konektor).
3. V polje Name vpišite MitoOps.
4. V polje URL prilepite naslov vmesnika MCP z zaslona Nastavitve → API & MCP, v obliki https://<vaš naslov>/api/mcp, na primer https://app.mitoops.com/api/mcp.
5. Advanced settings pustite prazne: Claude.ai uporabi lastne gostovane metapodatke odjemalca (OAuth). Kliknite Add.
6. Pri konektorju kliknite Connect (Poveži).
7. Odpre se prijava v MitoOps (tudi z drugim faktorjem, če ga uporabljate). Prijavite se.
8. Prikaže se zaslon soglasja: katera aplikacija, kateri naročnik, kaj sme brati in katerih trgovin se to tiče. Dovoljenja so združena po področjih aplikacije (prodaja, zaloga, odprema, trženje, partnerski program, avtomatizacije). Branje je vnaprej označeno, občutljivi podatki in priprava osnutkov niso; spremembe z neposrednim učinkom (na primer brisanje kuponov ali odobritev pošiljanja) so posamično v strnjenem delu Napredna dovoljenja. Pri vsaki skupini je navedeno, kaj točno vključuje.
9. Preverite obsege. Občutljivi (na primer Poročila, Nabavne cene, Osebni podatki strank, Dobavitelji in nabava, Avtomatizacije: osnutki, Razpoložljivosti: predlogi sprememb in Reklamacije: predlogi sprememb nastavitev) niso obkljukani. Če naj Claude vidi maržo ali osebne podatke, predlaga osnutke in revizije avtomatizacij ali spremembe razpoložljivosti oziroma nastavitev reklamacij, jih obkljukajte zavestno. Predloge in nastavitve reklamacij bere obseg Reklamacije: nastavitve in predloge. Izberite trgovine.
10. Kliknite Dovoli. Claude.ai se vrne na svojo stran in konektor je povezan.
11. V pogovoru kliknite + → Connectors in vklopite konektor MitoOps.

Konektor, povezan pred 2. 9. 2026

Če ste konektor povezali prej, ima Claude.ai v predpomnilniku starejše metapodatke in je na zaslonu soglasja ponujal le štiri osnovne obsege. Konektor odklopite (Disconnect) in ga znova povežite (Connect): ponudijo se vsi obsegi, vključno z občutljivimi in novimi (odprema, analitika, zaloge).

Kar na zaslonu soglasja obkljukate, to velja, in nikoli več, kot smete sami. Kdor v aplikaciji nima pravice do nabavnih cen, je ne more predati naprej. Žeton, ki ga prejme Claude.ai, nosi le dovoljene obsege.

Drug odjemalec MCP ali aplikacija AI prek OAuth

Aplikaciji podate isti naslov /api/mcp in nič več, brez ključa. Naprej gre samodejno:

1. Aplikacija nas vpraša, kam naj pošlje prijavo (metapodatki zaščitenega vira po RFC 9728).
2. Odpre se vaša prijava v MitoOps.
3. Prikaže se zaslon soglasja, kjer izberete obsege in trgovine.
4. Po odobritvi je povezava vzpostavljena in aplikacija vidi orodja.

Aplikacija, ki sama izbira obsege, jih mora navesti v zahtevi: zaslon soglasja ponudi le to, kar je aplikacija zahtevala (in do česar imate pravico). Vmesnik oglašuje vse obsege, vključno z občutljivimi: v izzivu WWW-Authenticate in v scopes_supported. Občutljivi se kljub temu nikoli ne dovolijo sami: na zaslonu soglasja so posebej označeni in niso obkljukani, žeton pa se izda zožen na to, kar ste dovolili (scope v odgovoru z žetonom).

Kako se povežete z dostopnim ključem

Pomočnik ali program potrebuje naslov /api/mcp na vaši domeni in dostopni ključ, ki ima med vmesniki MCP. Natančen naslov izpiše zaslon Nastavitve → API & MCP v razdelku „Kam ga vpisati“. Ključ, izdan le za REST, na MCP ne deluje in obratno.

Orodja

Seznam orodij se ravna po obsegih ključa ali soglasja: pomočnik vidi natanko to, kar mu je bilo dovoljeno, in nič drugega. Orodje zunaj obsega zanj ne obstaja.

Orodje MCP	Obseg	REST	Kaj vrne
account_connection	stores:read	GET /account/connection	Diagnostika te povezave: aplikacija, kdo in kdaj je dovolil dostop, dodeljena in manjkajoča dovoljenja po področjih, trgovine in način zapisa prek AI.
account_entitlements	account:read	GET /account/entitlements	Paket naročnika, funkcije in omejitve s trenutno porabo.
affiliate_articles_create	affiliate:write	—	pisanje: Ustvarjanje lastnega članka pomoči v vseh jezikih hkrati (naslov in besedilo v izbranem jeziku); HTML se očisti.
affiliate_articles_get	affiliate:read	GET /affiliate/articles/:key	En članek pomoči z besedilom (HTML) v vseh ali v enem jeziku; spremenljivke niso vstavljene.
affiliate_articles_list	affiliate:read	GET /affiliate/articles	Članki pomoči partnerskega portala: ključ, privzeti/lastni, vklop, vrstni red, stanje po jezikih.
affiliate_articles_set_state	affiliate:write	—	pisanje: Vklop ali izklop članka pomoči za vse jezike hkrati; privzeti članki se ne izbrišejo, le izklopijo.
affiliate_articles_update	affiliate:write	—	pisanje: Urejanje članka pomoči v enem jeziku (naslov, slug, besedilo; HTML se očisti) ali obnovitev privzetega besedila; vrne neznane spremenljivke.
affiliate_campaigns_create	affiliate:write	—	pisanje: Ustvarjanje kampanje v trgovini: ime, nagrada (nikoli izmišljena), obdobje pripisovanja, razpoložljivost, odobritev konverzij.
affiliate_campaigns_get	affiliate:read	GET /affiliate/campaigns/:campaignId	Ena kampanja partnerskega programa.
affiliate_campaigns_list	affiliate:read	GET /affiliate/campaigns	Kampanje partnerskega programa trgovine z nagrado, razpoložljivostjo in števili.
affiliate_campaigns_update	affiliate:write	—	pisanje: Urejanje kampanje: ime, nagrada, obdobje pripisovanja, razpoložljivost, odobritev, vklop/izklop, opis za partnerje po jezikih.
affiliate_code_requests_decide	affiliate:write	—	pisanje: Obravnava zahteve partnerja za lastno kodo: odobritev kodo takoj ustvari v trgovinah kampanj (zahteva tudi coupons:write), retry ustvarjanje ponovi, zavrnitev zahteva razlog; partner prejme e-poštno sporočilo.
affiliate_code_requests_list	affiliate:read	GET /affiliate/code-requests	Zahteve partnerjev za lastno kodo za popust s stanjem in razlogom; čakajoče najprej.
affiliate_conversions_decide	affiliate:approve	—	pisanje: Odločitev o eni proviziji po id: approve (nova → odobrena), reject (nova → zavrnjena, razlog obvezen), cancel (odobrena → preklicana, razlog obvezen); izplačana provizija se nikoli ne vrača, ista odločitev drugič ne spremeni ničesar; partner prejme e-poštno sporočilo.
affiliate_conversions_get	affiliate:read	GET /affiliate/conversions/:conversionId	Podrobnosti ene konverzije: zneski, provizija, stanje provizije z razlogom, stanje naročila v trgovini, dobropis, izplačilo.
affiliate_conversions_list	affiliate:read	GET /affiliate/conversions	Konverzije partnerskega programa trgovine: osnova provizije in skupni znesek naročila z DDV, provizija, stanje provizije z razlogom, stanje naročila v trgovini, povezava na izplačilo.
affiliate_discount_codes_ensure	coupons:write	—	pisanje: Poskrbi, da ima partner v trgovini kodo za popust: kupon se ustvari prek kanoničnih kuponov (ali se uporabi obstoječi) in dodeli partnerju; opomba v trgovini nastane samodejno.
affiliate_discount_codes_list	affiliate:read	GET /affiliate/discount-codes	Kode za popust partnerjev v trgovini s številom uporab in prometom.
affiliate_documents_draft_create	affiliate:write	—	pisanje: Predlog novega besedila pravnega dokumenta kot osnutek; veljavno besedilo se ne spremeni, objavi ga človek v aplikaciji s primerjavo razlik in revizijsko sledjo.
affiliate_documents_get	affiliate:read	GET /affiliate/documents/:key/content	En pravni dokument programa z besedilom po jezikih (shranjeno besedilo, javno besedilo, različica, zgoščene vrednosti, vir, metapodatki PDF) in odprtimi osnutki.
affiliate_documents_list	affiliate:read	GET /affiliate/documents	Dokumenti programa (pogoji, sporazumi): pravila potrjevanja, podpisana kopija, priloga e-pošte, različice po jezikih, pripravljenost in števila potrditev.
affiliate_documents_update	affiliate:write	—	pisanje: Pravila dokumenta programa (za koga velja, kdaj se potrjuje, način potrditve: seznanitev / elektronski podpis / naložena kopija, priloga e-pošte, vklop); besedilo se naloži v aplikaciji.
affiliate_email_templates_list	affiliate:read	GET /affiliate/email-templates	Predloge e-poštnih sporočil partnerjem po jezikih (zadeva, vklop, z dogodkom tudi besedilo) in samodejne priloge e-poštnega sporočila „Račun potrjen“.
affiliate_email_templates_update	affiliate:write	—	pisanje: Urejanje predloge e-poštnega sporočila partnerjem v enem jeziku (zadeva, besedilo) ali vklop/izklop dogodka.
affiliate_links_generate	affiliate:read	GET /affiliate/links/generate	Sledena partnerska povezava na domačo stran, izdelek ali kategorijo trgovine kampanje; po kliku ohrani pripis partnerju.
affiliate_partners_get	affiliate:read	GET /affiliate/partners/:partnerId	En partner programa s kampanjami, ki so mu na voljo.
affiliate_partners_list	affiliate:read	GET /affiliate/partners	Partnerji programa s stanjem, uspešnostjo in provizijami; kontakti le z osebnimi podatki.
affiliate_partners_set_market	affiliate:write	—	pisanje: Članstvo partnerja v trgovini: omogoči (active, odobri tudi zahtevo s portala) ali odvzemi; kampanje, kuponi in dokumenti trgovine veljajo za partnerja le ob aktivnem članstvu.
affiliate_partners_set_state	affiliate:write	—	pisanje: Odločitev o računu partnerja (odobri, zavrni, začasno ustavi, vrni med čakajoče); odobritev pošlje e-poštno sporočilo s sporazumom.
affiliate_payouts_list	affiliate:read	GET /affiliate/payouts	Izplačila provizij partnerjem s stanjem; brez bančnih in obračunskih podatkov.
affiliate_portal_get	affiliate:read	GET /affiliate/portal	Javni partnerski portal: naslovi po trgovinah, odprtost registracije z razlogom, lastne domene, kontaktna oseba, videz in stanje besedil po jezikih.
affiliate_portal_pages_update	affiliate:write	—	pisanje: Lastna besedila javnega portala v enem jeziku (strani prijava/registracija/pregled, obvestilo o zasebnosti, opis programa); HTML se očisti.
affiliate_settings	affiliate:read	GET /affiliate/settings	Nastavitve partnerskega programa: provizije, kliki, najnižje izplačilo, napotitve.
affiliate_settings_update	affiliate:write	—	pisanje: Nefinančne nastavitve programa: ime, registracija, samodejna odobritev, kontaktna oseba, barve, povezava na pravilnik o zasebnosti.
affiliate_signatures_get	affiliate:read	GET /affiliate/signatures/:signatureId	En elektronski podpis s podpisanim besedilom in posnetkom vrednosti; nespremenljiv zapis, PDF se ustvari v aplikaciji.
affiliate_signatures_list	affiliate:read	GET /affiliate/signatures	Elektronsko podpisani dokumenti partnerjev (kdo, dokument, različica, jezik, trgovina, čas, način, preverjanje, zgoščene vrednosti, stanje) in partnerji, ki jim podpis manjka; samo branje, podpis nastane izključno na portalu.
affiliate_statistics	affiliate:read	GET /affiliate/statistics	Statistika partnerskega programa: potek po dnevih, viri pripisa, lestvica partnerjev.
affiliate_summary	affiliate:read	GET /affiliate/summary	Pregled partnerskega programa trgovine za obdobje: kliki, konverzije, provizije, partnerji.
affiliate_variables_list	affiliate:read	GET /affiliate/variables	Register spremenljivk vsebine in e-pošte partnerskega programa: kanonična imena, vzdevki, tip, površine, primer; neobvezno preverjanje besedila glede neznanih spremenljivk.
analytics_advertising	reports:read	GET /analytics/advertising	Oglaševanje: stroški, proračun, ROAS, PNO, CPA, povprečno naročilo in MER s primerjavo; Google Ads in Meta Ads, kliki iz GA4, 6 mesecev.
analytics_channels	analytics:read	GET /analytics/channels	Kanali obiska, vključno s ChatGPT in drugimi viri AI.
analytics_comparison	reports:read	GET /analytics/comparison	Promet s primerjavo: promet, naročila, AOV, obiski, CR in AI/LLM glede na prejšnje obdobje ali leto.
analytics_monthly	reports:read	GET /analytics/monthly	Promet, naročila in obiski po mesecih (največ 24), na primer leto na leto.
analytics_order_coverage	analytics:read	GET /analytics/order-coverage	Pokritost naročil z merjenjem.
analytics_order_heatmap	reports:read	GET /analytics/order-heatmap	Kdaj prihajajo naročila: dan v tednu × ura, najmočnejši dan in ura.
analytics_overview	analytics:read	GET /analytics/overview	Obiski, naročila, promet, stopnja konverzije, AOV, delež virov AI.
analytics_revenue_sources	reports:read	GET /analytics/revenue-sources	Od kod je prišel promet: kanali, seštevki AI/LLM, MitoOps in Affiliate, pridobivanje po GA4.
analytics_seo	analytics:read	GET /analytics/seo	Search Console po poizvedbah ali straneh.
automations_catalog	automations:read	GET /automations/catalog	Katalog avtomatizacij: sprožilci, polja pogojev, operatorji, dejanja, predloge in catalogVersion.
automations_create_draft	automations:write	—	pisanje: Ustvari IZKLOPLJEN osnutek avtomatizacije. Ničesar ne vklopi in ne zažene.
automations_get	automations:read	GET /automations/:workflowId	Ena avtomatizacija z DSL in rezultatom preverjanja.
automations_list	automations:read	GET /automations	Avtomatizacije naročnika s stanjem in obsegom trgovin.
automations_options	automations:read	GET /automations/options	Šifrant za polje avtomatizacije (stanja, načini dostave, plačila, predloge, reklamacije…): vrednost za DSL in ime.
automations_revision_create_draft	automations:write	—	pisanje: Predlaga spremembo objavljene avtomatizacije kot revizijo, ki jo odobri človek; delujoča različica se ne spremeni.
automations_revision_discard_draft	automations:write	—	pisanje: Umakne odprto revizijo objavljene avtomatizacije.
automations_revision_update_draft	automations:write	—	pisanje: Uredi odprto revizijo objavljene avtomatizacije.
automations_runs	automations:read	GET /automations/:workflowId/runs	Zgodovina zagonov ene avtomatizacije.
automations_templates	automations:read	GET /automations/templates	Pripravljeni vzorci avtomatizacij z DSL.
automations_update_draft	automations:write	—	pisanje: Uredi neobjavljen osnutek avtomatizacije z optimističnim nadzorom sočasnosti.
automations_validate_draft	automations:read	—	Preveri osnutek avtomatizacije brez zapisa.
chatbot_conversations_get	chatbot-conversations:read	GET /chatbot/conversations/:sessionId	Prepis enega pogovora s spletnim klepetalnikom, vključno z viri odgovorov bota.
chatbot_conversations_list	chatbot-conversations:read	GET /chatbot/conversations	Pogovori kupcev s spletnim klepetalnikom od nazadnje aktivnega, s prvim vprašanjem; kazalec.
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 spletnega klepetalnika za obdobje: lijak oblačka iz enega samega merjenja (starejša števila so priložena kot zgodovinska), stopnja odpiranja klepeta, pogovori, izid na ravni pogovora, ocene.
chatbot_topics	chatbot:read	GET /chatbot/topics	O čem so bili pogovori: deleži tem iz zaprte taksonomije, stopnja rešenosti in kandidati za vrzel v znanju po temi, najpogostejši izdelki, vrsta začetne strani in potek po dnevih. Deleži se izračunajo iz analiziranih pogovorov, vrne se tudi njihovo število. Le seštevki.
claims_config_change_draft	claims-settings:draft	—	pisanje: Predlaga spremembo procesov, stanj, oznak, predlog, besedil obrazca in nastavitev modula reklamacij; zapiše jo šele človek z odobritvijo v aplikaciji.
claims_config_draft_get	claims-settings:read	GET /claims/config-drafts/:draftId	Stanje predloga spremembe nastavitev reklamacij (čaka, zapisan, zavrnjen).
claims_configuration	claims-settings:read	GET /claims/configuration	Nastavitve reklamacij: oznake, polja, vračilna dostava, obrazec v trgovini in vrste obrazca.
claims_get	claims:read	GET /claims/:code	Ena reklamacija s postavkami, vračili kupnine, povratnimi pošiljkami, oznakami, časovnico in poslanimi e-poštnimi sporočili.
claims_list	claims:read	GET /claims	Reklamacije in vračila ene trgovine s povezavami na naročilo.
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	Vračila pri reklamacijah: način, bančni računi z ustreznostjo za plačilni nalog (zakriti), privzeti in ročni račun.
claims_routes	claims-settings:read	GET /claims/routes	Povratni prevoz reklamacij: poti, naslovi, profili prevoznikov z ID-ji in podporo vračila, vrste primerov.
claims_routes_change_draft	claims-routes:draft	—	pisanje: Predlaga povratno pot (tudi za celo EU ali svet) in naslov prejemnika; zapiše ju človek z odobritvijo (ali avtonomni zapis, če ga je stranka vklopila).
claims_settings	claims:read	GET /claims/settings	Procesi reklamacij z ID-ji in imeni (vrste, koraki, stanja, roki), oznake; nastavitve modula z obsegom claims-settings:read.
claims_statistics	claims:read	GET /claims/statistics	Statistika reklamacij in vračil za obdobje: števila, časi rešitve, vrste, ocene, razlogi.
claims_templates	claims-settings:read	GET /claims/templates	Predloge e-poštnih sporočil reklamacij (zadeva, besedilo, kdaj in ali se pošiljajo samodejno) in predloge zapisnikov.
content_articles_search	products:read	GET /content/articles	Članki bloga in vsebina trgovine iz kanoničnega zrcala po naslovu ali besedilu.
coupons_activation_link	coupons:read	GET /coupons/activation-link	Povezava, ki kupcu uveljavi OBSTOJEČI kupon v košarici. Kuponov ne ustvarja.
coupons_activation_status	coupons:read	GET /coupons/activation-status	Ali je kupon v trgovini mogoče uporabiti prek aktivacijske povezave: zrcalo kupona + stanje kode na spletu.
coupons_capabilities	coupons:read	GET /coupons/capabilities	Kaj platforma trgovine zmore s kuponi. Preberite pred ustvarjanjem.
coupons_ensure	coupons:write	—	pisanje: Poskrbi, da kupon v izbranih trgovinah obstaja. Pri drugačnem popustu se NE prepiše.
coupons_get	coupons:read	GET /coupons/:code	En kupon po kodi.
coupons_list	coupons:read	GET /coupons	Kuponi za popust trgovine z vrsto in višino popusta, veljavnostjo in izpeljanim stanjem.
coupons_remove	coupons:delete	—	pisanje: Nepovratni izbris kupona v izbrani trgovini: brez potrditve le predogled z odvisnostmi, s potrditvijo izbris; kupon z živo odvisnostjo se ne izbriše.
coupons_update	coupons:write	—	pisanje: Izrecna posodobitev obstoječega kupona, vključno z omejitvami na izdelke in kategorije; predogled, nato potrditev.
customers_get	customers:read	GET /customers/:customerKey	En kupec iz imenika: identiteta, trgovine, zneski za celotno obdobje sodelovanja in neobvezno za izbrano obdobje, razčlenjeno po trgovinah.
customers_list	customers:read	GET /customers	Imenik kupcev: identiteta (z maskiranjem osebnih podatkov), trgovine, jezik, števila in promet za celotno obdobje sodelovanja po valutah; neobvezen filter nakupne aktivnosti v obdobju.
customers_performance	reports:read	GET /customers/performance	Kupci kot psevdonimi: naročila, promet, LTV, novi in ponovni.
credit_notes_search	invoices:read	GET /credit-notes	Iskanje v dobropisih.
documents_list	invoices:read	GET /documents	Računovodske listine ene vrste (računi, predračuni, dobropisi) po straneh z življenjskim ciklom, stanjem v viru, filtrom veljavnosti in razpoložljivostjo PDF.
documents_pdf_link	invoices:read	—	Kratkotrajna povezava (10 minut) do PDF računa, predračuna ali dobropisa za odpiranje v brskalniku.
invoices_get	invoices:read	GET /invoices/:invoiceCode	En račun s postavkami dokumenta, dobropisi, avansnimi računi in številko naročila.
invoices_search	invoices:read	GET /invoices	Iskanje v računih.
inventory_movements	inventory:read	GET /inventory/movements	Zgodovina premikov zaloge: kdaj, kaj, koliko, vrsta, izvor, naročilo.
inventory_product_availability	inventory:read	GET /inventory/availability	Stanje zaloge več postavk hkrati.
inventory_stock	inventory:read	GET /inventory/stock	Stanje zaloge ene postavke, vključno z virom vrednosti.
orders_get	orders:read	GET /orders/:orderCode	Eno shranjeno naročilo, vključno s postavkami.
orders_list	orders:read	GET /orders	Shranjena naročila ene trgovine, od najnovejšega.
availabilities_change_draft	availabilities:draft	—	pisanje: PREDLOG spremembe šifranta razpoložljivosti (ustvari, uredi, izbriši). V trgovino ga zapiše človek z odobritvijo v MitoOps.
availabilities_draft_get	products:read	GET /availabilities/drafts/:draftId	Stanje predloga spremembe šifranta razpoložljivosti: čaka na odobritev, zapisan z rezultatom, zavrnjen, potekel.
availabilities_list	products:read	GET /availabilities	Šifrant razpoložljivosti trgovine: ime, opis, čas do zaloge in čas dostave, pomen za Google, barva, privzeta vloga.
categories_content_change_draft	category-content:draft	—	pisanje: PREDLOG novih besedil kategorij (največ 30 hkrati); v spletno trgovino jih zapiše šele človek z odobritvijo v MitoOps.
categories_content_draft_get	category-content:read	GET /catalog/category-content-drafts/:draftId	Stanje predloga besedil kategorij: čaka na odobritev, zapisan, zavrnjen, potekel.
categories_content_get	category-content:read	GET /categories/:guid/content	Besedila kategorije (zgornji in spodnji opis, SEO naslov in opis) s prstnim odtisom in zapisljivostjo.
categories_list	products:read	GET /categories	Kategorije trgovine s številom izdelkov.
products_content_change_draft	product-content:draft	—	pisanje: PREDLOG novih besedil izdelkov (največ 30 hkrati); v spletno trgovino jih zapiše šele človek z odobritvijo v MitoOps.
products_content_draft_get	product-content:read	GET /catalog/product-content-drafts/:draftId	Stanje predloga besedil izdelkov: čaka na odobritev, zapisan z opozorili spletne trgovine, zavrnjen, potekel.
products_content_get	product-content:read	GET /products/:code/content	Besedila izdelka iz spletne trgovine (opis, kratek opis, SEO naslov in opis) s prstnim odtisom in zapisljivostjo.
products_content_policy	product-content:read	GET /product-content/policy	Pravila vsebine spletne trgovine brez klica spletne trgovine: kaj sme ta dostop brati in predlagati, katera polja platforma zapiše, način odobritve in samodejni zapis, omejitve in prstni odtisi.
products_get	products:read	GET /products/:code	En izdelek po kodi, vključno z uvrstitvijo v kategorijo in ceno s kartice izdelka.
products_search	products:read	GET /products	Iskanje izdelkov po imenu, kodi, EAN ali PLU.
reports_financial_summary	reports:read	GET /reports/financial-summary	Finančni povzetek obdobja; s purchase-prices:read tudi nabavna vrednost blaga, bruto dobiček in marža.
sales_order_performance	reports:read	GET /sales/order-performance	Promet po naročilih s seštevki za celotno obdobje; s purchase-prices:read tudi nabavna vrednost, dobiček in marža.
sales_product_performance	reports:read	GET /sales/product-performance	Prodaja po izdelkih s seštevki za celotno obdobje.
search_console_query	search-console:read	GET /search-console/query	Search Console po dnevih, poizvedbah, straneh, državah in napravah, z ostranjevanjem in zgoščeno vrednostjo vsebine.
search_console_status	search-console:read	GET /search-console/status	Stanje Search Console trgovine: povezava, lastnost, dovoljenje, sinhronizacija in obseg arhiva.
shipping_carriers	shipping:read	GET /shipping/carriers	Povezani prevozniki in profili, brez dostopnih podatkov.
shipping_shipment_detail	shipping:read	GET /shipping/shipments/:shipmentId	Ena pošiljka z vsemi dogodki sledenja.
shipping_shipments	shipping:read	GET /shipping/shipments	Pošiljke s prevoznikom, državo, časom predaje in dostave, po straneh.
shipping_stats	shipping:read	GET /shipping/stats	Statistika dostave po prevoznikih: števila, uspešnost, mediana in p90 časa dostave, države.
stores_integration_status	stores:read	GET /stores/integration-status	Stanje kode MitoOps na spletu po trgovinah: nameščena, različica, moduli, pripravljenost kupona iz povezave.
stores_list	stores:read	GET /stores	Trgovine naročnika z njihovo kodo.
suppliers_get	purchasing:read	GET /suppliers/:supplierId	En dobavitelj s ponudbami in stroškovnimi komponentami.
suppliers_list	purchasing:read	GET /suppliers	Dobavitelji s ponudbami in stroškovnimi komponentami.
webhooks_deliveries	webhooks:read	GET /webhooks/endpoints/:endpointId/deliveries	Dnevnik dostav enega endpointa brez teles sporočil.
webhooks_endpoint	webhooks:read	GET /webhooks/endpoints/:endpointId	En webhook endpoint s številom čakajočih dostav.
webhooks_endpoints	webhooks:read	GET /webhooks/endpoints	Webhook endpointi naročnika brez skrivnosti in stanje čakalne vrste.
webhooks_events	webhooks:read	GET /webhooks/events	Katalog dogodkov odhodnih webhookov, ovojnica in podpis.

Ime, e-poštni naslov, telefon in ulica kupca so v orders_list, orders_get, claims_list in claims_get le z obsegom personal-data:read; brez njega odgovor vsebuje državo in kraj. Enako velja za kontakte dobaviteljev in partnerjev programa (affiliate_partners_*). Obseg nima lastnega orodja.

V imeniku kupcev (customers_list, customers_get) isti obseg odloča o imenu, podjetju, e-poštnem naslovu, telefonu in trženjskem spolu; brez njega ostanejo psevdonim, trgovine, država, jezik, števila in datumi. Promet in LTV sta poleg tega za obsegom reports:read. Trženjski spol je ocena na podlagi osebnega imena (genderSource: "name_inference"), ne podatek, ki bi ga navedel kupec, in tako naj ga pomočnik tudi predstavi. Bančni in davčni podatki partnerjev se ne izdajo nikoli.

Spletni klepetalnik: teme pogovorov. chatbot_topics (isti obseg chatbot:read) z enim klicem odgovori na vprašanje „o čem so bili pogovori“: delež pogovorov po temah iz zaprte taksonomije, stopnjo rešenosti in število kandidatov za vrzel v znanju po temi, najpogostejše izdelke (o katerih so kupci spraševali in ki jih je bot priporočil), vrsto strani, s katere se pogovori začnejo, in potek po dnevih. Vrednotenje je deterministično, zato dva klica nad istim obdobjem vrneta enake številke. Vrača le seštevke: besedilo kupca vanj ne pride, niti kot „najpogostejše vprašanje“. Vsak delež je podan skupaj s številom. chatbot_conversations_list ima nova filtra topic in knowledgeGapCandidate; prepis posameznega pogovora ostaja za občutljivim obsegom in le v okviru obdobja hrambe.

Spletni klepetalnik. Statistika (chatbot_stats, obseg chatbot:read) vrača le seštevke: koliko obiskom strani se je prikazal oblaček in koliko jih je nanj kliknilo, odprtja okna, število pogovorov in sporočil, kaj je bot rešil, ocene kupcev in lijak prijave na novičnik. Pogovori kupcev (chatbot_conversations_list, chatbot_conversations_get) so za lastnim občutljivim obsegom chatbot-conversations:read, ki ga na zaslonu soglasja obkljukate zavestno: kupec je v evidenci le naključni ključ pogovora (brez IP, piškotka, imena ali e-poštnega naslova); e-poštni naslov, telefon in IBAN, ki jih je kupec napisal v besedilo, pomočnik dobi le z obsegom personal-data:read, sicer namesto njih vidi oznake [e-mail], [telefón], [iban]. Pogovori se izdajo le v okviru obdobja hrambe trgovine (nastavitev Zgodovina v Središču AI); trgovina, ki ima hrambo nastavljeno na nič, ne izda ničesar. Do 21. 9. 2026 so se prikazi oblačka šteli ob vsakem pojavu sporočila; od 22. 9. 2026 je prikaz en obisk strani, measurementChanges v odgovoru pa pove, ali izbrano obdobje meša obe merjenji.

Vsako orodje ima ustreznico v REST nad isto zmožnostjo. Odgovori se razlikujejo po ovojnici, poslovni podatki so enaki. Obdobje, ostranjevanje in pomen finančnih polj so opisani v vmesniku REST.

Povzetna orodja (shipping_stats, analytics_*, reports_financial_summary) vračajo končne številke iz aplikacije: pomočniku ni treba prenašati tisočev zapisov in jih računati sam. Surovi seznami (shipping_shipments, orders_list) ostajajo za podroben pogled.

Kaj lahko vprašate

Po povezavi Claude.ai odgovarja iz podatkov MitoOps, na primer na vprašanja:

• „Kakšna je bila razdelitev po prevoznikih avgusta?“ (shipping_stats)
• „Kolikšna je bila mediana časa dostave DHL in GLS?“ in „Koliko pošiljk je bilo nedostavljenih ali vrnjenih?“ (shipping_stats)
• „V katere države smo pošiljali prek DHL?“ (shipping_stats, polje countries)
• „Kakšna sta bila promet in stopnja konverzije avgusta?“ (analytics_overview ali reports_financial_summary)
• „Koliko naročil in prometa je prišlo iz ChatGPT?“ (analytics_channels)
• „Katere poizvedbe so imele najvišji CTR?“ (analytics_seo)
• „Kakšna je marža izdelka X v zadnjem mesecu?“ (sales_product_performance s purchase-prices:read)
• „Kaj so kupci ta mesec najpogosteje spraševali klepetalnik in o čem naj bo naslednji članek na blogu?“ (chatbot_conversations_list in chatbot_conversations_get s chatbot-conversations:read)
• „Koliko pogovorov je imel klepetalnik in koliko jih je rešil brez podpore?“ (chatbot_stats)
• „Katere razpoložljivosti ima trgovina SK in katere so privzete?“ (availabilities_list)
• „Dodaj v trgovino SK razpoložljivost Prednaročilo oktober s pomenom prednaročilo in dostavo v 14 dneh“ (availabilities_change_draft z availabilities:draft; nastane predlog, ki ga zapišete z odobritvijo v aplikaciji)
• „Spremeni vklopljeno avtomatizacijo 12 tako, da pošilja obvestilo le pri načinu dostave Kurir“ (automations_options za načine dostave, nato automations_revision_create_draft; delujoča različica se ne spremeni, dokler revizije ne objavite v urejevalniku)
• „Katera e-poštna sporočila reklamacije se pošiljajo samodejno in kaj piše v njih v nemščini?“ (claims_templates s claims-settings:read)
• „Preimenuj stanje reklamacije Čaka na blago v Čakamo na pošiljko“ (claims_settings za ID, nato claims_config_change_draft s claims-settings:draft; zapišete ga z odobritvijo v aplikaciji)

Branje in ozki zapisi: avtomatizacije, kupon, partnerski program, razpoložljivosti, reklamacije

Operativni podatki (naročila, stanje zalog, izdelki, dokumenti, pošiljke) se prek MCP le berejo. Vsak zapis je za lastnim občutljivim obsegom: osnutek avtomatizacije, kupon za popust, upravljanje partnerskega programa, odločitev o proviziji, predlog spremembe šifranta razpoložljivosti, ki ga v trgovino zapiše šele človek, in predlog spremembe nastavitev reklamacij, ki ga prav tako mora odobriti človek.

Osnutek avtomatizacije. Z obsegom automations:write je to izklopljen osnutek: pomočnik lahko po katalogu (automations_catalog) oblikuje pravilo in ga shrani kot osnutek ali uredi osnutek, ki ga še nihče ni objavil. Osnutek se prikaže v Avtomatizacije kot vsako drugo nedokončano delo: vklopite, objavite ali zaženete ga lahko le vi v aplikaciji. Objavljene avtomatizacije pomočnik neposredno ne more spremeniti.

Revizija delujoče avtomatizacije. Z obsegom automations:write lahko pomočnik spremeni tudi objavljeno in vklopljeno avtomatizacijo, vendar le s predlogom: automations_revision_create_draft (vhod workflowId, expectedPublishedVersion iz automations_get, catalogVersion, celoten novi dsl, note in clientRequestId) shrani revizijo poleg delujoče različice. Delujoča avtomatizacija se ne spremeni in deluje naprej. Avtomatizacija ima največ eno odprto revizijo; uredi se z automations_revision_update_draft in expectedRevisionVersion, zavrže pa z automations_revision_discard_draft. Odgovor vsebuje approvalUrl, povezavo v urejevalnik avtomatizacije. Tam človek s pravico urejanja avtomatizacij vidi revizijo v zgornji plošči, jo naloži v urejevalnik (Naloži predlog v urejevalnik), pregleda in objavi z običajnim gumbom; avtomatizacija ostane vklopljena. Lahko jo tudi zavrne. Če je medtem nekdo objavil drugo različico, se revizija zapre (REVISION_STALE) in pripraviti je treba novo. Odprto revizijo in zgodovino vrne automations_get (openRevision, revisions).

Šifranti polj in preverjanje vrednosti. Polja, ki se v urejevalniku izbirajo s seznama (stanje naročila, način dostave, plačilo, profil prevoznika, predloga obvestila, vrsta, stanje, oznaka in predloge reklamacije, webhook endpoint in drugo), imajo v katalogu vir. automations_options s source in market vrne njihove vrednosti [{ value, name }] natanko v obliki, ki jo shrani urejevalnik (ID stanja, GUID načina dostave in plačila, ID stanja reklamacije); brez source izpiše vire in ali se razlikujejo po trgovinah (perShop). Preverjanje (automations_validate_draft) ter shranjevanje osnutka ali revizije zavrneta vrednost, ki v trgovini ne obstaja (FIELD_UNKNOWN_OPTION), in nadomestno besedilo, kot sta DOPLNIT_… ali TODO (FIELD_PLACEHOLDER). Ko seznama ni mogoče preveriti (trgovina ni odgovorila, seznam je okrnjen), se vrne le opozorilo FIELD_OPTIONS_UNVERIFIED. orders_get in orders_list vsebujeta statusId, shippingGuid in paymentGuid, torej iste vrednosti, s katerimi delajo pogoji avtomatizacije.

Obseg automations:write je občutljiv: na zaslonu soglasja ni vnaprej obkljukan, ponudi se le človeku s pravico urejanja avtomatizacij, obstoječe povezave ga ne podedujejo in osvežitev žetona ga ne more razširiti. Naročil, izdelkov, stanja zalog, dokumentov, vračil kupnine, reklamacijskih primerov in pošiljk prek MCP ni mogoče spreminjati; šifrant razpoložljivosti trgovine in nastavitve reklamacij se spreminjajo le s predlogom, ki ga človek odobri v aplikaciji (spodaj). Webhook endpointi se prek MCP le berejo. Dostopnih podatkov za prevoznike, trgovino ali analitiko prek MCP ni mogoče prebrati.

Kupon za popust. Z obsegom coupons:write pomočnik ustvari kupon po parametrih, ki mu jih podate (coupons_ensure, tudi partnerski kupon prek affiliate_discount_codes_ensure), in izrecno posodobi obstoječega (coupons_update, predogled in potrditev); brisanje ima lasten obseg coupons:delete in kupon z živo odvisnostjo se ne izbriše.

Upravljanje partnerskega programa. Z obsegom affiliate:write pomočnik odloči o računu partnerja (affiliate_partners_set_state: odobri, zavrni, začasno ustavi; partner prejme e-poštno sporočilo, glede na pravila dokumentov tudi s PDF sporazuma), obravnava zahtevo za lastno kodo (affiliate_code_requests_decide), uredi nefinančne nastavitve programa (affiliate_settings_update: ime, registracija, kontaktna oseba, barve), besedila portala v enem jeziku (affiliate_portal_pages_update), članke pomoči (affiliate_articles_create, affiliate_articles_update, vključno z obnovitvijo privzetega besedila, affiliate_articles_set_state; brisanja od zunaj ni), predloge e-poštnih sporočil (affiliate_email_templates_update), kampanje (affiliate_campaigns_create, affiliate_campaigns_update), pravila dokumentov (affiliate_documents_update) in članstvo partnerja v trgovini (affiliate_partners_set_market: omogoči ali odvzemi). Besedilo pravnih dokumentov prebere (affiliate_documents_get: besedilo po jezikih, različica, zgoščene vrednosti, osnutki), novo besedilo pa predlaga le kot osnutek (affiliate_documents_draft_create; tudi privacyNotice v affiliate_portal_pages_update je od te različice osnutek): veljavno besedilo objavi človek v aplikaciji s primerjavo razlik in revizijsko sledjo. Register spremenljivk vsebine in e-pošte (kanonična imena, vzdevki, tip, površine) izda affiliate_variables_list; affiliate_email_templates_list vrača imena spremenljivk, ne indeksov. Izplačila, osnova provizije in nalaganje datoteke dokumenta prek MCP ne obstajajo: ostajajo v aplikaciji.

Odločitev o proviziji. Z lastnim občutljivim obsegom affiliate:approve (pravica potrjevanje provizij, ne upravljanje programa) pomočnik najprej prebere čakajoče provizije skupaj s stanjem naročila v trgovini (affiliate_conversions_list s state=new, podrobnosti affiliate_conversions_get: osnova provizije revenue, skupni znesek naročila z DDV revenueTotal, orderState open/completed/cancelled, orderPaid, dobropis), jih povzame in šele na izrecen ukaz uporabnika odloči o eni konkretni konverziji (affiliate_conversions_decide: approve, reject ali cancel; zavrnitev in preklic zahtevata razlog, ki ga partner prejme po e-pošti). Velja isti avtomat stanj kot v aplikaciji: izplačana provizija se nikoli ne vrača, preklicana in zavrnjena sta končni stanji, ista odločitev drugič ne spremeni ničesar (changed: false). Množične odobritve od zunaj ni: sto konverzij pomeni sto klicev, vsak z revizijsko sledjo. Od W-AFF10 vsaka konverzija vsebuje tudi approvalPolicy (način odobritve kampanje, rok, dovoljena stanja naročila, zahteva po plačilu) in approvalEligibility: ali bi jo urna avtomatika zdaj odobrila in zakaj ne (minimum_age_not_reached, order_state_not_allowed, order_not_paid, order_cancelled, fully_refunded, approval_manual…), isti izračun kot v aplikaciji; seznam ima filtre orderPaid, minCommission, orderState in ostranjevanje z offset + hasMore, zato je „preglej nove konverzije zadnjih dveh mesecev, pokaži neplačane ali tiste nad 20 €“ eno ali nekaj branj. Pogoje kampanje nastavi affiliate_campaigns_update (approval, approveAfterDays, requiredOrderStatusIds, paidRequired) z obsegom affiliate:write. Izplačila partnerjem se prek MCP le berejo (affiliate_payouts_list): pomočnik ne more ustvariti paketa izplačil, izdelati dokumenta zanj, ga poslati partnerju ali oddati bančnega naloga; to ostaja v aplikaciji v rokah upravljavca.

Predlog spremembe šifranta razpoložljivosti. Z občutljivim obsegom availabilities:draft pomočnik pripravi predlog, kako v eni trgovini ustvariti, urediti ali izbrisati razpoložljivosti (availabilities_change_draft, le MCP). V trgovino ne zapiše ničesar: predlog preveri, ga shrani v MitoOps za 24 ur in vrne draftId, predogled po postavkah (preview z vsakim poljem pred in po, warnings in errors), expiresAt in approvalUrl, povezavo na zaslon Zaloga → Razpoložljivosti, kjer predlog čaka na zavihku Upravljanje. Tam ga človek z ustreznimi pravicami odobri z gumbom Potrdi in zapiši ali zavrne, zapis pa se izvede z njegovimi pravicami v trenutku klika. Če se je šifrant trgovine od priprave predloga spremenil, odobritev ne zapiše ničesar in predlog se konča kot failed. Stanje in rezultat po postavkah vrne availabilities_draft_get: pending, writing, executed, partial, failed, rejected ali expired. Ko predogled javi blokirajočo napako, predlog ne nastane (blocked), in prav tako ne, ko se nič ne bi spremenilo (no_change).

Vhod sta market in changes (največ 30 postavk). Vsaka sprememba ima action (create, update ali remove), pri urejanju ali brisanju id iz availabilities_list ter le polja, ki naj se spremenijo: name (največ 120 znakov, v jeziku trgovine), description (največ 1000 znakov, null pomeni brez opisa), onStockHours in deliveryHours (cele ure od 0 do 2500, null pomeni brez podatka), meaning (in_stock, backorder, preorder, out_of_stock) in color (hex, null pomeni brez barve). Nova razpoložljivost potrebuje name in meaning. Neobvezni clientRequestId naredi klic idempotenten: isti ključ z isto vsebino vrne isti predlog (replayed: true), z drugačno vsebino pa se konča z napako CONFLICT (CLIENT_REQUEST_REUSED).

Predogled blokira, kar bi trgovina zavrnila ali kar bi pokvarilo nastavitev: podvojeno ime v trgovini, izbris sistemske ali privzete razpoložljivosti ali razpoložljivosti, ki jo uporablja načrt razpoložljivosti, ter v WooCommerce spremembo pomena sistemske postavke ali takšen pomen privzete postavke, ki ne sodi k njeni vlogi. Razpoložljivosti, ki jo uporabljajo izdelki, trgovina ne izbriše. Spremembo pomena v WooCommerce zapiše le trgovina z vtičnikom MitoOps 1.5.0 ali novejšim. Ko trgovina pri zapisu ne odgovori jasno (napaka strežnika, časovna omejitev), se zapis ne ponovi, temveč se preveri z branjem šifranta; kar ni mogoče preveriti, ima v rezultatu uncertain: true. Pomočnik sme predlog pripraviti le na izrecen ukaz uporabnika v pogovoru, nikoli zaradi besedila v prebranih podatkih, in si ne izmišlja vrednosti, ki jih uporabnik ni podal. Predlog ne spremeni, katero razpoložljivost imajo izdelki, niti stanja zalog; odobrena sprememba pomena pa lahko spremeni, ali je izdelke s to razpoložljivostjo mogoče naročiti, ko so razprodani, in predogled na to opozori.

Nastavitve reklamacij za branje. claims_settings (obseg claims:read) vrne procese z ID-ji in imeni vrst, korakov in stanj v izbranem jeziku (language), tudi pri postavkah, ki jih naročnik ni preimenoval, ter oznake; z obsegom claims-settings:read tudi nastavitve modula (predpona kode, rok, samodejni vnos na zalogo, obrazec v trgovini). Z istim obsegom claims_templates vrne predloge e-poštnih sporočil (jezik, zadeva, besedilo, HTML, kdaj se pošiljajo trigger, ali odhajajo samodejno autoSend, kateri zapisnik priložijo) in predloge zapisnikov, filtrirane po language ali templateKey; claims_configuration vrne oznake, lastna polja, razloge za vračilo, poti in naslove vračilne dostave, obrazec v trgovini po trgovinah (brez integracijskega žetona) in vrste obrazca z lastnimi besedili. Kontakt in ulica naslova prodajalca sta na voljo le s personal-data:read. claims_get vsebuje časovnico primera (sporočila, opombe, spremembe stanja), poslana e-poštna sporočila (predloga, zadeva, stanje, brez naslova prejemnika) in oznake; besedilo sporočil le s personal-data:read.

Predlog spremembe nastavitev reklamacij. Z občutljivim obsegom claims-settings:draft pomočnik pripravi predlog (claims_config_change_draft, le MCP): ustvariti ali urediti vrsto, korak in stanje procesa (imena po jezikih, barva, privzeto in zaključno stanje, rok), oznako, besedilo e-poštne predloge v enem jeziku, njeno samodejno pošiljanje in besedilo predloge zapisnika. Brisanja ni. V nastavitve ne zapiše ničesar: predlog preveri z enakimi pravili kot zaslon (neznana spremenljivka v predlogi ga na primer blokira), ga shrani v MitoOps za 72 ur in vrne draftId, predogled (preview, polje pred in po, errors), expiresAt in approvalUrl, povezavo na Reklamacije → Nastavitve, kjer predlog čaka v plošči Predlogi sprememb za odobritev. Človek s pravico upravljanja nastavitev ga odobri (Odobri in zapiši) ali zavrne. Predlog se zapiše v celoti ali sploh ne: če se je katera koli vrednost od priprave predloga spremenila, se ne zapiše nič in predlog se konča kot failed. Stanje vrne claims_config_draft_get (pending, executed, failed, rejected, expired); ko predogled javi napako, predlog ne nastane (blocked), in prav tako ne, ko se nič ne spremeni (no_change). ID-je in ključe pomočnik vzame iz claims_settings in claims_templates; clientRequestId naredi klic idempotenten.

Orodja nosijo anotacije v skladu z revizijo protokola (readOnlyHint, destructiveHint, idempotentHint); automations_create_draft je idempotenten prek clientRequestId, automations_update_draft zahteva expectedVersion in ob spremembi kataloga vrne CATALOG_CHANGED; automations_revision_create_draft je idempotenten prek clientRequestId, automations_revision_update_draft pa zahteva expectedRevisionVersion.

Soglasje je mogoče preklicati

S preklicem soglasja v Nastavitve → API & MCP prenehajo veljati vsi dostopi, ki so nastali iz njega: takoj, ne šele ob poteku. Enako se zgodi, ko konektor odklopite v Claude.ai.

Različice protokola

Strežnik podpira revizijo 2026-07-28 in tudi starejše (2025-11-25, 2025-06-18, 2025-03-26). Odjemalec izbere sam glede na to, kar pošlje, zato se starejše odjemalske knjižnice povežejo brez sprememb.

Novejša revizija nima uvodnega rokovanja (handshake) in seje: vsaka zahteva nosi svojo različico in obvezne glave MCP-Protocol-Version, Mcp-Method ter pri klicu orodja Mcp-Name. Če se glava ne ujema s telesom, je odgovor 400: usmerjanje po glavah ob izvajanju po telesu bi pomenilo dva vira resnice o istem klicu.

Povezano

• Pregled
• Vmesnik REST
• Odhodni webhooki
• Razpoložljivosti