Jūs prijungiate Claude prie verslo programinės įrangos, pridėdami sistemos MCP serverį kaip pritaikytą jungtį: atidarykite Pritaikyti, tada Jungtis, pasirinkite Pridėti pritaikytą jungtį, įklijuokite serverio HTTPS URL ir prisijunkite, kai Claude atidaro sistemos OAuth puslapį. Nuo tada Claude gauna įrankių, kuriuos sistema siūlo jums, sąrašą ir skambina jais kaip jūs, kai jų reikia. Claude Code tas pats ryšys yra viena komanda, claude mcp add --transport http, po to /mcp prisijungti.
Sąlyga yra ta, kad programinė įranga turi turėti MCP serverį. Daugelis sistemų to dar neturi, o vien REST API šiam keliui nepakanka. Kur serveris egzistuoja, prisijungimas vykdomas kaip konkretus asmuo, todėl tai, ką Claude gali padaryti, yra tiksliai tai, ką tas asmuo gali padaryti, o sistema, o ne Claude, tai užtikrina.
Kas iš tikrųjų yra ryšys
Yra trys dalys, o jų pavadinimas išvengia didžiosios dalies painiavos vėliau. Šaltinis yra Claude programa. Joje kiekvienam prisijungiamam serveriui sukuriamas klientas, o tas klientas bendrauja tik su vienu serveriu. Serveris yra verslo sistemos MCP galinis taškas, vienas HTTPS URL, kuris priima JSON-RPC žinutes. Claude klientai veikia Anthropic debesyje, o ne jūsų mašinoje, todėl serveris turi būti pasiekiamas iš viešojo interneto; sistema privačiame tinkle turi turėti leidžiamus Anthropic adresų diapazonus, kad visa tai veiktų.
URL yra vienintelis dalykas, kurį turite žinoti iš anksto. Sois darbo erdvėje tai yra darbo erdvės adresas, po kurio seka: /api/mcpKiti produktai skelbia savo dokumentacijoje; vienas baigiasi /sse Kiti produktai skelbia savo dokumentacijoje; vienas, baigiasi:
Žingsnis po žingsnio, minutė po minutės
- Įklijuokite URLClaude atidarykite pritaikymą, tada jungtis, pasirinkite Pridėti pasirinktą jungtį, suteikite jai pavadinimą ir įklijuokite serverio HTTPS adresą. Claude Code, vietoj to, vykdykite mcp add komandą.
- Claude tikrina serverį.Claude siunčia užklausą be kredencialų. Apsaugotas serveris atsako 401 su WWW-Authenticate antrašte, nurodančia jo apsaugoto ištekliaus metaduomenis. Claude tai perskaito ir pažymi nustatytus autentifikavimo nustatymus.
- Claude randa autorizacijos serverį.Metaduomenys nurodo autorizacijos serverį. Claude gauna to serverio metaduomenis, kad sužinotų autorizacijos, žetono ir registracijos galinius taškus bei reikalaujamą PKCE metodą.
- Claude identifikuoja saveClaude arba pateikia Anthropic talpinamą kliento metaduomenų dokumentą, arba registruojasi dinamiškai, arba naudoja jūsų įvestą kliento ID. Jums nieko nereikia daryti, nebent pasirinkote paskutinę parinktį.
- Jūs prisijungiate ir sutinkateClaude atidaro sistemos prisijungimo puslapį jūsų naršyklėje. Jūs autentifikuojate save ir patvirtinate rodomus apimtis. Sistema grąžina kodą, Claude jį keičia į žetoną, susietą su tuo serveriu, ir išlaiko atnaujinimo žetoną.
- Claude išvardija įrankiusPridėjus žetoną, Claude kviečia tools/list ir gauna įrankius, kuriuos ši sistema siūlo jums. Jie pasirodo po jungikliu, kiekvienas su leidimu, kurį galite nustatyti.
- Pirmas užklausimasPrašykite ko nors. Claude pasirenka įrankius, prašo patvirtinimo pirmam kiekvieno kvietimui, nebent pasirinkote Visada leisti, o sistema patikrina kvietimą pagal jūsų leidimus prieš ką nors darydama.
Antras iki penkto žingsniai yra OAuth 2.1 srautas, kurio reikalauja MCP autorizacijos specifikacija HTTP serveriams, ir priežastis, kodėl nėra žetono, kurį būtų galima įklijuoti. 401 iššūkis atrodo taip, su metaduomenų adresu ir, pasirinktinai, apimtimis, kurias nori serveris.
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://acme.sois.ai/.well-known/oauth-protected-resource",
scope="mcp"Iššūkis, kurį Sois darbo erdvė grąžina neautentifikuotam klientui. Klientas seka resource_metadata adresą, kad atrastų autorizacijos serverį; apimties reikšmė yra mažiausias leidimas, kurio jis turėtų prašyti pirmiausia.
Dvi protokolo taisyklės čia apsaugo jus be jūsų įsikišimo. Klientas turi prašyti žetono šiam konkrečiam serveriui, naudodamas resource parametrą iš RFC 8707, o serveris turi atmesti žetonus, išduotus kitoms sistemoms, todėl žetono vienai sistemai negalima pakartotinai naudoti kitoje. Ir serveris niekada neturi perduoti jūsų žetono trečiajai paslaugai. Specifikacija abi tai traktuoja kaip griežtus reikalavimus, o ne rekomendacijas.
Pasirinkite prisijungimo metodą
Claude pridėti pasirinktą jungtį dialogas siūlo nedidelį pasirinkimų rinkinį, kai jis išanalizuoja URL. Dauguma žmonių niekada nekeičia to, ką jis aptinka, tačiau naudinga žinoti, ką kiekvienas pasirinkimas reiškia, nes autentifikavimo nustatymų vėliau negalima redaguoti; norint juos pakeisti, reikia pašalinti jungtį ir pridėti ją vėl.
| Nustatymas | Pasirinkimai | Kada naudoti |
|---|---|---|
| Autentifikavimas | Visada būtina; Būtina, kai serveris prašo; Nėra | Visada būtina viskam, kas veikia kaip asmuo. Nėra tik vidiniam tik skaitymo serveriui, su API raktu, pateiktu užklausos antraštėse. |
| OAuth klientas | Anthropic talpinamo kliento metaduomenys; registracija automatiškai; jūsų asmeninis kliento ID | Talpinamas dokumentas rekomenduojamas, kai serveris tai palaiko. Automatinė registracija veikia su dauguma serverių, tačiau kaupia registracijas. Jūsų asmeninis ID, kai sistema reikalauja išankstinės registracijos. |
| Užklausos antraštės | Iki keturių fiksuotų antraščių, tokių kaip x-api-key | Bendri prisijungimo duomenys paslaugų paskyrai arba maršruto antraštė, kurios reikia vartotojų vartams. Beta versijoje ir ne visoms organizacijoms rodoma. |
| Transportas | Nustatyti iš URL | Palikite. URL, baigiasi /sse, pasirenka senesnį transportą; keiskite tik jei serverio dokumentacija taip nurodo. |
Verslo sistemai teisingas atsakymas beveik visada yra numatytasis: OAuth, visada reikalaujama, vienas prisijungimas vienam asmeniui. Bendros antraštės kiekvieną veiksmą registruoja kaip tą patį vartotoją.
Komandų ir įmonių planams forma ta pati, su viena papildoma žingsniu: savininkas prideda jungtį Organizacijos nustatymuose, o kiekvienas narys tada prisijungia kaip pats po pritaikymo. Savininkas nusprendžia, kurie serveriai egzistuoja; nario veiksmai vis tiek atspindi nario pačio autoritetą.
Ką Claude mato prisijungęs
Įrankių sąrašas yra visa sąsaja. Kiekvienas įrašas turi pavadinimą, aprašymą ir įvesties schemą, o Claude modelis naudoja aprašymus, kad nuspręstų, kuris įrankis reikalingas užklausai, ir schemą, kad užpildytų argumentus. Sois darbo erdvėje sąrašas filtruojamas pagal jūsų vaidmenį ir pagal įdiegtas programas prieš jį grąžinant, todėl finansų vartotojas mato tokius įrankius kaip: ieškotiSąskaitų, sukurti sąskaitą faktūrą, įrašytiMokėjimą ir siųstiSąskaitųPrimintuvus, kartu su kontaktų, pašto, kalendoriaus ir užduočių įrankiais, kuriuos turi visi, ir visiškai nemato administracinių įrankių. Specifikacija leidžia būtent tai: serveris gali keisti sąrašą pagal prašymo akreditacijas.
Claude tada uždeda savo kontrolę. Po jungtimi galite nustatyti bet kurį įrankį kaip Blokuotą, todėl modelis jo niekada nemato. Pokalbiuose kiekvienas įrankio skambutis prašo patvirtinimo, nebent pasirinkote Visada leisti tam įrankiui, kurį Anthropic pataria rezervuoti serveriams, kuriais pasitikite. Tyrimo funkcijos gali naudoti jungties įrankius be prašymo, todėl rekomendacija yra išjungti rašymo įrankius jungtyje, kol vyksta tyrimo procesas.
Tas pats ryšys iš Claude Code ir API
Claude Code komanda yra claude mcp add --transport http sois https://your-workspace.sois.ai/api/mcpServeris pagal numatytuosius nustatymus saugomas vietiniame kontekste; --kontekstas projektas įrašo tai į .mcp.json galite įsipareigoti komandai, ir --kontekstas vartotojas padaro jį prieinamą kiekviename projekte. Vykdykite /mcp prisijungti per naršyklę, arba claude mcp prisijungti sois iš shell. Prijungti įrankiai, jau pridėti prie claude.ai, automatiškai pasirodo Claude Code po tuo pačiu paskyros, o administratoriai gali pažymėti atskirus įrankius kaip leidžiamus arba blokuojamus.
Žinučių API yra kitokio pobūdžio. Jo MCP jungtis, beta versijoje už mcp-client-2025-11-20 antraštė, priima serverio URL mcp_serveriai įraše ir MCP įrankių rinkinys įrankių masyve, ir jis palaiko tik įrankių skambučius. Nėra naršyklės srauto: jūs patys gaunate OAuth prieigos raktą ir perduodate jį kaip autorizacijos žetonas, refreshing it as needed. That suits a service you run on behalf of users you have already authenticated. It is the wrong path for handing an end user a connection, which is what the custom connector exists for.
Ką Claude gali daryti
Po peržiūros naudingas klausimas nėra, ar Claude yra prijungtas, bet ką ryšys gali padaryti, o atsakymą nustato serveris. Sois atsakymas yra asmens leidimai, kurie taikomi du kartus: pirmą kartą, kai sudaromas įrankių sąrašas, antrą kartą, kai vykdomas kiekvienas skambutis. Raktas buvo išduotas jums, todėl kiekviena veika priskiriama jums darbo erdvės žurnale su jos įvestimis ir rezultatu, lygiai taip pat, kaip ir asmeniui. Išlaidos yra ribojamos pagal integraciją, kur darbo erdvės agentas atlieka darbą; kai Claude atlieka mąstymą, kaip tai daro per šį ryšį, darbo erdvė nevykdo jokios AI jūsų vardu ir už tai nieko neima.
Būtent tai leidžia protingai leisti modeliui veikti: leidimai yra tie, kuriuos verslas jau palaiko žmonėms, o ryšys juos paveldi.
Kai kažkas nepavyksta
- Prisijungimo ciklai arba nesėkmės. Beveik visada URL: kelias, kuris nėra MCP galinis taškas, arba serveris, kuris nėra pasiekiamas iš viešojo interneto. Patikrinkite adresą pagal sistemos dokumentaciją ir patvirtinkite, kad jis atsako 401 su WWW-Authenticate antrašte.
- Trūksta įrankių. Sąrašas filtruojamas pagal jūsų vaidmenį. Jei kolega mato įrankį, kurio nematote, skirtumas yra verslo sistemos leidimuose, o ne jungtyje.
- Skambutis atmetamas. Perskaitykite klaidą, kurią praneša Claude. Leidimo atmetimas reiškia, kad asmuo, su kuriuo prisijungėte, to negali padaryti; validacijos klaida reiškia, kad modelis gali ištaisyti įvestį ir bandyti dar kartą.
Klausimai, kuriuos žmonės užduoda
Ar man reikia įklijuoti API raktą ar tokeną į Claude?
Ne, jei serveris palaiko OAuth. Claude nustato autorizacijos serverį iš 401 iššūkio ir atidaro prisijungimo puslapį; tokenas išduodamas Claude ir automatiškai atnaujinamas. Fiksuoti antraštės yra tik tiems serveriams, kurie neturi OAuth, o bendri prisijungimo duomenys praranda asmeninę atribuciją.
Ar galiu prijungti programinę įrangą, kuri turi tik REST API?
Ne per šį kelią. Claude pritaikyti jungikliai kalba MCP. Kas nors turi įdėti MCP serverį prieš API, ką platformos, tokios kaip Sois, daro visai savo įrankių paviršiuje.
Ar jungtis veikia iš Claude mano telefone?
Anthropic dokumentacijoje nurodoma, kad Claude veikia internete, darbalaukio programoje ir Cowork pritaikytoms jungtims. Kadangi klientas veikia Anthropic debesyje, o ne įrenginyje, jungtis, pridėta internete, nėra susieta su mašina.
Ką gali padaryti Claude prisijungus?
Ką tik asmuo, su kuriuo prisijungėte, gali daryti toje sistemoje, jei serveris taiko leidimus kiekvienam skambuciui. Sois tai reiškia, kad jūsų vaidmens įrankiai bus pasiekiami per kontaktus, pašto dėžutę, apskaitą, užduotis ir kitus, patikrinus, kai siūloma ir vėl, kai vykdoma.
- Claude dokumentacija: trečiųjų šalių jungtys su nuotoliniu MCP Pridėti pritaikytos jungties dialogą laukelis po laukelio ir kiekvieno įrankio valdikliai.
- Model Context Protocol specifikacija: autorizacija OAuth 2.1 srautas, apsaugotos išteklių metaduomenys, išteklių indikatoriai ir žetono taisyklės
- Claude kodo dokumentacija: MCP serveriai claude mcp add komanda, apimtys ir prisijungimas
- Sois dokumentacija: darbo erdvės MCP serveris galinis taškas, atradimo dokumentai ir vaidmenų filtravimas, kaip įgyvendinta
Šis straipsnis peržiūrimas, kai keičiasi jame aprašyti produktai. Kita suplanuota peržiūra: 2026 m. gruodžio 4 d..