Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Integroi mukautettu palvelin Vibeen

Oppitunti 13 / 14 Päivitetty 2. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Yhdistä MCP-palvelimesi Vibeen
  2. Lisää liitin
  3. Mitä keskustelussa tapahtuu
  4. Kun se ei toimi
  5. MCP Inspector: Käytä sitä ennen Vibeä
  6. Useiden palvelimien kanssa eläminen
  7. Keskeiset asiat

Päivitys 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ä @), muistista on tullut tietopohja ja syvähaku on muuttunut Deep Research -taidoksi. Suunnitelmat tunnetaan nyt nimillä Mistral Free, Pro, Team ja Enterprise. Tässä oppitunnissa käytetään nimeä Vibe; huomaa, että jotkin tässä kuvatut valikot ovat voineet vaihtaa nimeä tai sijaintia.

Yhdistä MCP-palvelimesi Vibeen

Palvelimesi on otettu käyttöön ja vastaa HTTPS-yhteyden kautta vakaaseen osoitteeseen. Nyt seuraa vaihe, joka antaa merkityksen kaikelle aiemmalle työllesi: palvelimen tekeminen käytettäväksi keskustelussa kohdeyleisöllesi, mukaan lukien ne, jotka eivät koskaan avaa päätettä. Vibe hyväksyy minkä tahansa yhteensopivan MCP-palvelimen mukautettuna liittimenä. Tämä oppitunti käsittelee liittimen lisäämistä, kutsuvirtojen läpikäyntiä keskustelussa ja vikojen diagnosointia – sillä ensimmäinen yritys epäonnistuu usein.

Lisää liitin

Avaa Vibe osoitteessa chat.mistral.ai ja siirry sivupalkin Connectors-välilehdelle. Löydät kaksi erillistä osiota: esitellyt liittimet, jotka Mistral on esiasettanut (GitHub, Notion ja muut), sekä omat mukautetut liittimesi, jotka ovat aluksi tyhjiä. Napsauta Add Custom Connector ja täytä kentät:

  1. Name: Kuvaava nimi (esim. “Task Manager”)
  2. Server URL: MCP-päätepisteesi täydellinen URL-osoite (esim. https://my-server.com/tasks/mcp)
  3. Description: Mitä palvelimesi tekee (valinnainen, mutta suositeltava)

Valitse seuraavaksi todennusmenetelmäsi: No authentication julkiselle palvelimelle, Token, jos liität API-tunnuksesi, tai OAuth 2.0 täyttä suostumusvirtaa varten. Napsauttamalla Connect käynnistät havainnoinnin: jos se onnistuu, Vibe näyttää palvelimeltasi löytyneiden työkalujen luettelon näyttäen kunkin nimen ja kuvauksen. Tämä on ensimmäinen todellinen palautteesi docstring-tekstiesi laadusta – luet ne täsmälleen samoin kuin malli vastaanottaa ne.

Mitä keskustelussa tapahtuu

Yhdistämisen jälkeen palvelimesi näkyy chat-sivupalkin Tools-osiossa, ja sitä merkitsee kuvake, joka ilmoittaa ulkoisen työkalun saatavuudesta. Käyttäjä esittää pyyntönsä luonnollisella kielellä, ja malli tulkitsee sen:

User: Create a high-priority task to prepare the MCP demo

Vibe: [Calling create_task with the following arguments]
  - title: "Prepare the MCP demo"
  - priority: "high"

  → Do you want to authorize this tool call?

User: [Authorize]

Vibe: The task "Prepare the MCP demo" has been successfully created
with high priority. Its ID is abc123.

Tämä vahvistuskehote on oletuskäyttäytyminen. Voit hyväksyä sen ad hoc -perusteella tai vaihtaa työkalun pysyvään valtuutukseen. Vastusta kiusausta tehdä tämä millekään palvelimelle, jota et omista. Vahvistus suojaa paitsi bugeilta, myös ainoana puolustuksenasi prompt-injektioita vastaan, joissa työkalun palauttamaan dataan piilotetut ohjeet ohjaavat mallia kutsumaan toimintoja, joita kukaan ei pyytänyt. Argumenttien vieriminen näkyviin ennen validointia on se, mikä mahdollistaa poikkeaman havaitsemisen.

Kun se ei toimi

Viesti “Unable to connect” johtuu lähes aina yhdestä näistä neljästä syystä: URL-osoite ei ole tavoitettavissa ulkopuolelta, protokolla ei ole HTTPS (mikä on Vibelle pakollinen), palvelin ei yksinkertaisesti ole käynnissä, tai CORS ei ole määritetty, vaikka Vibe lähettää pyynnöt selaimesta. Seuraava komento erottaa kaksi ensimmäistä hypoteesia sekunneissa:

# Test accessibility
curl -X POST https://your-url/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'

Jos yhteys onnistuu, mutta työkaluja ei ilmesty, jäljitä ketju takaisin palvelimen puolella: varmista, että @app.tool()-dekoraattori on jokaisessa funktiossa, että docstringejä ei puutu ja että MCP-palvelin on kiinnitetty siihen reittiin, jonka luulet sen olevan. Käytä MCP Inspectoria ennen muita tutkimuksia.

Sekavin tapaus on, kun kaikki toimii, mutta malli kutsuu väärää työkalua tai ei lainkaan. Ongelma ei tällöin ole tekninen: malli valitsee kuvausten perusteella, ja jos kaksi työkalua näyttää samanlaisilta tai jos yksi on epämääräinen, se valitsee huonosti. Käytä kolmea vipua tässä järjestyksessä: tee kuvauksesta spesifimpi selventämällä käyttötapausta, nimeä työkalu uudelleen epäselvyyden poistamiseksi ja vähennä samanaikaisesti aktiivisten työkalujen määrää. Lopuksi, jos työkalu palauttaa virheen, tarkista palvelimen lokit, toista kutsu manuaalisesti inspectorissa ja varmista, että ympäristömuuttujat on asetettu ja että tunnus tai OAuth-oikeudet myöntävät odotetut käyttöoikeudet.

MCP Inspector: Käytä sitä ennen Vibeä

Inspector testaa työkalujasi ilman mallia, eristäen puolet ongelman muuttujista:

npx @modelcontextprotocol/inspector

Se avaa verkkokäyttöliittymän, jossa yhdistät etäpalvelimeesi sen URL-osoitteen kautta, luettelet kaikki työkalut kuvauksineen ja parametreineen, suoritat työkalun valitsemillasi argumenteilla ja luet raakapalvelinvasteen. Tee tavaksi suorittaa tämä tarkistus systemaattisesti ennen palvelimen lisäämistä Vibeen, sillä se antaa välittömän diagnoosin: jos työkalu vastaa oikein inspectorissa mutta epäonnistuu Vibessä, vika ei ole palvelimessa, vaan ongelma piilee kuvauksessa tai promptissa.

Useiden palvelimien kanssa eläminen

Kun olet asentanut useita liittimiä, kurista tulee laadun ensisijainen tekijä. Vibe antaa sinun kytkeä jokaisen liittimen päälle ja pois: pidä aktiivisina vain nykyiseen tehtävään tarvittavat työkalut, sillä viiteenkymmeneen työkaluun hukkunut malli valitsee epätarkemmin ja vastaa hitaammin. Tämä hygienia perustuu oppitunnissa 10 käsiteltyyn toimialojen erotteluun – yksi palvelin projektinhallintaan, yksi valvontaan, yksi sisäisiin työkaluihin – sillä tällöin sinun tarvitsee vain aktivoida se, joka vastaa nykyistä keskustelua.

Lopuksi sovita promptisi todellisiin käytettävissä oleviin ominaisuuksiin:

# Good: reflects tool capabilities
"Create a high-priority task titled 'Prepare the demo'"

# Bad: too vague, the model doesn't know which tool to use
"Manage my project"

Viimeinen huomio, joka kannattaa tietää ennen palvelimiesi suunnittelua: Vibessä määritetyt MCP-liittimet ovat saatavilla myös mobiilisovelluksessa. Sisäiset työkalusi tulevat siten käytettäväksi puhelimella, mikä avaa kenttäkäyttöskenaarioita, joita et välttämättä ottaisi huomioon kehittäessäsi työpöydällä.

Keskeiset asiat

  • Mukautetun liittimen lisääminen Vibeen vie 3 vaihetta: nimi, URL, todennus
  • Pidä työkalukutsujen manuaalinen vahvistus käytössä tietoturvan vuoksi
  • Käytä MCP Inspectoria testaamiseen ja vianetsintään ennen integrointia Vibeen
  • Paranna työkalujen kuvauksia, jos malli ei käytä niitä oikein
  • Pidä aktiivisina vain nykyiseen tehtävään tarvittavat työkalut
  • MCP-palvelimesi ovat saatavilla myös mobiililaitteilla