Kuidas ühendada Claude äritarkvaraga MCP abil

Mis ühendus tegelikult on

Osaleb kolm osa ja nende nimetamine väldib hilisemaid segadusi. Host on Claude rakendus. Selle sees luuakse iga serveri jaoks, millega te ühendate, klient ja see klient suhtleb täpselt ühe serveriga. Server on äri süsteemi MCP lõpp-punkt, üksik HTTPS URL, mis aktsepteerib JSON-RPC sõnumeid. Claude'i kliendid töötavad Anthropic'i pilves, mitte teie masinas, mistõttu peab server olema avalikust internetist ligipääsetav; privaatvõrgus olev süsteem vajab enne selle toimimist Anthropic'i aadresside vahemike lubamist.

URL on ainus asi, mida peate eelnevalt teadma. Sois tööruumi puhul on see tööruumi aadress, millele järgneb: /api/mcpTeised tooted avaldavad oma dokumentatsioonis; üks lõppeb /sse Teised tooted avaldavad oma dokumentatsioonis; üks, mis lõpeb:

Juhend, minut haaval

1. Kleebi URLClaude'is avage Kohanda, seejärel Ühendused, valige Lisa kohandatud ühendus, andke sellele nimi ja kleepige serveri HTTPS aadress. Claude Code'is käivitage selle asemel käsk mcp add.
2. Claude uurib serveritClaude saadab taotluse ilma volitusteta. Kaitstud server vastab 401-ga WWW-Authenticate päisega, mis osutab selle kaitstud ressursi metaandmetele. Claude loeb seda ja märgib tuvastatud autentimise seaded.
3. Claude leiab volituste serveriMetaandmed nimetavad volituste serveri. Claude toob selle serveri enda metaandmed, et õppida tundma volitamise, tokeni ja registreerimise lõpp-punkte ning PKCE meetodit, mida see nõuab.
4. Claude tuvastab endClaude esitleb Anthropic'i hostitud kliendi metaandmete dokumenti, registreerib end dünaamiliselt või kasutab sisestatud kliendi ID-d. Teie ei pea midagi tegema, kui te ei valinud viimast valikut.
5. Te logite sisse ja annate nõusolekuClaude avab süsteemi sisselogimislehe teie brauseris. Te tuvastate end ja kinnitate näidatud ulatused. Süsteem suunab tagasi koodiga, Claude vahetab selle serveriga seotud tokeni vastu ja hoiab värskendustokeni.
6. Claude loetleb tööriistadTokeni külge kinnitamisega kutsub Claude välja tools/list ja saab tööriistad, mida see süsteem teile pakub. Need kuvatakse ühenduse all, igaühel on luba, mida saate seadistada.
7. Esimene päringKüsi midagi. Claude valib tööriistad, küsib igaühe esimese kõne heakskiitu, kui te ei valinud Alati lubada, ja süsteem kontrollib kõnet teie lubade suhtes enne midagi tegemist.

Sammud kaks kuni viis on OAuth 2.1 voog, mida MCP autoriseerimise spetsifikatsioon nõuab HTTP serveritelt, ja põhjus, miks tokenit ei ole, mida kleepida. 401 väljakutse näeb välja selline, koos metaandmete aadressiga ja valikuliselt serveri soovitud ulatustega.

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://acme.sois.ai/.well-known/oauth-protected-resource",
                  scope="mcp"

Väljakutse, mille Sois tööruum tagastab autentimata kliendile. Klient järgib resource_metadata aadressi, et avastada autoriseerimise server; ulatuse väärtus on minimaalne privileeg, mida ta peaks esmalt küsima.

Kaks protokolli reeglit kaitsevad teid siin ilma teie sekkumiseta. Klient peab küsima tokenit selle konkreetse serveri jaoks, kasutades RFC 8707 ressurssi parameetrit, ja server peab tagasi lükkama kõik muud tokenid, seega ei saa ühe süsteemi tokenit kasutada teise vastu. Ja server ei tohi kunagi edastada teie tokenit kolmandale teenusele. Spetsifikatsioon käsitleb mõlemat kui ranget nõuet, mitte soovitust.

Sisselogimise meetodi valimine

Claude'i Lisa kohandatud ühenduse dialoog pakub väikest valikute kogumit, kui see on URL-i uurinud. Enamik inimesi ei muuda seda, mida see tuvastab, kuid on kasulik teada, mida igaühe tähendus on, kuna autentimise seadeid ei saa hiljem redigeerida; nende muutmiseks peate ühenduse eemaldama ja uuesti lisama.

Meeskonna ja ettevõtte plaanide puhul on kuju sama, kuid ühe lisasammuga: omanik lisab ühenduse Organisatsiooni seadete alla ja iga liige ühendab ja logib sisse iseenda all Kohanda. Omanik otsustab, millised serverid eksisteerivad; liikme toimingud kannavad siiski liikme enda volitusi.

Mida Claude näeb pärast ühendamist

Tööriistade loend on kogu liides. Igal kirjel on nimi, kirjeldus ja sisendi skeem, ning Claude'i mudel kasutab kirjeldusi, et otsustada, millist tööriista taotlus vajab, ja skeemi, et täita argumendid. Sois'i töökeskkonnas filtreeritakse loend vastavalt teie rollile ja enne tagastamist installitud rakendustele, seega näeb finantskasutaja selliseid tööriistu nagu otsige arveid, looArve, registreeri makse ja saada arve meeldetuletusi koos kontaktide, postkasti, kalendri ja ülesannete tööriistadega, mis kõigil on, ja ei näe haldustööriistu üldse. Spetsifikatsioon lubab täpselt seda: server võib muuta nimekirja vastavalt päringu volitustele.

Claude lisab seejärel oma kontrollid. Ühenduse all saate seada mis tahes tööriista Blokeeritud, nii et mudel ei näe seda kunagi. Vestluses küsib iga tööriista kõne heakskiitu, välja arvatud juhul, kui olete valinud Alati lubada selle tööriista jaoks, mida Anthropic soovitab reserveerida usaldusväärsete serverite jaoks. Uuringu funktsioonid saavad kutsuda ühendustööriistu ilma küsimata, seega on soovitus keelata kirjutamisriistad ühenduse all, kui uurimistöö on käimas.

Sama ühendus Claude Code'ist ja API-st

Claude Code'is on käsk claude mcp add --transport http sois https://your-workspace.sois.ai/api/mcp. Server salvestatakse vaikimisi kohalikus ulatuses; --ulatus projekt kirjutab selle faili .mcp.json sa saad teha muudatusi meeskonna jaoks ja --ulatus kasutaja teeb selle kättesaadavaks igas projektis. Käivita /mcp et sisse logida brauseri kaudu või claude mcp login sois käsurealt. Claude.ai-s juba lisatud ühendused ilmuvad automaatselt Claude Code'is sama konto all ja administraatorid saavad eraldi tööriistu määrata kui lubatud või blokeeritud.

Sõnumite API on olemuselt erinev. Selle MCP-ühendus, beetaversioon, on taga mcp-client-2025-11-20 pealkiri, võtab serveri URL-i mcp serverid sissepääs ja mcp tööriistakomplekt Sõnumite API on olemuselt erinev. Selle MCP-ühendus, mis on beetaversioon, on peidetud: autentimisvõti, värskendades seda vastavalt vajadusele. See sobib teenusele, mida haldate juba autentitud kasutajate nimel. See ei ole õige tee lõppkasutajale ühenduse andmiseks, milleks kohandatud ühendaja on loodud.

Mida Claude tohib teha

Pärast tutvustust ei ole kasulik küsimus, kas Claude on ühendatud, vaid mida see ühendus teha suudab, ja vastuse määrab server. Sois on vastus inimese õigused, mis kehtivad kahel korral: esmakordselt, kui tööriistade nimekiri koostatakse, ja teist korda, kui iga kõne toimub. Token anti välja teile, seega on iga tegevus teie nimel tööruumi logis koos selle sisendite ja tulemusega, täpselt nagu inimese puhul. Kulutused on piiratud iga integratsiooni puhul, kus tööruumi enda agent töötab; kui Claude teeb mõtlemise, nagu see teeb selle ühenduse kaudu, ei tee tööruum teie nimel mingit tehisintellekti ja ei küsi selle eest midagi.

Just see, et see on mõistlik lasta mudelil tegutseda: õigused on need, mida ettevõte juba inimestele haldab, ja ühendus pärib need.

Kui midagi läheb valesti

• Sisselogimine kordub või ebaõnnestub. Peaaegu alati on URL: tee, mis ei ole MCP lõpp-punkt, või server, mis ei ole avalikust internetist ligipääsetav. Kontrollige aadressi süsteemi dokumentatsiooniga ja kinnitage, et see vastab 401 koos WWW-Authenticate päisega.
• Tööriistad puuduvad. Loend filtreeritakse teie rolli järgi. Kui kolleeg näeb tööriista, mida teie ei näe, on erinevus ettevõtte süsteemi õigustes, mitte ühenduses.
• Kõne on tagasi lükatud. Loe Claude'i teatatud viga. Luba tagasilükkamine tähendab, et isik, kelleks sisse logisite, ei saa seda teha; valideerimisviga tähendab, et mudel saab sisendi parandada ja proovida uuesti.

Küsimused, mida inimesed esitavad

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