Ohje

Näin yhdistät MCP-palvelimia Claude Codeen

MCP-palvelimet antavat Claude Codelle pääsyn koodisi ulkopuolisiin työkaluihin, kuten tikettijärjestelmään, tietokantaan tai suunnittelutyökaluun. Tämä ohje näyttää komennot palvelimen lisäämiseen, kertoo mihin asetus tallentuu, miten kirjaudut sisään ja mistä näet, toimiiko se.

Päivitetty 30. lokakuuta 2026

Lyhyesti: etäpalvelimelle aja claude mcp add --transport http name https://server/mcp; paikalliselle aja claude mcp add name -- command args. Lisää --scope user, niin palvelin toimii kaikissa projekteissa, tai --scope project, niin se jaetaan .mcp.json-tiedoston kautta. Avaa sitten Claude Code, kirjoita tarvittaessa /mcp kirjautuaksesi ja varmista, että palvelin näkyy yhdistettynä.

Alla olevat komennot noudattavat Anthropicin Claude Code -dokumentaatiota lokakuussa 2026. claude mcp -komennot ajetaan tavallisessa terminaalissa, ei Claude Code -istunnon sisällä.

Lisää etäpalvelin (yleisin tapa)

Verkossa toimiva palvelu antaa MCP-palvelimelleen verkko-osoitteen, jonka löydät palvelun omista käyttöönotto-ohjeista. Anthropic suosittelee näille HTTP-siirtotapaa.

Siirry terminaalissa cd-komennolla projektiin, jossa käytät palvelinta.
Aja claude mcp add --transport http notion https://mcp.notion.com/mcp ja vaihda tilalle haluamasi nimi ja palvelun osoite. Nimi näkyy listoissa ja /mcp-näkymässä.
Jos palvelu käyttää kirjautumisen sijaan API-avainta, välitä se otsakkeena: --header "Authorization: Bearer your-token".

Vanhemmat palvelimet voivat tarjota vain SSE:tä, joka on vanhentunut. Claude Coden uudet versiot kokeilevat ensin HTTP:tä ja vaihtavat itse SSE:hen; vanhemmissa versioissa käytä --transport sse.

Lisää paikallinen palvelin

Paikallinen (stdio) palvelin on ohjelma, joka toimii koneellasi ja käynnistetään usein npx:llä.

Kirjoita ensin Clauden valinnat, sitten -- ja sitten palvelimen oma komento: claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server.
Claude Code antaa kaiken ---erottimen jälkeisen suoraan palvelinohjelmalle. Ilman erotinta palvelimelle tarkoitetut valinnat (kuten -y) luetaan Claude Coden valinnoiksi.
Kun käytät --env-valintaa, laita sen ja palvelimen nimen väliin jokin toinen valinta, kuten esimerkissä, muuten nimi luetaan uudeksi muuttujaksi.

Valitse laajuus

Laajuus	Missä se toimii	Tallennetaan
`local` (oletus)	Tässä projektissa, vain sinulle	`~/.claude.json`, projektin polun alle
`project`	Tässä projektissa, kaikille sen kloonaaville	`.mcp.json` projektin juuressa (commitoi se)
`user`	Kaikissa projekteissasi	`~/.claude.json`

Valitse user työkaluille, joita haluat kaikkialla, kuten muistiinpanosovellukselle, ja project työkaluille, joita koko tiimi tarvitsee yhdessä repositoriossa. Jos sama palvelin on määritetty useassa paikassa, Claude Code yhdistää siihen kerran tässä prioriteettijärjestyksessä: local, project, user, sitten pluginien palvelimet ja lopuksi claude.ai:n liittimet (connectors). Kolme laajuutta tunnistetaan nimen perusteella; pluginien palvelimet ja liittimet lasketaan kaksoiskappaleiksi, kun ne osoittavat samaan osoitteeseen tai komentoon. Voittava määritys käytetään sellaisenaan; kenttiä ei yhdistetä.

Älä laita salaisuuksia suoraan jaettuun .mcp.json-tiedostoon. Se hyväksyy muuttujia, kuten ${API_KEY} tai ${API_BASE_URL:-https://api.example.com}, jotka jokainen asettaa omaan ympäristöönsä.

Kirjaudu palvelimeen, joka vaatii tilin

Käynnistä Claude Code komennolla claude.
Kirjoita /mcp. Paneeli listaa palvelimet, joihin sinun on vielä kirjauduttava.
Valitse palvelin ja kirjaudu selaimessa. Token tallennetaan koneellesi ja uusitaan puolestasi.
Vaihtoehtoisesti aja shellissä claude mcp login name. Kirjaudu ulos komennolla claude mcp logout name.

Jotkin palvelut vaativat, että rekisteröit ensin sovelluksen niille. Lisää palvelin silloin valinnoilla --client-id, --client-secret (sinua pyydetään kirjoittamaan se) ja, jos palvelun ohje vaatii kiinteän uudelleenohjauksen, --callback-port.

Tarkista, että se toimii

claude mcp list näyttää jokaisen palvelimen tilan: Connected (Yhdistetty), Needs authentication (Vaatii kirjautumisen), Failed to connect (Yhdistäminen epäonnistui), Pending approval (Odottaa hyväksyntää) tai Disabled for this project (Pois käytöstä tässä projektissa).
claude mcp get name näyttää yhden palvelimen tiedot, myös HTTP-virheen, jos yhteys epäonnistuu.
Istunnossa /mcp näyttää saman tilan ja antaa yhdistää uudelleen.
Pyydä lopuksi Claudea tekemään jotain, mihin vain tämä palvelin pystyy, esimerkiksi "list my open Linear issues".

Poista palvelin komennolla claude mcp remove name.

Hyvä tietää

Projektin palvelimet kysyvät ensin: kun istunto löytää ensimmäistä kertaa palvelimia repositorion .mcp.json-tiedostosta, Claude Code pyytää sinua hyväksymään ne. Peru valintasi komennolla claude mcp reset-project-choices. Hyväksy palvelimia vain repositorioista, joihin luotat.
Käyttöoikeudet pätevät edelleen: jokainen MCP-työkalun kutsu voi kysyä lupaa kuten mikä tahansa muu työkalu; katso näin hallitset käyttöoikeuksia Claude Codessa.
Suuret tulokset: Claude Code varoittaa, kun työkalu palauttaa yli 10 000 tokenia, ja rajaa tulosteen oletuksena 25 000 tokeniin. Nosta rajaa ympäristömuuttujalla MAX_MCP_OUTPUT_TOKENS.
Pluginit: osa plugineista tuo mukanaan omat MCP-palvelimensa, joten pluginin asentaminen voi olla helpompi tie; katso näin asennat plugineja Claude Codeen.

Jos se ei toimi

Failed to connect: aja claude mcp get name nähdäksesi virheen, tarkista URL ja aja sitten istunnossa /mcp reconnect all (uudet versiot) yrittääksesi uudelleen.
Hidas paikallinen palvelin aikakatkaistaan käynnistyksessä: käynnistä Claude Code pidemmällä rajalla, esimerkiksi MCP_TIMEOUT=10000 claude (millisekunteina).
"has a url but no type": etäpalvelimen JSON-määrityksestä puuttuu "type": "http".
API-avain hylätään: Claude Code varoittaa otsakkeen alussa tai lopussa olevista välilyönneistä tai rivinvaihdoista. Lisää palvelin uudelleen siististi liitetyllä tokenilla.

Lähteet

Claude Code user FAQ (Claude Help Center, tarkistettu 30.10.2026)
Connect Claude Code to tools via MCP (Claude Code Docs, tarkistettu 30.10.2026)

Usein kysytyt kysymykset

Onko tämä sama asia kuin claude.ai:n liittimet (connectors)?

Ne liittyvät toisiinsa, mutta ne määritetään erikseen. Claude.ai:n liittimet voivat latautua myös Claude Codeen, mutta niillä on alin prioriteetti: jos claude mcp add -komennolla lisäämäsi palvelin osoittaa samaan osoitteeseen, käytetään omaasi. Katso ohjeemme Clauden liittimistä verkko- ja työpöytäsovelluksissa.

Kirjaako palvelimen poistaminen minut ulos palvelusta?

Ei kokonaan. claude mcp remove poistaa koneeltasi tallennetun kirjautumisen, mutta ei mitätöi sitä. Aja ensin claude mcp logout nimi, jos haluat tokenin mitätöidyksi.

Voinko lisätä palvelimen JSON-pätkästä?

Kyllä. claude mcp add-json nimi ja sen perään JSON-määritys toimii. Etäpalvelimelle lisää JSONiin "type": "http", muuten se tulkitaan paikalliseksi komennoksi ja epäonnistuu.