Tipi di server MCP: STDIO, SSE e OAuth
In questa pagina
Aggiornato il 2 novembre 2026 — Le Chat è ora Vibe. Dal 28 maggio 2026, Le Chat è stato rinominato Vibe (sempre all’indirizzo chat.mistral.ai): un unico agente per lavoro e codice, che mantiene le tue conversazioni, impostazioni e abbonamenti. L’esperienza legacy di Le Chat rimane accessibile nella modalità Chat; nella modalità Work, gli agenti sono diventati competenze (invocate con
@), le memorie sono diventate la base di conoscenza e la ricerca approfondita è diventata la competenza Deep Research. I piani si chiamano ora Mistral Free, Pro, Team ed Enterprise. Questa lezione utilizza il nome Vibe; alcuni menu qui descritti potrebbero aver cambiato nome o posizione.
Due modalità di trasporto, due architetture
Un server MCP comunica con il suo client in due modi fondamentalmente diversi, a seconda che venga eseguito sulla stessa macchina o su un host remoto. Questa distinzione non è un dettaglio implementativo: determina chi può utilizzare il tuo server, come lo distribuisci e a quali dati può accedere. Fare questa scelta fin dall’inizio ti eviterà di riscrivere il progetto a metà strada.
STDIO: il server che vive sulla tua macchina
STDIO (Standard Input/Output) è il trasporto locale. Il server MCP viene eseguito sulla stessa macchina del client e la comunicazione avviene attraverso i flussi standard del sistema operativo: stdin e stdout. Il meccanismo è diretto: il client avvia il processo del server, invia le richieste tramite stdin, legge le risposte da stdout e termina il processo al termine della conversazione. Niente porte, niente URL, niente certificati.
Questo trasporto è la scelta naturale ogni volta che uno strumento deve interagire con l’ambiente locale. Un server che legge i tuoi file, esegue git, gestisce Docker o ispeziona un database SQLite sul tuo disco ha senso solo in modalità STDIO. È anche la modalità preferita per le integrazioni negli editor come VS Code o Cursor, e il compagno ideale per la fase di sviluppo, dove vuoi riavviare il server ogni trenta secondi.
from mcp import StdioServerParameters
server_params = StdioServerParameters(
command="python",
args=["my_mcp_server.py"],
env=None, # Variabili d'ambiente opzionali
)
Il compromesso è rigido: server e client devono coesistere. Non puoi connettere un server STDIO a Mistral Vibe, poiché Vibe gira sull’infrastruttura di Mistral e non ha modo di avviare un processo sulla tua macchina.
SSE e Streamable HTTP: server remoti
Per andare oltre la macchina locale, MCP utilizza HTTP. Due varianti si sono succedute ed è utile sapere quale stai osservando quando leggi codice esistente.
SSE (Server-Sent Events) è stato il primo trasporto remoto del protocollo. Permetteva al server di trasmettere eventi al client, che a sua volta doveva effettuare richieste POST separate per rispondere al server. Il suo difetto strutturale: richiedeva una connessione persistente tra i due, complicando l’hosting serverless e il ridimensionamento. Ora è deprecato: l’SDK di Mistral fornisce ancora MCPClientSSE per gli endpoint /sse esistenti, ma i nuovi server non dovrebbero più essere costruiti su questa base.
Streamable HTTP lo ha sostituito come trasporto remoto standard. Rimuove il requisito di una connessione persistente: il client invia richieste HTTP standard e il server risponde tramite streaming o in un unico blocco, a seconda delle necessità. In pratica, il tuo server remoto espone un endpoint /mcp a cui il client si connette.
from mistralai.extra.mcp.streamable_http import (
MCPClientStreamableHTTP,
StreamableHTTPServerParams,
)
# Connessione a un server MCP remoto
server_url = "https://my-server.example.com/mcp"
mcp_client = MCPClientStreamableHTTP(
params=StreamableHTTPServerParams(url=server_url, timeout=100)
)
Tre livelli di autenticazione
Il trasporto ti dice dove risiede il server; l’autenticazione ti dice chi è autorizzato a chiamarlo. Sono questioni indipendenti e il protocollo supporta tre risposte.
La più semplice è nessuna autenticazione: chiunque conosca l’URL può utilizzare i tuoi strumenti. Questa scelta è difendibile solo per strumenti pubblici senza dati sensibili: un convertitore di unità, uno scraper web, una calcolatrice.
Segue il token, o chiave API. Generi un token con permessi specifici e lo passi al client, che lo include nelle sue richieste. GitHub illustra bene questo modello: crei un Personal Access Token selezionando solo gli ambiti di cui il tuo agente ha effettivamente bisogno, e nient’altro.
Il terzo livello è OAuth 2.0, il flusso completo con schermata di consenso. L’utente autorizza esplicitamente l’applicazione ad agire per conto del proprio account e il server riceve un token legato a quella persona. È ciò che fanno Gmail, Linear o Google Calendar quando li connetti in Vibe, ed è l’unico modello accettabile quando un server gestisce dati personali per più utenti.
| Criterio | STDIO (Locale) | SSE / Streamable HTTP (Remoto) | OAuth (Remoto + Auth) |
|---|---|---|---|
| Trasporto | stdin / stdout | HTTP (streaming opzionale) | HTTP + flusso OAuth 2.0 |
| Posizione | Stessa macchina | Server remoto | Server remoto |
| Autenticazione | Nessuna (stessa macchina) | Nessuna o token | OAuth 2.0 completo |
| Client compatibili | IDE, SDK locali | Tutti (Vibe, SDK, IDE) | Tutti (Vibe, SDK, IDE) |
| Casi d’uso | File locali, CLI, dev | API pubbliche, scraping | GitHub, Gmail, Linear |
| Connessione persistente | Sì (processo attivo) | No (Streamable HTTP) | No (Streamable HTTP) |
Come decidere nella pratica
La decisione si riduce a due domande poste in ordine. Il server viene eseguito sulla stessa macchina del client? Se sì, scegli STDIO. Se no, scegli Streamable HTTP, con o senza autenticazione a seconda della sensibilità dei dati gestiti.
Tieni presente il vincolo lato client: Mistral Vibe e i chatbot ospitati in generale consumano solo server remoti. Un IDE come VS Code o Cursor, invece, accetta entrambe le modalità: da qui l’abitudine comoda di sviluppare in STDIO, per poi passare a HTTP quando è il momento di condividere il server.
Punti chiave
- STDIO = server locale, stessa macchina, perfetto per lo sviluppo
- Streamable HTTP = server remoto, standard attuale, sostituisce SSE
- Tre livelli di auth: nessuno, token, OAuth 2.0
- Mistral Vibe supporta solo server remoti
- La scelta del trasporto dipende dalla tua architettura di distribuzione