Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Tipi ta' Servers MCP: STDIO, SSE, u OAuth

Lezzjoni 2 / 14 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Żewġ modi ta’ trasport, żewġ arkitetturi
  2. STDIO: is-server li jgħix fuq il-magna tiegħek
  3. SSE u Streamable HTTP: servers remoti
  4. Tliet livelli ta’ awtentikazzjoni
  5. Kif tiddeċiedi fil-prattika
  6. Punti Ewlenin

Aġġornat fit-2 ta’ Novembru, 2026 — Le Chat issa huwa Vibe. Mill-28 ta’ Mejju, 2026, Le Chat ġie mibdul għal Vibe (għadu f’chat.mistral.ai): aġent wieħed għax-xogħol u l-kodiċi, li jżomm il-konversazzjonijiet, l-issettjar u s-sottoskrizzjonijiet tiegħek. L-esperjenza antika ta’ Le Chat tibqa’ aċċessibbli fil-modalità Chat; fil-modalità Work, l-aġenti saru ħiliet (invokati b’@), il-memorji saru l-bażi tal-għarfien, u t-tfittxija profonda saret il-ħila Deep Research. Il-pjanijiet issa jissejħu Mistral Free, Pro, Team, u Enterprise. Din il-lezzjoni tuża l-isem Vibe; xi menus deskritti hawnhekk jistgħu biddlu isimhom jew posthom.

Żewġ modi ta’ trasport, żewġ arkitetturi

Server MCP jikkomunika mal-klijent tiegħu f’żewġ modi fundamentali differenti, skont jekk ikunx qed jaħdem fuq l-istess magna jew fuq host remot. Din id-distinzjoni mhix dettall ta’ implimentazzjoni: tiddetermina min jista’ juża s-server tiegħek, kif tiddispjah, u liema data jista’ jaċċessa. Li tagħmel din il-għażla kmieni se jiffrankalek milli tikteb mill-ġdid il-proġett tiegħek f’nofs it-triq.

STDIO: is-server li jgħix fuq il-magna tiegħek

STDIO (Standard Input/Output) huwa t-trasport lokali. Is-server MCP jaħdem fuq l-istess magna tal-klijent, u l-komunikazzjoni tgħaddi mill-flussi standard tas-sistema operattiva: stdin u stdout. Il-mekkaniżmu huwa dirett: il-klijent iniedi l-proċess tas-server, jibgħat talbiet permezz ta’ stdin, jaqra r-risposti minn stdout, u jtemm il-proċess meta tintemm il-konversazzjoni. L-ebda port, l-ebda URL, l-ebda ċertifikat.

Dan it-trasport huwa l-għażla naturali kull meta għodla teħtieġ tmiss l-ambjent lokali. Server li jaqra l-fajls tiegħek, isejjaħ git, imexxi Docker, jew jispezzjona bażi tad-data SQLite li tinsab fuq id-disk tiegħek jagħmel sens biss fil-modalità STDIO. Huwa wkoll il-modalità preferuta għall-integrazzjonijiet f’edituri bħal VS Code jew Cursor, u s-sieħeb ovvju għall-fażi ta’ żvilupp, fejn trid terġa’ tistarta s-server tiegħek kull tletin sekonda.

from mcp import StdioServerParameters

server_params = StdioServerParameters(
    command="python",
    args=["my_mcp_server.py"],
    env=None,  # Optional environment variables
)

Il-kompromess huwa strett: is-server u l-klijent iridu jkunu flimkien. Ma tistax tikkonnettja server STDIO ma’ Mistral Vibe, peress li Vibe jaħdem fuq l-infrastruttura ta’ Mistral u m’għandux mod biex iniedi proċess fuq il-magna tiegħek.

SSE u Streamable HTTP: servers remoti

Biex tmur lil hinn mill-magna lokali, MCP juża HTTP. Żewġ varjanti suċċedew lil xulxin, u jgħin li tkun taf liema waħda qed tħares lejha meta taqra kodiċi eżistenti.

SSE (Server-Sent Events) kien l-ewwel trasport remot tal-protokoll. Kien jippermetti lis-server li jstreamja avvenimenti lill-klijent, li min-naħa tiegħu kellu jagħmel talbiet POST separati biex jirritorna s-server. Id-difett strutturali tiegħu: kien jeħtieġ konnessjoni persistenti bejn iż-żewġ naħat, u dan ikkumplika l-hosting u l-iskalar serverless. Issa huwa deprekat—l-SDK ta’ Mistral għadu jipprovdi MCPClientSSE għal endpoints /sse eżistenti, iżda servers ġodda m’għandhomx jinbnew fuq din il-bażi.

Streamable HTTP issostitwih bħala t-trasport remot standard. Jneħħi r-rekwiżit għal konnessjoni persistenti: il-klijent jibgħat talbiet HTTP standard, u s-server jirrispondi permezz ta’ streaming jew f’blokk wieħed, skont il-ħtieġa. Fil-prattika, is-server remot tiegħek jesponi endpoint /mcp li miegħu jikkonnettja l-klijent.

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

# Connect to a remote MCP server
server_url = "https://my-server.example.com/mcp"
mcp_client = MCPClientStreamableHTTP(
    params=StreamableHTTPServerParams(url=server_url, timeout=100)
)

Tliet livelli ta’ awtentikazzjoni

It-trasport jgħidlek fejn jgħix is-server; l-awtentikazzjoni tgħidlek min hu permess li jsejjaħlu. Dawn huma mistoqsijiet indipendenti, u l-protokoll jappoġġja tliet tweġibiet.

L-aktar sempliċi huwa l-ebda awtentikazzjoni: kulmin jaf l-URL jista’ juża l-għodod tiegħek. Din il-għażla hija difendibbli biss għal għodod pubbliċi mingħajr data sensittiva—konvertitur ta’ unitajiet, web scraper, kalkulatur.

Imbagħad hemm it-token, jew API key. Tiġġenera token b’permessi speċifiċi u tgħaddih lill-klijent, li jinkludih fit-talbiet tiegħu. GitHub jillustra dan il-mudell tajjeb: toħloq Personal Access Token billi tiċċekkja biss l-ambiti (scopes) li l-aġent tiegħek jeħtieġ verament, u xejn aktar.

It-tielet livell huwa OAuth 2.0, il-fluss sħiħ b’skrin ta’ kunsens. L-utent jawtorizza espliċitament l-applikazzjoni biex taġixxi f’ismu, u s-server jirċievi token marbut ma’ dik il-persuna. Dan huwa dak li jagħmlu Gmail, Linear, jew Google Calendar meta tikkonnettjahom f’Vibe—u huwa l-uniku mudell aċċettabbli meta server jimmanipula data personali għal utenti multipli.

KriterjuSTDIO (Lokali)SSE / Streamable HTTP (Remot)OAuth (Remot + Auth)
Trasportstdin / stdoutHTTP (streaming opzjonali)HTTP + fluss OAuth 2.0
PostL-istess magnaServer remotServer remot
AwtentikazzjoniL-ebda (l-istess magna)L-ebda jew tokenOAuth 2.0 sħiħ
Klijenti kompatibbliIDEs, SDKs lokaliKulħadd (Vibe, SDKs, IDEs)Kulħadd (Vibe, SDKs, IDEs)
Każijiet ta’ użuFajls lokali, CLI, devAPIs pubbliċi, scrapingGitHub, Gmail, Linear
Konnessjoni persistentiIva (proċess attiv)Le (Streamable HTTP)Le (Streamable HTTP)

Kif tiddeċiedi fil-prattika

Id-deċiżjoni tinżel għal żewġ mistoqsijiet magħmula f’ordni. Is-server qed jaħdem fuq l-istess magna tal-klijent? Jekk iva, agħżel STDIO. Jekk le, agħżel Streamable HTTP, b’awtentikazzjoni jew mingħajrha skont is-sensittività tad-data li qed tiġi mmanipulata.

Żomm f’moħħok il-vinċolu fuq in-naħa tal-klijent: Mistral Vibe u chatbots ospitati ġeneralment jikkunsmaw biss servers remoti. IDE bħal VS Code jew Cursor, madankollu, jaċċetta ż-żewġ modi—għalhekk l-abitudni komda li tiżviluppa f’STDIO, imbagħad tibdel għal HTTP meta jkun wasal iż-żmien biex taqsam is-server.

Punti Ewlenin

  • STDIO = server lokali, l-istess magna, perfett għall-iżvilupp
  • Streamable HTTP = server remot, l-istandard attwali, jissostitwixxi SSE
  • Tliet livelli ta’ awt: l-ebda, token, OAuth 2.0
  • Mistral Vibe jappoġġja biss servers remoti
  • Il-għażla tat-trasport tiegħek tiddependi mill-arkitettura tad-dispiegament tiegħek