MCP-palvelinten määrittäminen Vibessä
Tällä sivulla
Oppitunti päivitetty 2. marraskuuta 2026 Vibe Code -sivuston MCP servers -osion perusteella: todennus käyttää nyt
[mcp_servers.auth]-taulukkoa (api_key_envtai OAuth); aiemmin esitettyä${VARIABLE}-syntaksia otsikoissa ei ole dokumentoitu MCP-palvelimille. Lisättyvibe mcp add- ja/mcp-alikäskyt. Lähde: MCP servers.
Mikä on MCP?
Model Context Protocol (MCP) on avoin standardi, jonka avulla tekoälyagentit voivat kommunikoida ulkoisten työkalupalvelimien kanssa. MCP:n ansiosta sinun ei tarvitse koodata jokaista integraatiota erikseen. Sen sijaan se tarjoaa yhtenäisen protokollan: palvelin paljastaa työkalut, ja agentti löytää sekä käyttää niitä automaattisesti. Sinun ei tarvitse kirjoittaa liimakoodia. Määritä vain osoite tai komento, niin työkalut ilmestyvät seuraavaan istuntoosi.
Vibessä on natiivi MCP-tuki, mikä tarkoittaa, että voit laajentaa sen ominaisuuksia kauas sisäänrakennettujen työkalujen ulkopuolelle – voit esimerkiksi lukea verkkosivuja, kysellä tietokantoja tai kutsua yrityksen sisäisiä rajapintoja.
Kaksi kuljetustapaa
Ennen kuin määrität mitään, sinun on päätettävä kuljetustavasta eli kanavasta, jota Vibe käyttää palvelimeen yhdistämiseen.
HTTP-kuljetuksessa MCP-palvelin toimii tavallisena verkkopalveluna, ja Vibe lähettää pyyntöjä työkalujen löytämiseksi ja kutsumiseksi:
[[mcp_servers]]
name = "my_http_server"
transport = "http"
url = "http://localhost:8000"
headers = { "Authorization" = "Bearer my_token_here" }
Käytä tätä tilaa, kun MCP-palvelin on jatkuvasti käynnissä – esimerkiksi tietokantapalvelu, sisäinen rajapinta tai koko tiimin käyttämä verkkotyökalu.
STDIO-kuljetuksessa palvelin on paikallinen ohjelma, jonka Vibe käynnistää itse, ja viestintä tapahtuu stdin/stdout-kanavien kautta:
[[mcp_servers]]
name = "fetch_server"
transport = "stdio"
command = "uvx"
args = ["mcp-server-fetch"]
Tämä on helpoin tapa asentaa, koska Vibe hallinnoi palvelimen elinkaarta: se käynnistää palvelimen istunnon alussa ja sammuttaa sen lopussa. Manuaalista käynnistystä tai valvontaa ei tarvita.
Saatavilla on myös HTTP-muunnelma nimeltä streamable-http, joka on suunniteltu pitkäikäisille yhteyksille ja suoratoistolle:
[[mcp_servers]]
name = "my_stream_server"
transport = "streamable-http"
url = "http://localhost:9000/mcp"
Käytännön esimerkki: Verkkosivujen haku
Yksi hyödyllisimmistä MCP-palvelimista on mcp-server-fetch, jonka avulla Vibe voi lukea verkkosivujen sisältöä. Määrittely vaatii vain kolme riviä:
# ~/.vibe/config.toml
[[mcp_servers]]
name = "fetch"
transport = "stdio"
command = "uvx"
args = ["mcp-server-fetch"]
Vaikutus päivittäiseen työhösi on välitön. Voit nyt tehdä pyyntöjä, jotka olettavat ulkoisen lukemisen olevan mahdollista:
Lue FastAPI:n dokumentaatio osoitteesta fastapi.tiangolo.com ja tee yhteenveto turvallisuuspäättepisteistä minulle
Agentti kutsuu automaattisesti MCP-palvelimen fetch-työkalua hakeakseen sivun ja analysoi sen sisällön. Sinun ei tarvitse avata selainta eikä liittää dokumentaatiokatkelmia päätelaitteeseen.
MCP-työkalujen suodattaminen
Tällä mukavuudella on hintansa. Jokainen lisäämäsi palvelin tuo mukanaan oman joukkonsa työkaluja, ja kolmen tai neljän aktiivisen palvelimen kanssa luettelo voi muuttua sekavaksi. Suodatuksen avulla voit pitää käytössä vain oleelliset:
# Ota käyttöön vain tietyn palvelimen työkalut
enabled_tools = ["fetch_*"]
# Poista kaikki MCP-työkalut käytöstä, paitsi nimenomaisesti sallitut
disabled_tools = ["mcp_*"]
Jokerimerkeillä tehtävä suodatus palvelee kahta tarkoitusta samanaikaisesti. Se parantaa turvallisuutta rajoittamalla agentin toimintamahdollisuuksia ja estää mallin kontekstin ylikuormittumisen: liian pitkä työkaluluettelo syö arvokasta kontekstitilaa ja heikentää agentin päätösten laatua.
Lisämääritykset todennuksella
Yritystason MCP-palvelimet vaativat lähes aina todennuksen. Tunnisteen osalta [mcp_servers.auth]-taulukko static-tilassa lukee avaimen ympäristömuuttujasta, jonka nimen annat, ja lisää sen valitsemaasi otsikkoon:
[[mcp_servers]]
name = "internal_api"
transport = "http"
url = "https://mcp.your-company.com"
[mcp_servers.auth]
type = "static"
api_key_env = "MCP_API_TOKEN" # muuttujan nimi, ei itse tunnus
api_key_header = "Authorization" # oletusarvo
api_key_format = "Bearer {token}" # oletusarvo
Palvelimelle, joka tarjoaa OAuth-kirjautumisen (kuten Linear), aseta type = "oauth" ja kirjaudu sisään istunnon aikana komennolla /mcp login <name>: Vibe avaa selaimesi ja tallentaa tunnukset järjestelmän avainnippuun, ei koskaan tiedostoon config.toml. Komento vibe mcp add hoitaa kaiken tämän päätelaitteesta: vibe mcp add linear --url https://mcp.linear.app/mcp lisää palvelimen ja aloittaa kirjautumisprosessin.
Hyöty on selkeä: voit versiohallita ja jakaa config.toml-tiedostosi tiimisi kanssa kovakoodaamatta salaisuuksia, sillä jokainen kehittäjä tarjoaa oman tunnuksensa ympäristönsä kautta.
Suosittuja MCP-palvelimia
Useat valmiit palvelimet kattavat yleisimmät tarpeet, ja ne kaikki määritellään samalla tavalla tiedostossa config.toml. mcp-server-fetch hoitaa verkkosivujen ja rajapintojen haun; mcp-server-filesystem laajentaa tiedosto-operaatioita sisäänrakennettujen työkalujen yli; mcp-server-git tuo edistyneen Git-integraation diff-, blame- ja log-toiminnoilla; mcp-server-sqlite ja mcp-server-postgres mahdollistavat SQLite- ja PostgreSQL-tietokantojen kyselyn. Agentti, joka pystyy lukemaan sekä tietokannan skeeman että sitä käyttävän koodin, havaitsee ristiriitaisuuksia, joita pelkkä tiedostojen lukeminen ei koskaan paljastaisi.
Istunnon aikana /mcp luettelee palvelimet ja /mcp <name> luettelee niiden työkalut; /mcp status näyttää kunkin tilan. Agentti kertoo myös vastauksissaan, mitä työkaluja se käyttää, mikä on paras tapa varmistaa palvelimen toimivuus.
MCP-palvelinten turvallisuus
MCP-palvelin toimii oikeuksillasi ja näkee sen, mitä sille annat: lisää vain luotettavia palvelimia, sillä haitallinen palvelin voisi paljastaa dataa koodikannastasi. Rajoita sitten oikeuksia käyttämällä enabled_tools-asetusta sen sijaan, että myöntäisit täydet oikeudet oletuksena.
Kaksi tapaa viimeistelevät tämän hygieniarutiinin. Tarkista otsikkosi: minkään tunnuksen ei pitäisi esiintyä selväkielisenä tiedostossa config.toml; sitä varten api_key_env on olemassa. Paikallisten työkalujen osalta suosio STDIO-kuljetusta, joka on turvallisempi kuin verkkoon altistettu HTTP-palvelin, jo pelkästään siksi, ettei se avaa portteja.
Keskeiset asiat
- MCP:n avulla voit lisätä ulkoisia työkaluja Vibeen standardoidun protokollan kautta
- Kaksi pääasiallista kuljetustapaa: HTTP (jatkuva palvelin) ja STDIO (paikallinen prosessi)
- Työkalujen suodatus (
enabled_tools,disabled_tools) ohjaa sitä, mitä agentti voi käyttää - Otsikoissa käytettävät ympäristömuuttujat suojaavat salaisuuksia
- Lisää vain luotettavia MCP-palvelimia ja rajoita niiden oikeuksia