Mis on ERP MCP server?

Server, mis muudab süsteemi tööriistadeks

Model Context Protocolil on kolm rolli. Host on AI rakendus, nagu Claude või ChatGPT. Hostis luuakse iga serveri jaoks klient ja räägib ainult selle serveriga. Server on teenus, mis pakub hostile konteksti ja võimeid väikese arvu primitiivide kaudu. Spetsifikatsiooni disainipõhimõtted ütlevad, et serverid peaksid olema kergesti ehitatavad, komposiitavad ja mitte suutma näha kogu vestlust või teisi servereid; host hoiab vestlust ja jõustab nõusolekut, server näeb ainult sellele adresseeritud kõnesid.

Seega ei ole ERP MCP server ERP. See on ERP tegevuspind, väljendatud tööriistadena, millel on tüpiseeritud sisendid, serveerituna ühel URL-il. Huvi pakkuv disainilahendus on see, mis on tööriist. Ilmaennustusserveril on üks; ärisüsteemil on sadu, ja kasulikud on tegevused, mida inimene võiks teha (luua arve, registreerida makse, liikuda tehingus, reserveerida kaupa) pigem kui read tabelites. Näiteks Sois'i tööruumi server avaldab tööriistu nimedega nagu looArve, registreeri makse, searchContacts ja uurigeKontaktigruppeeritud mooduli järgi ning täpne nimekiri, mille kõneleja saab, sõltub temast.

Tööriistad, ressursid ja juhised

Spetsifikatsioon määratleb kolm serveri primitiivi, ja need erinevad selle poolest, kes kontrollib nende kasutamist. Tööriistad on mudeli kontrolli all: mudel otsustab, millal ühte kutsuda. Ressursid on rakenduse juhitud: host otsustab, millise konteksti lisada, sageli kasutaja valides nimekirjast. Kutsed on kasutaja kontrolli all olevad mallid. ERP vajab esimest, võib kasu saada teisest ja harva vajab kolmandat.

Kaks tööriista tulemuste omadust on äri süsteemi jaoks oluline. Tööriist võib kuulutada outputSchema ja tagasta structuredContent mis sellele vastab, koos tekstiga, mida mudel loeb, nii et integratsioon saab tulemust kasutada ilma proosa tõlgendamiseta. Ja tööriist, mis ebaõnnestub äri põhjusel (vale olekuga arve, mineviku kuupäev, puuduv luba), tagastab normaalse tulemuse koos isError: true ja selgitus, mitte protokolli viga, et mudel saaks oma sisendi parandada ja uuesti proovida. Protokolli vead on reserveeritud valesti vormistatud päringutele ja tundmatutele tööriistadele.

Transport ja praegune spetsifikatsioon

Kaks transporti on standardne. Stdio on server, mille klient käivitab kohaliku protsessina, mis on see, kuidas töölauatööriistad, näiteks failide juurdepääs, töötavad. Voogedastatav HTTP on kaugserverite jaoks ja seda kasutab ERP: server eksponeerib ühe lõpp-punkti, mis aktsepteerib iga JSON-RPC sõnumi jaoks HTTP POST-i ja vastab kas JSON-objektiga või Server-Sent Events voogudega, mis on seotud selle päringuga, nii et pikk kõne saab edastada edenemist enne lõplikku tulemust. Varasem HTTP SSE transpordiga on aegunud.

The current revision, 2026-07-28, changed the transport in a way that matters for anyone deploying a server behind a load balancer. It removed protocol-level sessions: there is no longer an initialize handshake or a session identifier header, every request carries its protocol version and client capabilities in its own metadata, and a server that needs state across calls returns an explicit handle the model passes back as an argument. Servers written against the 2025-11-25 revision, which did use sessions, keep working because clients are required to detect the older era and fall back; a new server should not adopt sessions.

Autoriseerimine: kellele kõne on suunatud

HTTP transportide jaoks määratleb spetsifikatsioon OAuth 2.1 voogu. Server on ressursiserver ja peab avaldama kaitstud ressursi metaandmed (RFC 9728), nimetades oma autoriseerimisse serveri; kui päring saabub ilma tokenita, vastab see 401-ga koos WWW-Authenticate päisega, mis osutab sellele metaandmele ja, ideaalis, kõige väiksemale vajalikule ulatusele. Klient avastab autoriseerimisse serveri lõpp-punktid, tuvastab end (klient ID metaandmed on soovitatav tee; dünaamiline registreerimine säilib ühilduvuse tagamiseks), käivitab autoriseerimiskoodi voogu koos PKCE-ga ja peab sisaldama serveri kanonilist URI-d ressursi parameetrina, et token oleks seotud ainult selle serveriga. Server peab valideerima selle sihtrühma, peab keelduma tokenitest, mis on välja antud millegi muu jaoks, ja ei tohi kunagi edastada tokenit teisele teenusele.

ERP-i jaoks on tagajärg oluline. Kuna token tuvastab isiku, võib server tulemuse varieerida tööriistade loend päringus esitatud volituste ja spetsifikatsioonis on see selgelt öeldud. See on mehhanism rollipõhiseks filtreerimiseks: finantskasutaja nimekiri ja lao kasutaja nimekiri pärinevad samast serverist ja on erinevad. Ebapiisav ulatus tööajal signaalitakse 403-ga ja ulatusväljakutsega, millelt klient saab edasi liikuda, kuigi enamikus ärisüsteemides on tegelik piir ERP-s roll, mitte jäme OAuth ulatus.

Raske osa: õigused ja tehingud

Kõik ülaltoodud saab rakendada pärastlõunaga SDK abil. ERP MCP serveri ja demo vahe on selles, kuidas käsitletakse kahte asja, mille protokoll jätab serveri otsustada: kas kõne on lubatud ja mida kõne tähendab.

Luba tuleb kontrollida kaks korda. Tööriistade nimekirja filtreerimine takistab mudelil valida midagi, mida ta ei peaks, mis säästab tokeneid ja segadust. Kontrollimine uuesti, kui tööriist töötab, on tegelik piir, kuna klient võib saata mis tahes soovitud kõne. Keeldumine on parim tagastada tööriista täitmise veana, nii et mudel loeb ja teatab sellest, mitte kui transpordiveana, mis lõpetab käigu. Nii näeb välja keeldunud kõne Sois tööruumist: normaalne tulemus, märgitud, koos põhjusega.

{
  "jsonrpc": "2.0",
  "id": 7,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Tool not permitted for this account: approveInvoice requires the finance approver role."
      }
    ],
    "isError": true
  }
}

Luba keeldumine tagastati tööriista täitmise veana. Mudel õpib, miks ja võib paluda inimesel selle heaks kiita; midagi ei kirjutatud. Sois reserveerib ka JSON-RPC veakoodid volitamata sessioonide, ebapiisavate krediitide, lubamatute tööriistade ja eelarvepiirangute saavutamise jaoks.

Tehingud on teine pool. Tööriist peaks vastama ühele äritehingule, millel on selge eel- ja järelpilt: looArve toodab mustandi koos tuvastajaga, registreeri makse rakendab ühe makse ühe arve suhtes, ning kumbki ei jäta ebaõnnestumise korral poolikuks jäävat olekut. Mudelid proovivad uuesti, seega peaks kirjutamine olema ohutu kordamiseks või peaks kordust selge sõnumiga keelduma; spetsifikatsiooni annotatsioonid võimaldavad serveril kuulutada tööriista ainult lugemiseks, idempotentseks või hävitavaks, ning kliendid nagu ChatGPT kasutavad neid vihjeid, kui otsustavad, kas küsida kinnitust. Kui samm vajab otsust, mis ületab agendi volitusi, võib server tagastada sisendi nõudva tulemuse, küsides inimeselt küsimust kliendi kaudu, selle asemel et arvata.

Kuidas Sois seda rakendab

Sois tööruum on MCP server ühel URL-il, tööruumi aadress järgneb /api/mcpSee vastab 401 väljakutsele kaitstud ressursi metaandmete abil, avaldab oma autoriseerimise serveri metaandmed, nõuab PKCE-d ja väljastab tööruumi ulatuses tokenid; ühendus Claude'is või ChatGPT-s lõpetab sisselogimise ilma midagi kleepimata. Kandjatoken koos API võtmega on saadaval skriptide jaoks, mis ei kasuta OAuth-i, kus isiku tuvastamine ja kulutused on eraldi volitustes hoitud.

Tööriistade nimekiri genereeritakse reaalajas tööriistade määratlemise põhjal ja filtreeritakse rolli ja installitud rakenduste järgi, seejärel kontrollitakse iga kõne õigusi täitmise hetkel ja see ebaõnnestub, kui õigusi pole. Kõnesid piiratakse ühenduse kaupa, mõõdetakse seal, kus tööruumi enda agent teeb järeldusi, ja AI tasudest on vabastatud seal, kus kõneleja enda agent seda teeb, piiratuna tööruumi seadistatud eelarvega ning logitakse sisendi ja tulemuste järgi isiku, kes need tegi. Turule avaldatud rakendused lisavad oma tööriistad samasse nimekirja samade reeglite alusel, seega on arendaja rakendus kasutatav agendi poolt kohe pärast selle installimist.

Küsimused, mida inimesed esitavad

Seda artiklit vaadatakse üle, kui kirjeldatud tooted muutuvad. Järgmine planeeritud ülevaatus: 4. detsember 2026.