Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Tipi di server MCP: STDIO, SSE e OAuth

Lezione 2 di 14 Aggiornata il 2 novembre 2026 Sviluppatore
In questa pagina
  1. Due modalità di trasporto, due architetture
  2. STDIO: il server che vive sulla tua macchina
  3. SSE e Streamable HTTP: server remoti
  4. Tre livelli di autenticazione
  5. Come decidere nella pratica
  6. Punti chiave

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.

CriterioSTDIO (Locale)SSE / Streamable HTTP (Remoto)OAuth (Remoto + Auth)
Trasportostdin / stdoutHTTP (streaming opzionale)HTTP + flusso OAuth 2.0
PosizioneStessa macchinaServer remotoServer remoto
AutenticazioneNessuna (stessa macchina)Nessuna o tokenOAuth 2.0 completo
Client compatibiliIDE, SDK localiTutti (Vibe, SDK, IDE)Tutti (Vibe, SDK, IDE)
Casi d’usoFile locali, CLI, devAPI pubbliche, scrapingGitHub, Gmail, Linear
Connessione persistenteSì (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