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

MCP-palvelintyypit: STDIO, SSE ja OAuth

Oppitunti 2 / 14 Päivitetty 2. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Kaksi siirtotapaa, kaksi arkkitehtuuria
  2. STDIO: koneellasi toimiva palvelin
  3. SSE ja Streamable HTTP: etäpalvelimet
  4. Kolme todennustasoa
  5. Miten päätät käytännössä
  6. Keskeiset asiat

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 käytettävissä Chat-tilassa; Work-tilassa agenteista on tullut taitoja (kutsutaan merkillä @), muistista on tullut tietokanta ja syvähaku on muuttunut Deep Research -taidoksi. Tilaukset ovat nyt nimeltään Mistral Free, Pro, Team ja Enterprise. Tässä oppitunnissa käytetään nimeä Vibe; jotkin tässä kuvatut valikot ovat voineet vaihtaa nimeä tai sijaintia.

Kaksi siirtotapaa, kaksi arkkitehtuuria

MCP-palvelin kommunikoi asiakkaansa kanssa kahdella pohjimmiltaan erilaisella tavalla riippuen siitä, suoritetaanko se samalla koneella vai etäpalvelimella. Tämä ero ei ole vain toteutusyksityiskohta: se määrittää, kuka voi käyttää palvelintasi, miten otat sen käyttöön ja mihin dataan se pääsee käsiksi. Tämän valinnan tekeminen varhaisessa vaiheessa säästää sinut projektiin uudelleenkirjoittamiselta sen ollessa jo puolivälissä.

STDIO: koneellasi toimiva palvelin

STDIO (Standard Input/Output) on paikallinen siirtotapa. MCP-palvelin suoritetaan samalla koneella kuin asiakas, ja viestintä kulkee käyttöjärjestelmän standardivirtojen kautta: stdin ja stdout. Mekanismi on suoraviivainen: asiakas käynnistää palvelinprosessin, lähettää pyynnöt stdinin kautta, lukee vastaukset stdoutista ja lopettaa prosessin keskustelun päättyessä. Ei portteja, ei URL-osoitteita, ei varmenteita.

Tämä siirtotapa on luonteva valinta aina, kun työkalun tarvitsee koskettaa paikallista ympäristöä. Palvelin, joka lukee tiedostojasi, ajaa komentoja git, ohjaa Dockeria tai tarkastelee levylläsi olevaa SQLite-tietokantaa, on järkevä vain STDIO-tilassa. Se on myös ensisijainen tila integraatioille editoreissa kuten VS Code tai Cursor, ja ilmeinen kumppani kehitysvaiheelle, jossa haluat käynnistää palvelimesi uudelleen joka kolmaskymmenes sekunti.

from mcp import StdioServerParameters

server_params = StdioServerParameters(
    command="python",
    args=["my_mcp_server.py"],
    env=None,  # Valinnaiset ympäristömuuttujat
)

Kauppa on tiukka: palvelimen ja asiakkaan on sijaittava samassa paikassa. Et voi yhdistää STDIO-palvelinta Mistral Vibeen, koska Vibe pyörii Mistralin infrastruktuurissa eikä sillä ole tapaa käynnistää prosessia koneellasi.

SSE ja Streamable HTTP: etäpalvelimet

Paikallisen koneen rajojen ylittämiseksi MCP käyttää HTTP:tä. Kaksi varianttia on seurannut toisiaan, ja on hyvä tietää, kumpaan törmäät lukiessasi olemassa olevaa koodia.

SSE (Server-Sent Events) oli protokollan ensimmäinen etäsiirtotapa. Se mahdollisti palvelimen lähettää tapahtumavirran asiakkaalle, jonka puolestaan piti tehdä erillisiä POST-pyyntöjä vastatakseen palvelimelle. Sen rakenteellinen vika: se vaati pysyvän yhteyden kahden osapuolen välille, mikä vaikeutti palvelimetöntä isännöintiä ja skaalautuvuutta. Se on nyt vanhentunut – Mistral SDK tarjoaa edelleen MCPClientSSE:n olemassa oleville /sse-päätepisteille, mutta uusia palvelimia ei pitäisi enää rakentaa tämän pohjalta.

Streamable HTTP on korvannut sen standardina etäsiirtotapana. Se poistaa vaatimuksen pysyvästä yhteydestä: asiakas lähettää tavallisia HTTP-pyyntöjä, ja palvelin vastaa joko virtana tai yhtenä lohkona tarpeen mukaan. Käytännössä etäpalvelimesi paljastaa /mcp-päätepisteen, johon asiakas yhdistää.

from mistralai.extra.mcp.streamable_http import (
    MCPClientStreamableHTTP,
    StreamableHTTPServerParams,
)

# Yhdistä etä-MCP-palvelimeen
server_url = "https://my-server.example.com/mcp"
mcp_client = MCPClientStreamableHTTP(
    params=StreamableHTTPServerParams(url=server_url, timeout=100)
)

Kolme todennustasoa

Siirtotapa kertoo, missä palvelin sijaitsee; todennus kertoo, kenellä on lupa kutsua sitä. Nämä ovat itsenäisiä kysymyksiä, ja protokolla tukee kolmea vastausta.

Yksinkertaisin on ei todennusta: kuka tahansa, joka tuntee URL-osoitteen, voi käyttää työkalujasi. Tämä valinta on perusteltavissa vain julkisille työkaluille, jotka eivät käsittele arkaluonteista dataa – kuten yksikkömuunnin, verkkokaavin tai laskin.

Seuraavaksi tulee token eli API-avain. Generoit tokenin tietyillä oikeuksilla ja välität sen asiakkaalle, joka sisällyttää sen pyyntöihinsä. GitHub havainnollistaa tätä mallia hyvin: luot henkilökohtaisen käyttöoikeustokenin (Personal Access Token) valitsemalla vain ne laajuudet, joita agenttisi todella tarvitsee, etkä mitään muuta.

Kolmas taso on OAuth 2.0, koko virta suostumusnäytön kera. Käyttäjä valtuuttaa sovelluksen nimenomaisesti toimimaan tilinsä puolesta, ja palvelin vastaanottaa kyseiseen henkilöön sidotun tokenin. Näin toimivat Gmail, Linear tai Google Calendar, kun yhdistät ne Vibeen – ja tämä on ainoa hyväksyttävä malli, kun palvelin käsittelee useiden käyttäjien henkilökohtaisia tietoja.

KriterioSTDIO (Paikallinen)SSE / Streamable HTTP (Etä)OAuth (Etä + Todennus)
Siirtotapastdin / stdoutHTTP (valinnainen virtaus)HTTP + OAuth 2.0 -virta
SijaintiSama koneEtäpalvelinEtäpalvelin
TodennusEi (sama kone)Ei tai tokenTäysi OAuth 2.0
Yhteensopivat asiakkaatIDE:t, paikalliset SDK:tKaikki (Vibe, SDK:t, IDE:t)Kaikki (Vibe, SDK:t, IDE:t)
KäyttötapauksetPaikalliset tiedostot, CLI, kehitysJulkiset API:t, kaavintaGitHub, Gmail, Linear
Pysyvä yhteysKyllä (aktiivinen prosessi)Ei (Streamable HTTP)Ei (Streamable HTTP)

Miten päätät käytännössä

Päätös tiivistyy kahteen kysymykseen, jotka esitetään järjestyksessä. Suoritetaanko palvelin samalla koneella kuin asiakas? Jos kyllä, valitse STDIO. Jos ei, valitse Streamable HTTP, joko todennuksella tai ilman käsiteltävän datan arkaluonteisuudesta riippuen.

Pidä mielessäsi asiakaspuolen rajoite: Mistral Vibe ja ylipäätään isännöidyt chatbotit kuluttavat vain etäpalvelimia. IDE kuten VS Code tai Cursor sen sijaan hyväksyy molemmat tilat – mistä johtuu mukava tapa kehittää STDIO-tilassa ja vaihtaa HTTP:hen, kun on aika jakaa palvelin.

Keskeiset asiat

  • STDIO = paikallinen palvelin, sama kone, täydellinen kehittämiseen
  • Streamable HTTP = etäpalvelin, nykyinen standardi, korvaa SSE:n
  • Kolme todennustasoa: ei mitään, token, OAuth 2.0
  • Mistral Vibe tukee vain etäpalvelimia
  • Siirtotapavalintasi riippuu käyttöönottoarkkitehtuuristasi