Lisää mukautettu MCP-liitin
Tällä sivulla
Päivitetty 2. marraskuuta 2026 — Le Chat on nyt Vibe. 28. toukokuuta 2026 lähtien Le Chat on uudelleenbrändätty nimelle Vibe (osoitteessa chat.mistral.ai): yksi agentti työhön ja koodaukseen, joka säilyttää keskustelusi, asetuksesi ja tilauksesi. Vanha Le Chat -kokemus on edelleen saatavilla Chat-tilassa; Work-tilassa agenteista on tullut taitoja (kutsutaan merkillä
@), muistit toimivat tietopankkina ja syvähaku on Deep Research -taito. Suunnitelmat ovat nyt nimeltään Mistral Free, Pro, Team ja Enterprise. Tässä oppitunnissa käytetään nimeä Vibe; jotkin tässä kuvatut valikot voivat olla muuttaneet nimeään tai sijaintiaan.
Virallisen hakemiston ulkopuolella
Sisäänrakennetut liittimet kattavat monia käyttötapauksia, mutta organisaatiosi luultavasti nojaa sisäisiin työkaluihin, omiin rajapintoihin tai erikoispalveluihin, joita ei löydy Viben hakemistosta. Tässä tulevat kuvaan mukautetut liittimet: voit lisätä minkä tahansa etä-MCP-palvelimen Vibeen pelkällä URL-osoitteella. Kuusi vuotta sitten rakennettu sisäinen CRM-järjestelmästä tulee käytettävä keskustelussa aivan kuten GitHubista tai Notionista.
Lisäysprosessi
Liittimen lisääminen vie käyttöliittymässä vain muutaman klikkauksen. Avaa Connectors-välilehti, klikkaa listan alareunassa kohtaa Add a custom connector ja täytä vaaditut tiedot:
- Name: Kuvaava nimi liittimen tunnistamiseksi (esimerkiksi “Internal CRM” tai “Weather API”)
- Server URL: MCP-palvelimesi julkinen osoite, mukaan lukien
/mcp-päätepiste (esimerkiksihttps://mon-serveur.example.com/mcp) - Description: Lyhyt selitys liittimen toiminnasta (valinnainen, mutta suositeltava)
- Authentication method: None, Token tai OAuth 2.0
Lopuksi klikkaa Create tallentaaksesi liittimen. Vibe kysyy palvelimelta automaattisesti saatavilla olevat työkalut: paljastettujen funktioiden lista ilmestyy näkyviin, ja voit alkaa käyttää niitä keskusteluissasi.
Tämä havaintopyyntö palauttaa jokaiselle työkalulle sen nimen, tekstimuotoisen kuvauksen, odotetut parametrit (nimi, tyyppi ja kuvaus) sekä palautustyypin. Nämä ovat ainoat tiedot, joita Mistral-malli käyttää päättäessään, milloin ja miten kutakin työkalua kutsutaan – minkä vuoksi seuraava oppitunti keskittyy vahvasti kuvausten laatuun. Hyvin kirjoitettu työkalu, jolla on huono kuvaus, pysyy mallille näkymättömänä.
Todennusmenetelmät
Yksinkertaisin tapaus on ei-todennus: MCP-palvelimesi on kaikkien saatavilla, jotka tuntevat sen URL-osoitteen. Tämä toimii julkisille työkaluille, jotka eivät käsittele arkaluonteisia tietoja, prototyypeille, demoille ja julkisia rajapintoja käärittäville MCP-palvelimille. Token-todennus edellyttää avaimen toimittamista, joka lähetetään jokaisen palvelinpyynnön mukana; Vibe säilyttää tokenin turvallisesti. Valitse tämä sisäisille rajapinnoille, jotka on suojattu API-avaimella, palvelimille, jotka tarvitsevat kutsujan tunnistamisen, ja kaikille tilanteille, joissa haluat rajoittaa pääsyä. Lopuksi on OAuth 2.0, koko vuokaavio uudelleenohjauksella palvelun valtuutussivulle: se on turvallisin mekanismi, mutta myös monimutkaisin toteuttaa palvelinpuolella, ja sitä käsitellään perusteellisesti tulevissa Mistral AI:n oppaissa.
MCP-palvelimesi edellytykset
- Saatavilla **julkisen URL-osoitteen** kautta (ei localhostia)
- Paljastaa päätepisteen **Streamable HTTP** -muodossa (
/mcp) - Vastaa **työkalujen havaitsemis**pyyntöihin standardissa MCP JSON -muodossa
- Käsittelee **työkalukutsut** oikein ja palauttaa tulokset odotetussa muodossa
Julkinen URL-vaatimus saattaa vaikuttaa estävän paikallisen kehittämisen, mutta vianetsintävaiheessa on olemassa kiertotie. Jos kehität koneellasi ja haluat testata Vibellä ennen käyttöönottoa, avaa tunneli paikalliselle palvelimellesi käyttämällä ngrokia:
ngrok http 8000
ngrok antaa sinulle väliaikaisen julkisen URL-osoitteen, jota voit käyttää liittimen URL-osoitteena Vibessä. Tämä lähestymistapa on ihanteellinen kehittämiseen ja testaukseen: muokkaat koodiasi, käynnistät uudelleen, ja Vibe näkee uuden version välittömästi ilman mitään käyttöönottoa.
Testaus MCP Inspectorilla
Ennen palvelimesi lisäämistä Vibeen testaa se MCP Inspectorilla, avoimen lähdekoodin työkalulla, joka varmistaa palvelimesi vastaavan oikein havaitsemispyyntöihin, luettelee saatavilla olevat työkalut kuvauksineen ja parametreineen, suorittaa työkalukutsuja manuaalisesti tulosten tarkistamiseksi ja auttaa debuggaamaan muotoilu- tai tyyppivirheitä. Käynnistä se yksinkertaisella npx-komennolla:
npx @modelcontextprotocol/inspector
Inspector avaa paikallisen verkkokäyttöliittymän, jossa yhdistät MCP-palvelimesi ja testaat jokaista työkalua erikseen. Tämä vaihe ei ole pelkkä muodollisuus: se säästää sinua polttamasta keskusteluviestejä vianetsintään ja eristää selkeästi palvelinvirheet mallin tulkintavirheistä.
Organisaation hallinta
Jos kuulut organisaatioon Vibessä, huomaa, että lisäämäsi mukautetut liittimet ovat näkyvissä muille jäsenille. Järjestelmänvalvoja voi poistaa käytöstä minkä tahansa liittimen koko organisaatiolta, jos hän pitää sitä sopimattomana tai turvattomana. Kunkin käyttäjän on kuitenkin annettava omat tunnistetietonsa – token tai OAuth – todennusta vaativille liittimille: liittimen jakaminen ei koskaan tarkoita pääsytietojen jakamista.
Mukautettujen liittimien turvallisuus
Toisin kuin Mistral AI:n validoimat viralliset liittimet, mukautettu liitin voi suorittaa mielivaltaista koodia palvelinpuolella, ja näkemäsi tekstikuvaus ei takaa mitään siitä, mitä palvelin todellisuudessa tekee. Pidä kiinni palvelimista, jotka olet kehittänyt itse, luotettavien kollegoiden tai kumppaneiden palvelimista sekä avoimen lähdekoodin palvelimista, joiden koodin olet tarkistanut. Pidä jopa omien liittimiesi kanssa ihmisen validointi päällä koko vianetsintävaiheen ajan; kun olet varma, että kaikki toimii, voit harkita vain luku -työkalujen asettamista tilaan “Always Allow”.
Keskeiset asiat
- Voit lisätä minkä tahansa etä-MCP-palvelimen mukautettuna liittimenä Vibeen
- Palvelimen on oltava saatavilla julkisen URL-osoitteen kautta, jossa on
/mcp-päätepiste - Kolme todennusmenetelmää on tuettu: none, token ja OAuth 2.0
- Käytä ngrokia testataksesi paikallista palvelintasi Vibellä ennen käyttöönottoa
- MCP Inspector on välttämätön palvelimesi debuggaamiseen ennen integraatiota
- Lisää vain liittimiä luotettavista lähteistä ja pidä ihmisen validointi päällä