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

Streaming HTTP- ja SSE-kuljetukset

Oppitunti 2 / 12 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Mitä kuljetuskerros todella kattaa
  2. Streaming HTTP, moderni kuljetus
  3. Server-Sent Events, avoimen yhteyden lähestymistapa
  4. Et valitse, vaan perit
  5. Mitä xAI ei tue
  6. Vaikutukset arkkitehtuuriisi
  7. Keskeiset asiat

Mitä kuljetuskerros todella kattaa

MCP-sanastossa kuljetus (transport) viittaa siihen, kuinka sovelluksesi ja työkalupalvelin vaihtavat viestejä fyysisesti. Kyseessä ei ole merkityksetön toteutusyksityiskohta: se määrittää, pysyykö yhteys auki kutsujen välillä, miten tulokset saapuvat sinulle ja mitä tapahtuu, jos välityspalvelin päättää katkaista yhteyden. xAI tukee etä-MCP:ssä kahta tapaa: Streaming HTTP:tä ja SSE:tä (Server-Sent Events), molemmat HTTPS:n yli.

Streaming HTTP, moderni kuljetus

Streaming HTTP on MCP-standardin kahdesta tavasta uudempi. Se perustuu täysin tavallisiin HTTP-pyyntöihin, yhdellä erolla: palvelin voi palauttaa vastauksensa jatkuvana virtana sen sijaan, että se odottaisi kaiken laskemista ennen yhden lohkon lähettämistä. Kutsu etenee neljässä vaiheessa.

  1. Grok lähettää POST-pyynnön MCP-palvelimelle kutsuttavan työkalun parametreineen
  2. Palvelin aloittaa pyynnön käsittelyn
  3. Vastaus saapuu vähitellen, pala kerrallaan
  4. Yhteys sulkeutuu, kun vastaus on valmis

Tämä mekanismi on järkevä hitaille tai paljon dataa tuottaville työkaluille. Ota esimerkiksi hakutyökalu, joka skannaa asiakirjakokoelmaa: mallin ei tarvitse odottaa viimeiseen tulokseen asti, vaan työkalu lähettää löytönsä sitä mukaa kun ne valmistuvat. Infrastruktuurin kannalta Streaming HTTP käyttäytyy kuin klassinen verkkoliikenne, mikä selittää sen sujuvan kulun yritysten kuormantasaimien ja välityspalvelimien läpi. Koska jokainen työkalukutsu on itsenäinen pyyntö, pysyvää valvottavaa yhteyttä ei tarvita.

Server-Sent Events, avoimen yhteyden lähestymistapa

SSE on MCP-ekosysteemin veteraani. Se perustuu pysyvään, yksisuuntaiseen yhteyteen: asiakas avaa yhteyden palvelimelle, palvelin pitää sen auki ja työntää tapahtumia asiakkaalle, kun niitä on saatavilla. MCP-kontekstissa työkalukutsu osoitetaan erilliselle päätepisteelle, ja tulos palaa jo aiemmin muodostettua SSE-kanavaa pitkin.

Tällä toimintatavalla on yksi todellinen etu ja yksi symmetrinen haitta. Etu: koska yhteys on jo olemassa, peräkkäisten kutsujen ei tarvitse maksaa uudelleenmuodostuskustannuksia, ja palvelin voi lähettää ilmoituksia ilman asiakkaan erillistä pyyntöä. Haitta: pitkäikäinen yhteys on hauras yhteys. Jos välityspalvelin soveltaa aikakatkaisua tai verkko katkeaa kahdeksi sekunniksi, kanava katkeaa. Vakava SSE-toteutus vaatiikin uudelleenyhdistyslogiikan suunnittelua.

Et valitse, vaan perit

Tässä on kohta, joka usein yllättää: et valitse kuljetustapaa. MCP-palvelin määrää käyttämänsä tavan. Kun määrität palvelimen xAI-rajapinnassa, syötät vain sen URL-osoitteen, ja rajapinta havaitsee käytössä olevan kuljetustavan automaattisesti. Parametria toisen pakottamiseksi toisen yli ei ole.

Käytännössä useimmat viimeaikaiset julkiset MCP-palvelimet ovat ottaneet käyttöön Streaming HTTP:n; vanhemmat käyttävät edelleen SSE:tä. Molemmat toimivat läpinäkyvästi Grok-rajapinnan kanssa, etkä yleensä pysty tietämään kumpaa käytetään ilman palvelimen dokumentaation tarkistamista.

Mitä xAI ei tue

Kolme muualla MCP-ekosysteemissä nähtyä kuljetustapaa eivät toimi tässä, ja tämän listan ignorointi on yleisin syy ensimmäisen yrityksen epäonnistumiseen. stdio-kuljetus, jota käytetään paikallisissa MCP-palvelimissa (kuten Claude Desktopiin kytketyissä), ei ole hyväksytty: koneellasi pyörivää ja vakiosyötteen/-tulosteen kautta viestivää palvelinta ei voi yhdistää Grokiin. Pelkkä HTTP hylätään poikkeuksetta; kaiken on kuljettava HTTPS:n yli. Myöskään WebSocketia, jota jotkin MCP-toteutukset käyttävät, xAI-rajapinta ei tunnista MCP-kuljetukseksi.

Vaikutukset arkkitehtuuriisi

Palvelimen määräämä kuljetustapa vaikuttaa sovelluksesi robustiuteen. Streaming HTTP:n kanssa, koska jokainen kutsu on tilaton, palvelusi uudelleenkäynnistys ei jätä mitään rikki: seuraava pyyntö alkaa alusta ja kaikki toimii. SSE:n kanssa pysyvä yhteys voi katketa kesken kaiken, ja sinun on päätettävä, mitä tehdään kutsulle, joka alkoi mutta jonka tulosta ei koskaan palautettu – yritetäänkö uudelleen, hylätäänkö se vai ilmoitetaanko käyttäjälle virheestä.

Voit kuitenkin olla rauhallinen: molemmissa tapauksissa xAI-rajapinta hoitaa yhteyden MCP-palvelimeen, ei sinä. Et toteuta protokollikaa etkä uudelleenyhdistyslogiikkaa itse. Riittää, että annat palvelimen URL-osoitteen; nämä seikat vaikuttavat vain siihen, miten tulkitset virheen tai mitoitat sovelluksesi aikakatkaisut.

Keskeiset asiat

  • xAI tukee kahta MCP-kuljetusta: Streaming HTTP ja SSE, molemmat HTTPS:n yli
  • Streaming HTTP on moderni, tilaton kuljetus, joka yhteensopiva standardin verkkoinfrastruktuurin kanssa
  • SSE ylläpitää pysyvää yhteyttä, mikä on hyödyllistä tiheissä kutsuissa mutta hauraampaa
  • Kuljetustavan määrää MCP-palvelin, ei konfiguraatiosi
  • stdio, pelkkä HTTP ja WebSocket eivät ole tuettuja etä-MCP:ssä