Mikä on MCP?

Model Context Protocol (MCP) on avoin standardi, jonka avulla tekoälyavustajat voivat käyttää työkaluja ja tietoja palvelimien kautta. Palvelin on joko paikallinen ohjelma, jonka avustaja käynnistää tietokoneellasi ja joka viestii sen kanssa vakiosyötteen ja -tulosteen (stdio) kautta, tai etäpalvelin, johon avustaja muodostaa yhteyden HTTP:n kautta. Jokainen avustaja säilyttää palvelimensa omassa määritystiedostossaan, ja tiedostot poikkeavat hieman toisistaan.

Käyttöohjeet

  1. Valitse asiakas: käyttämäsi avustaja tai editori.
  2. Anna palvelimelle nimi, joka koostuu kirjaimista, numeroista, yhdysmerkeistä ja alaviivoista.
  3. Jos palvelin on paikallinen, anna sen käynnistävä komento (kuten npx, uvx tai docker), sen argumentit kukin omalle rivilleen sekä mahdolliset ympäristömuuttujat, kuten API-avaimet, muodossa KEY=value. Jos liitit komentokenttään koko komentorivin, kentän sisällä oleva jakopainike siirtää kaiken ensimmäisen sanan jälkeisen argumentteihin.
  4. Jos palvelin on etäpalvelin, valitse Etä-URL ja anna palvelimen URL-osoite ja mahdolliset otsakkeet, kuten Authorization: Bearer <token>.
  5. Kopioi määritykset tiedostoon, joka mainitaan kohdassa Mihin se lisätään, tai lataa ne. Jos tiedostossa on jo palvelimia, lisää uusi merkintä niiden viereen mcpServers-osion sisään (Codexissa [mcp_servers]) sen sijaan, että korvaisit koko tiedoston.
  6. Käynnistä sovellus uudelleen tai lataa sen MCP-palvelimet uudelleen.

Claude Coden, Codex CLI:n, Gemini CLI:n ja VS Coden kohdalla Komento-kenttä antaa myös päätekomennon, joka lisää palvelimen puolestasi.

Asiakkaat

Asiakas Määritystiedosto Hyvä tietää
Claude Desktop claude_desktop_config.json Sisältää vain paikalliset palvelimet. Etäpalvelimet lisätään sovelluksessa kohdassa Asetukset > Liittimet > Lisää mukautettu liitin.
Claude Code .mcp.json projektin juurihakemistossa claude mcp add tallentaa palvelimet sen sijaan tiedostoon ~/.claude.json vain sinun käyttöösi.
Cursor .cursor/mcp.json projektissa tai ~/.cursor/mcp.json
VS Code ja GitHub Copilot .mcp.json työtilan juurihakemistossa tai ~/.copilot/mcp-config.json Vanhempi servers-muoto tiedostossa .vscode/mcp.json on tarkoitettu vain VS Coden vanhentuneelle paikalliselle ajoympäristölle.
Codex CLI ~/.codex/config.toml TOML-tiedosto. Etäpalvelimen otsakkeet voi asettaa vain tiedostossa, ei komennolla codex mcp add.
Gemini CLI .gemini/settings.json projektissa tai ~/.gemini/settings.json Etäpalvelimet käyttävät avainta httpUrl.
Devin Desktop (Windsurf) ~/.config/devin/mcp_config.json tai .devin/mcp_config.json Windsurf nimettiin uudelleen Devin Desktopiksi. Henkilökohtaiset avaimet kuuluvat tiedostoon .devin/mcp_config.local.json, joka pysyy versionhallinnan ulkopuolella.

Chrome tallentaa .mcp.json-nimisen latauksen nimellä mcp.json, joten lisää alun piste takaisin, kun siirrät tiedoston paikalleen.

Avainten pitäminen turvassa

Määritystiedostoissa API-avaimet tallennetaan selväkielisinä. Älä vie jaettuun repositorioon projektitiedostoa, jossa on oikeita avaimia. Useimmat asiakkaat voivat lukea avaimen tiedoston sijaan ympäristömuuttujasta, kukin omalla syntaksillaan, joka on kuvattu niiden dokumentaatiossa.

Kaikki kootaan selaimessasi, joten antamiasi komentoja, URL-osoitteita ja avaimia ei lähetetä minnekään.