Yhdistät Clauden liiketoimintaohjelmistoon lisäämällä järjestelmän MCP-palvelimen mukautettuna liittimenä: avaa Mukauta, sitten Liittimet, valitse Lisää mukautettu liitin, liitä palvelimen HTTPS-URL-osoite ja kirjaudu sisään, kun Claude avaa järjestelmän OAuth-sivun. Tämän jälkeen Claude noutaa luettelon työkaluista, joita järjestelmä tarjoaa sinulle, ja kutsuu niitä puolestasi, kun pyyntö niitä tarvitsee. Claude Codessa sama yhteys on yksi komento, claude mcp add --transport http, jota seuraa /mcp kirjautuaksesi sisään.
Ehto on, että ohjelmistolla on MCP-palvelin. Monilla järjestelmillä ei vieläkään ole, ja pelkkä REST API ei riitä tälle polulle. Kun palvelin on olemassa, yhteys muodostetaan tietyn henkilön nimissä, joten se, mitä Claude voi tehdä, on tarkalleen se, mitä tuo henkilö voi tehdä, ja järjestelmä, ei Claude, valvoo tätä.
Mikä yhteys oikeastaan on
Mukana on kolme osaa, ja niiden nimeäminen välttää suurimman osan sekaannuksesta myöhemmin. Isäntä on Claude-sovellus. Sen sisällä luodaan asiakas jokaiselle palvelimelle, johon yhdistät, ja tämä asiakas kommunikoi tarkalleen yhden palvelimen kanssa. Palvelin on liiketoimintajärjestelmän MCP-päätepiste, yksi HTTPS-URL, joka hyväksyy JSON-RPC-viestejä. Clauden asiakkaat toimivat Anthropicin pilvessä, eivät koneellasi, mikä on syy siihen, että palvelimen on oltava saavutettavissa julkisesta internetistä; yksityisverkossa olevan järjestelmän on saatava Anthropicin osoitealueet sallituiksi ennen kuin mikään tästä toimii.
URL on ainoa asia, jonka sinun tarvitsee tietää etukäteen. Sois-työtilassa se on työtilan osoite, jota seuraa /api/mcpMuut tuotteet julkaisevat omansa asiakirjoissaan; yksi päättyy /sse osoittaa vanhempaa kuljetustapaa, jota Claude edelleen hyväksyy, mutta jota erittely nyt merkitsee vanhentuneeksi Streamable HTTP:n hyväksi.
Askel askeleelta, minuutti minuutilta
- Liitä URLAvaa Claudessa Mukauttaminen, siirry sitten Liittimiin, valitse Lisää mukautettu liitin, anna sille nimi ja liitä palvelimen HTTPS-osoite. Claudessa käytä sen sijaan mcp add -komentoa.
- Claude tutkii palvelintaClaude lähettää pyynnön ilman tunnistetietoja. Suojattu palvelin vastaa 401:llä WWW-Authenticate-otsikolla, joka osoittaa sen suojatun resurssin metatietoihin. Claude lukee sen ja merkitsee havaitsemansa todennusasetukset.
- Claude löytää valtuutuspalvelimenMetatieto nimeää valtuutuspalvelimen. Claude noutaa kyseisen palvelimen omat metatiedot oppiakseen valtuutus-, token- ja rekisteröintipäätepisteet sekä vaaditun PKCE-menetelmän.
- Claude tunnistaa itsensäClaude joko esittää Anthropicin isännöimän asiakasmetadokumentin, rekisteröityy dynaamisesti tai käyttää syöttämääsi asiakas-ID:tä. Sinun ei tarvitse tehdä mitään, ellei valinnut viimeistä vaihtoehtoa.
- Kirjaudut sisään ja annat suostumuksesiClaude avaa järjestelmän kirjautumissivun selaimessasi. Vahvistat henkilöllisyytesi ja hyväksyt näytetyt oikeudet. Järjestelmä ohjaa takaisin koodilla, jonka Claude vaihtaa palvelimelle sidottuun tokeniin ja säilyttää päivitystokenin.
- Claude listaa työkalutTokenin liitettyä Claude kutsuu tools/list ja vastaanottaa työkalut, joita tämä järjestelmä tarjoaa sinulle. Ne näkyvät liittimen alla, jokaisella on oikeus, jonka voit asettaa.
- Ensimmäinen pyyntöKysy jotain. Claude valitsee työkalut, pyytää hyväksyntää ensimmäiselle kutsulle jokaiselle, ellei olet valinnut Aina salli, ja järjestelmä tarkistaa kutsun oikeutesi ennen kuin tekee mitään.
Vaiheet kaksi viisi ovat OAuth 2.1 -prosessi, jonka MCP-valtuutusmäärittely vaatii HTTP-palvelimilta, ja syy siihen, ettei tokenia ole liitettävänä. 401-haaste näyttää tältä verkossa, metadatan osoitteen ja valinnaisesti palvelimen haluamat oikeudet.
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://acme.sois.ai/.well-known/oauth-protected-resource",
scope="mcp"Haaste, jonka Sois-työtila palauttaa tunnistamattomalle asiakkaalle. Asiakas seuraa resource_metadata-osoitetta löytääkseen valtuutuspalvelimen; oikeusarvo on vähimmäisoikeus, jota sen tulisi pyytää ensin.
Kaksi protokollasääntöä suojaa sinua täällä ilman osallistumistasi. Asiakkaan on pyydettävä tokenia tälle erityiselle palvelimelle käyttäen RFC 8707:stä peräisin olevaa resource-parametria, ja palvelimen on hylättävä kaikki muutoin myönnetyt tokenit, joten yhden järjestelmän tokenia ei voida toistaa toista vastaan. Ja palvelimen ei koskaan tule siirtää tokeniasi kolmannelle palvelulle. Määrittely käsittelee molempia tiukkoina vaatimuksina, ei suosituksina.
Sisäänkirjautumistavan valitseminen
Claudelle lisättävän mukautetun liittimen dialogi tarjoaa pienen joukon valintoja, kun se on tutkinut URL-osoitteen. Useimmat ihmiset eivät koskaan muuta sitä, mitä se havaitsee, mutta on hyödyllistä tietää, mitä kukin tarkoittaa, koska todennusasetuksia ei voi muokata myöhemmin; muuttaaksesi niitä poistat liittimen ja lisäät sen uudelleen.
| Asetus | Vaihtoehdot | Milloin käyttää |
|---|---|---|
| Todentaminen | Aina vaaditaan; Vaaditaan, kun palvelin kysyy; Ei mitään | Aina vaaditaan kaikelle, joka toimii henkilönä. Ei mitään vain sisäiselle vain-luku palvelimelle, jossa API-avain on sijoitettu pyyntöotsikoihin. |
| OAuth-asiakas | Anthropicin isännöidyn asiakkaan metatiedot; rekisteröidy automaattisesti; oma asiakas-ID:si | Isännöityä asiakirjaa suositellaan, kun palvelin tukee sitä. Automaattinen rekisteröinti toimii useimpien palvelimien kanssa, mutta kerää rekisteröintejä. Oma ID, kun järjestelmä vaatii ennakkorekisteröintiä. |
| Pyyntöotsikot | Jopa neljä kiinteää otsikkoa, kuten x-api-key | Jaetut tunnistetiedot palvelutilille tai reititysotsikko, jota portti tarvitsee. Beetaversiossa eikä näytetä kaikille organisaatioille. |
| Kuljetus | Aseta URL:stä | Jätä se. URL, joka päättyy /sse, valitsee vanhemman kuljetustavan; muuta sitä vain, jos palvelimen dokumentaatio niin sanoo. |
Liiketoimintajärjestelmässä oikea vastaus on lähes aina oletus: OAuth, aina vaaditaan, yksi kirjautuminen per henkilö. Jaetut otsikot tekevät jokaisesta toiminnasta näyttävän samalta käyttäjältä lokissa.
Tiimi- ja yrityssuunnitelmissa muoto on sama yhdellä lisäaskeleella: omistaja lisää liittimen organisaatioasetuksissa, ja jokainen jäsen yhdistää ja kirjautuu sisään itsenäisesti Mukauttaminen-osion alla. Omistaja päättää, mitkä palvelimet ovat olemassa; jäsenen toimet kantavat silti jäsenen omaa valtuutusta.
Mitä Claude näkee yhteyden jälkeen
Työkalulista on koko käyttöliittymä. Jokaisella merkinnällä on nimi, kuvaus ja syöttökaavio, ja Clauden malli käyttää kuvauksia päättääkseen, mitä työkalua pyyntö tarvitsee ja kaaviota täyttääkseen argumentit. Sois-työtilassa lista suodatetaan roolisi ja asennettujen sovellusten mukaan ennen palauttamista, joten talouskäyttäjä näkee työkaluja kuten etsiLaskut, luoLasku, kirjaaMaksu and lähetäLaskumuistutuksia yhdessä kontaktien, saapuneet-viestien, kalenterin ja tehtävätyökalujen kanssa, joita kaikilla on, eikä näe hallintatyökaluja lainkaan. Määrittely sallii juuri tämän: palvelin voi muuttaa luetteloa pyynnön tunnistetietojen mukaan.
Claude lisää sitten omat hallintansa päälle. Liittimen alla voit asettaa minkä tahansa työkalun estetyksi, joten malli ei koskaan näe sitä. Keskustelussa jokainen työkalukutsu kysyy hyväksyntää, ellei olet valinnut Aina salli tälle työkalulle, jota Anthropic neuvoo varaamaan palvelimille, joihin luotat. Tutkimusominaisuudet voivat kutsua liittimen työkaluja kysymättä, joten ohjeena on kytkeä kirjoitustyökalut pois päältä liittimessä, kun tutkimusajo on käynnissä.
Sama yhteys Claude Codesta ja API:sta
Claude Code -ohjelmassa komento on claude mcp add --transport http sois https://your-workspace.sois.ai/api/mcpPalvelin tallennetaan paikalliseen laajuuteen oletuksena; --laajuus projekti kirjoittaa sen tiedostoon .mcp.json voit sitoutua tiimille, ja --laajuus käyttäjä tekee sen saataville jokaisessa projektissa. Suorita /mcp kirjautuaksesi sisään selaimen kautta, tai claude mcp login sois komentoriviltä. Claudelle.ai:hin jo lisätyt liittimet näkyvät automaattisesti Claude Code -ohjelmassa samalla tilillä, ja ylläpitäjät voivat merkitä yksittäiset työkalut kysyttäväksi tai estetyksi.
Messages API on erilainen. Sen MCP-liitin on beetaversiossa mcp-client-2025-11-20 otsikko, ottaa palvelimen URL-osoitteen mcp-palvelimet entry and an mcp-työkalupakki Viestit API on luonteeltaan erilainen. Sen MCP-liitin, joka on beetaversiossa, ottaa palvelimen URL-osoitteen sisäänkäynnissä ja työkaluvalikoimassa, ja se tukee vain työkalikutsuja. Selainvirta ei ole käytössä: hankit OAuth-pääsytunnuksen itse ja välität sen, päivittäen sitä tarpeen mukaan. valtuutusavain, päivittäen sitä tarpeen mukaan. Tämä sopii palvelulle, jota tarjoat käyttäjille, jotka olet jo vahvistanut. Tämä ei ole oikea tapa antaa loppukäyttäjälle yhteys, mihin mukautettu liitin on tarkoitettu.
Mitä Claude saa tehdä
Kävelyn jälkeen hyödyllinen kysymys ei ole se, onko Claude yhteydessä, vaan mitä yhteys voi tehdä, ja vastaus määritellään palvelimella. Soisissa vastaus on henkilön oikeudet, joita valvotaan kahdesti: kerran, kun työkalulista kootaan, ja kerran, kun jokainen kutsu suoritetaan. Token myönnettiin sinulle, joten jokainen toiminto kirjataan työtilan lokiin sen syötteiden ja tuloksen kanssa, aivan kuten henkilön toiminta. Kulutus on rajoitettu per integraatio, jossa työtilan oma agentti tekee työtä; kun Claude tekee päättelyä, kuten se tekee tämän yhteyden kautta, työtila ei suorita mitään tekoälyä puolestasi eikä veloita siitä mitään.
Juuri tämä tekee järkeväksi antaa mallin toimia: käyttöoikeudet ovat niitä, joita yritys jo ylläpitää ihmisille, ja yhteys perii ne.
Kun jokin menee pieleen
- Sisäänkirjautuminen epäonnistuu tai jää silmukkaan. Melkein aina URL: osoite, joka ei ole MCP-päätepiste tai palvelin, johon ei pääse julkisesta internetistä. Tarkista osoite järjestelmän dokumentaatiosta ja varmista, että se vastaa 401:llä WWW-Authenticate-otsikolla.
- Työkalut puuttuvat. Lista on suodatettu roolisi mukaan. Jos kollegasi näkee työkalun, jota sinä et näe, ero johtuu liiketoimintajärjestelmän käyttöoikeuksista, ei liittimestä.
- Puhelu hylätään. Lue virhe, jonka Claude raportoi. Käyttöoikeuden hylkäys tarkoittaa, että kirjautuneena oleva henkilö ei voi tehdä sitä; validointivirhe tarkoittaa, että malli voi korjata syötteen ja yrittää uudelleen.
Kysymyksiä, joita ihmiset kysyvät
Tarvitseeko minun liittää API-avain tai token Claudeen?
Ei OAuthia tukevalla palvelimella. Claude löytää valtuutuspalvelimen 401-haasteesta ja avaa kirjautumissivun; token myönnetään Claudeille ja päivitetään automaattisesti. Kiinteät otsikot ovat vain palvelimille, joilta puuttuu OAuth, ja jaetut tunnistetiedot menettävät henkilökohtaisen attribuution.
Voinko yhdistää ohjelmiston, jolla on vain REST API?
Ei tämän reitin kautta. Clauden mukautetut liittimet puhuvat MCP:tä. Jonkun on asetettava MCP-palvelin API:n eteen, mikä on se, mitä alustat kuten Sois tekevät koko työkalupinnalleen.
Toimiiko yhteys Claudelta puhelimessani?
Anthropicin dokumentaatiossa luetellaan Claude web, työpöytäsovellus ja Cowork mukautetuille liittimille. Koska asiakas toimii Anthropicin pilvessä eikä laitteella, verkkosivulle lisätty liitin ei ole sidottu koneeseen.
Mitä Claude voi tehdä, kun se on yhdistetty?
Mitä tahansa kirjautuneena oleva henkilö voi tehdä siinä järjestelmässä, edellyttäen että palvelin valvoo käyttöoikeuksia jokaisessa kutsussa. Soisissa tämä tarkoittaa roolisi työkaluja kontakteissa, saapuneissa, kirjanpidossa, tehtävissä ja muissa, tarkistettuna tarjottaessa ja uudelleen suorituksessa.
- Clauden dokumentaatio: kolmannen osapuolen liittimet etä-MCP:n kanssa Lisää mukautettu liitin -dialogi kenttä kentältä ja työkalukohtaiset ohjaimet
- Model Context Protocol -määrittely: valtuutus OAuth 2.1 -prosessi, suojatun resurssin metatiedot, resurssin indikaattorit ja token-säännöt
- Clauden koodidokumentaatio: MCP-palvelimet claude mcp add -komento, laajuudet ja kirjautuminen
- Sois-dokumentaatio: työtilan MCP-palvelin päätepiste, löytöasiakirjat ja roolisuodatus toteutettuna
Tätä artikkelia tarkastellaan, kun sen kuvaamat tuotteet muuttuvat. Seuraava tarkastusaika: 4. joulukuuta 2026.