Jūs savienojat Claude ar biznesa programmatūru, pievienojot sistēmas MCP serveri kā pielāgotu savienotāju: atveriet Pielāgot, pēc tam Savienotāji, izvēlieties Pievienot pielāgotu savienotāju, ielīmējiet servera HTTPS URL un piesakieties, kad Claude atver sistēmas OAuth lapu. No tā brīža Claude iegūst rīku sarakstu, ko sistēma piedāvā jums, un izsauc tos kā jūs, kad tie ir nepieciešami. Claude Code tajā pašā savienojumā ir viena komanda, claude mcp pievienot --transport http, pēc tam /mcp pierakstīties.
Nosacījums ir, ka programmatūrai ir MCP serveris. Daudzas sistēmas to joprojām nav, un tikai REST API nav pietiekams šim ceļam. Kur serveris pastāv, savienojums tiek izveidots kā konkrēta persona, tāpēc tas, ko Claude var darīt, ir tieši tas, ko šī persona var darīt, un sistēma, nevis Claude, to nodrošina.
Kas patiesībā ir savienojums
Iesaistītas ir trīs daļas, un to nosaukšana novērš lielāko daļu neskaidrību vēlāk. Hostings ir Claude lietotne. Tajā tiek izveidots klients katram serverim, ar kuru jūs savienojat, un šis klients runā tieši ar vienu serveri. Serveris ir biznesa sistēmas MCP galapunkts, viena HTTPS URL, kas pieņem JSON-RPC ziņojumus. Claude klienti darbojas Anthropic mākoņos, nevis jūsu datorā, tāpēc serverim jābūt sasniedzamam no publiskā interneta; sistēmai privātajā tīklā ir nepieciešams, lai Anthropic adreses diapazoni būtu atļauti, pirms tas viss darbojas.
URL ir vienīgā lieta, kas jums jāzina iepriekš. Sois darba vietai tā ir darba vietas adrese, kas seko: /api/mcpCiti produkti publicē tos savā dokumentācijā; viens beidzas ar /sse norāda uz vecāku transportu, kuru Claude joprojām pieņem, bet kuru specifikācija tagad atzīmē kā novecojušu, dodot priekšroku Streamable HTTP.
Soli pa solim, minūte pa minūtei
- Ielīmējiet URLClaude atveriet Pielāgot, pēc tam Savienotāji, izvēlieties Pievienot pielāgotu savienotāju, piešķiriet tam nosaukumu un ielīmējiet servera HTTPS adresi. Claude Code, izpildiet komandu mcp add vietā.
- Claude pārbauda serveriClaude nosūta pieprasījumu bez akreditācijas datiem. Aizsargāts serveris atbild ar 401, pievienojot WWW-Authenticate galveni, kas norāda uz tā aizsargātā resursa metadatiem. Claude to izlasīja un atzīmēja atpazīšanas iestatījumus, kurus tas noteica.
- Claude atrod autorizācijas serveri.Metadati nosaka autorizācijas serveri. Claude iegūst šī servera metadatus, lai uzzinātu autorizācijas, tokena un reģistrācijas galapunktus, kā arī PKCE metodi, ko tas prasa.
- Claude identificē seviClaude vai nu parāda Anthropic mitināto klienta metadatu dokumentu, vai reģistrējas dinamiski, vai izmanto klienta ID, ko jūs ievadījāt. Jums nav jādara nekas, ja vien neizvēlējāties pēdējo opciju.
- Jūs piesakāties un piekrītatClaude atver sistēmas pieslēgšanās lapu jūsu pārlūkprogrammā. Jūs autentificējaties kā sevi un apstiprināt rādītās jomas. Sistēma pāradresē atpakaļ ar kodu, Claude apmaina to pret tokenu, kas ir saistīts ar šo serveri, un saglabā atsvaidzināšanas tokenu.
- Claude uzskaita rīkusAr pievienoto tokenu Claude izsauc tools/list un saņem rīkus, ko šī sistēma piedāvā jums. Tie parādās zem savienotāja, katrs ar atļauju, ko jūs varat iestatīt.
- Pirmais pieprasījumsLūdziet kaut ko. Claude izvēlas rīkus, lūdz apstiprinājumu pirmajam izsaukumam katram, ja vien neizvēlējāties vienmēr atļaut, un sistēma pārbauda izsaukumu pret jūsu atļaujām pirms jebkādas darbības veikšanas.
Otrā līdz piektā soļa ir OAuth 2.1 plūsma, ko MCP autorizācijas specifikācija prasa HTTP serveriem, un iemesls, kāpēc nav tokena, ko ielīmēt. 401 izaicinājums izskatās šādi, ar metadatu adresi un, ja nepieciešams, jomām, ko serveris vēlas.
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://acme.sois.ai/.well-known/oauth-protected-resource",
scope="mcp"Izaicinājums, ko Sois darba vide atgriež neautentificētam klientam. Klients seko resource_metadata adresei, lai atklātu autorizācijas serveri; jomas vērtība ir vismazākā privilēģija, ko tam vajadzētu pieprasīt vispirms.
Divas protokola noteikumu šeit aizsargā jūs bez jūsu iesaistes. Klientam jālūdz tokena šim konkrētajam serverim, izmantojot resursa parametru no RFC 8707, un serverim jāatsakās no tokeniem, kas izsniegti kaut kam citam, tāpēc tokenu vienai sistēmai nevar atkārtoti izmantot pret citu. Un serverim nekad nedrīkst nodot jūsu tokenu trešajai pusei. Specifikācija abas uzskata par stingrām prasībām, nevis ieteikumiem.
Pieteikšanās metodes izvēle
Klauda pielāgotā savienotāja dialoglodziņš piedāvā nelielu izvēles kopumu, kad tas ir pārbaudījis URL. Lielākā daļa cilvēku nekad nemaina to, ko tas atklāj, bet ir noderīgi zināt, ko katrs no tiem nozīmē, jo autentifikācijas iestatījumus pēc tam nevar rediģēt; lai tos mainītu, jums jānoņem savienotājs un jāpievieno tas vēlreiz.
| Iestatījums | Opcijas | Kad izmantot |
|---|---|---|
| Autentifikācija | Vienmēr nepieciešams; Nepieciešams, kad serveris prasa; Nav | Vienmēr nepieciešams visam, kas darbojas kā persona. Nav nepieciešams tikai iekšējam lasāmā serverim, ar API atslēgu, kas ievietota pieprasījuma galvenēs. |
| OAuth klients | Anthropic mitinātā klienta metadati; reģistrēties automātiski; jūsu paša klienta ID | Ieteicams izmantot mitināto dokumentu, kad serveris to atbalsta. Automātiskā reģistrācija darbojas ar lielāko daļu serveru, bet uzkrāj reģistrācijas. Jūsu paša ID, kad sistēma uzstāj uz iepriekšēju reģistrāciju. |
| Pieprasījuma galvenes | Līdz četriem fiksētiem galvenēm, piemēram, x-api-key | Kopīgas akreditācijas datu piekļuvei pakalpojumu kontam vai maršrutēšanas virsraksts, kas nepieciešams vārtejai. Beta versijā un nav redzams visām organizācijām. |
| Transports | Iestatīt no URL | Atstājiet to. URL, kas beidzas ar /sse, izvēlas vecāku transportu; mainiet to tikai tad, ja servera dokumentācija to norāda. |
Uzņēmuma sistēmai pareizā atbilde gandrīz vienmēr ir noklusējums: OAuth, vienmēr nepieciešams, viens pieteikums katrai personai. Kopīgas galvenes padara katru darbību izskatīgu kā to pašu lietotāju žurnālā.
Komandas un uzņēmuma plāniem forma ir tāda pati ar vienu papildu soli: īpašnieks pievieno savienotāju Organizācijas iestatījumos, un katrs dalībnieks pēc tam pieslēdzas un autentificējas kā pats zem Pielāgot. Īpašnieks nosaka, kuri serveri pastāv; dalībnieka darbības joprojām nes dalībnieka paša pilnvaras.
Ko Claude redz pēc savienojuma izveides
Rīku saraksts ir visa saskarne. Katram ierakstam ir nosaukums, apraksts un ievades shēma, un Claude modelis izmanto aprakstus, lai noteiktu, kurš rīks ir nepieciešams pieprasījumam, un shēmu, lai aizpildītu argumentus. Sois darba vietā saraksts tiek filtrēts pēc jūsu lomas un iepriekš instalētajām lietotnēm, pirms tas tiek atgriezts, tāpēc finanšu lietotājs redz tādus rīkus kā: meklētRēķinus, izveidot rēķinu, ierakstītMaksājumu un sūtītRēķinuAtgādinājumus, līdzās kontaktu, iesūtnes, kalendāra un uzdevumu rīkiem, kas ir pieejami visiem, un vispār neredz administratīvos rīkus. Specifikācija tieši to atļauj: serveris var mainīt sarakstu atkarībā no pieprasījuma akreditācijas datiem.
Tad Claude uzliek savus kontroles mehānismus virsū. Zem savienotāja jūs varat iestatīt jebkuru rīku uz Bloķēts, tāpēc modelis to nekad neredz. Čatā katrs rīka izsaukums prasa apstiprinājumu, ja vien jūs neesat izvēlējies Vienmēr atļaut šim rīkam, ko Anthropic iesaka rezervēt serveriem, kuriem uzticaties. Pētniecības funkcijas var izsaukt savienotāja rīkus bez jautāšanas, tāpēc ieteikums ir izslēgt rakstīšanas rīkus uz savienotāja, kamēr notiek pētniecības skripts.
Tas pats savienojums no Claude Code un API
Claude Code komanda ir claude mcp add --transport http sois https://your-workspace.sois.ai/api/mcpServeris pēc noklusējuma tiek glabāts lokālajā apjomā; --apjoms projekts ieraksta to uz .mcp.json jūs varat apstiprināt komandai, un --apjoms lietotājs padara to pieejamu katrā projektā. Izpildiet /mcp lai pierakstītos caur pārlūkprogrammu, vai claude mcp login sois no čaulas. Savienotāji, kas jau pievienoti claude.ai, automātiski parādās Claude Code zem tā paša konta, un administratori var atzīmēt individuālos rīkus kā pieprasītus vai bloķētus.
Ziņojumu API ir atšķirīgs. Tā MCP savienotājs, beta versijā aiz mcp-klients-2025-11-20 virsraksts, pieņem servera URL kā mcp_serveri ievadi un mcp rīku komplekts rīku masīvā, un tas atbalsta tikai rīku izsaukumus. Nav pārlūkprogrammas plūsmas: jūs paši iegūstat OAuth piekļuves tokenu un nododat to kā autorizācijas tokens, atjaunojot to pēc vajadzības. Tas ir piemērots pakalpojumam, ko jūs sniedzat lietotājiem, kurus jau esat autentificējis. Tas nav pareizais ceļš, lai nodotu gala lietotājam savienojumu, ko nodrošina pielāgotais savienotājs.
Ko Claude drīkst darīt
Pēc apmācības noderīgais jautājums nav par to, vai Claude ir savienots, bet ko savienojums var darīt, un atbildi nosaka serveris. Sois atbildi nosaka personas atļaujas, kas tiek piemērotas divreiz: pirmo reizi, kad tiek sastādīts rīku saraksts, otro reizi, kad tiek izpildīts katrs izsaukums. Token tika izsniegts jums, tāpēc katra darbība tiek attiecināta uz jums darba telpas žurnālā ar tās ievadiem un rezultātu, tieši tāpat kā personas gadījumā. Izdevumi ir ierobežoti katrai integrācijai, kur darba telpas paša aģents veic darbu; kad Claude veic loģiku, kā tas notiek šajā savienojumā, darba telpa neveic nekādu AI jūsu vārdā un par to neko neiekasē.
Tas ir tas, kas padara saprātīgu ļaut modelim rīkoties: atļaujas ir tās, ko uzņēmums jau uztur cilvēkiem, un savienojums tās manto.
Kad kaut kas noiet greizi
- Pieteikšanās cikli vai kļūdas. Gandrīz vienmēr URL: ceļš, kas nav MCP galapunkts, vai serveris, kas nav sasniedzams no publiskā interneta. Pārbaudiet adresi pret sistēmas dokumentāciju un apstipriniet, ka tā atbild ar 401 un WWW-Authenticate virsrakstu.
- Rīki trūkst. Saraksts tiek filtrēts pēc jūsu lomas. Ja kolēģis redz rīku, kuru jūs neredzat, atšķirība ir atļaujās biznesa sistēmā, nevis savienotājā.
- Zvans tiek atteikts. Izlasiet kļūdu, ko ziņo Claude. Atļaujas atteikums nozīmē, ka persona, ar kuru jūs pierakstījāties, to nevar izdarīt; validācijas kļūda nozīmē, ka modelis var labot ievadi un mēģināt vēlreiz.
Cilvēki uzdod jautājumus
Vai man jāievieto API atslēga vai tokens Claudē?
Nevis serverim, kas atbalsta OAuth. Claude atklāj autorizācijas serveri no 401 izaicinājuma un atver pierakstīšanās lapu; tokens tiek izsniegts Claudē un automātiski atjaunināts. Fiksētie virsraksti ir tikai serveriem, kuriem nav OAuth, un koplietotās akreditācijas zaudē personisko atribūciju.
Vai es varu savienot programmatūru, kurai ir tikai REST API?
Nevis caur šo ceļu. Claude pielāgotie savienotāji runā MCP. Kādam ir jānovieto MCP serveris priekšā API, ko platformas, piemēram, Sois, dara visai saviem rīkiem.
Vai savienojums darbojas no Claudē manā telefonā?
Anthropic dokumentācija uzskaita Claude tīmekli, galddatoru lietotni un Cowork pielāgotajiem savienotājiem. Tā kā klients darbojas Anthropic mākoņos, nevis ierīcē, tīmeklī pievienots savienotājs nav saistīts ar mašīnu.
Ko Claude var darīt, kad ir savienots?
Jebko, ko var izdarīt persona, ar kuru jūs pierakstījāties, šajā sistēmā, ja serveris uzspiež atļaujas katram zvana gadījumam. Sois tas nozīmē jūsu lomas rīkus visās kontaktu, iesūtņu, grāmatvedības, uzdevumu un citu jomu jomās, pārbaudītus, kad tie tiek piedāvāti un vēlreiz, kad tie tiek izpildīti.
- Claude dokumentācija: trešo pušu savienotāji ar attālinātu MCP Pievienot pielāgotā savienotāja dialoglodziņš pa lauciņiem un rīku kontroles
- Model Context Protocol specifikācija: autorizācija OAuth 2.1 plūsma, aizsargātas resursu metadati, resursu indikatori un tokenu noteikumi
- Claude koda dokumentācija: MCP serveri claude mcp pievienošanas komanda, apjomi un pierakstīšanās
- Sois dokumentācija: darba vietas MCP serveris galapunkts, atklāšanas dokumenti un lomu filtrēšana, kā ieviests
Šis raksts tiek pārskatīts, kad mainās tajā aprakstītie produkti. Nākamais plānotais pārskats: 2026. gada 4. decembris.