Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Configurare i server MCP in Vibe

Lezione 8 di 16 Aggiornata il 2 novembre 2026 Sviluppatore
In questa pagina
  1. Cos’è MCP?
  2. I due tipi di trasporto
  3. Esempio pratico: aggiungere il recupero web
  4. Filtrare gli strumenti MCP
  5. Configurazione avanzata con autenticazione
  6. Server MCP popolari
  7. Sicurezza dei server MCP
  8. Punti chiave

Lezione aggiornata il 2 novembre 2026 in base alla pagina Server MCP di Vibe Code: l’autenticazione utilizza ora la tabella [mcp_servers.auth] (api_key_env o OAuth); la sintassi ${VARIABLE} negli header, mostrata in precedenza, non è documentata per i server MCP. Aggiunti i sottomandi vibe mcp add e /mcp. Fonte: Server MCP.

Cos’è MCP?

Il Model Context Protocol (MCP) è uno standard aperto che consente agli agenti AI di comunicare con server di strumenti esterni. Invece di codificare rigidamente ogni integrazione, MCP offre un protocollo unificato: il server espone gli strumenti e l’agente li scopre e li utilizza automaticamente. Non devi scrivere alcun codice di collegamento. Ti basta dichiarare un indirizzo o un comando e gli strumenti appariranno nella tua sessione successiva.

Vibe supporta nativamente MCP, il che significa che puoi estendere le sue capacità ben oltre gli strumenti integrati: leggere una pagina web, interrogare un database o chiamare un’API aziendale interna.

I due tipi di trasporto

Prima di configurare qualsiasi cosa, devi scegliere il trasporto, ovvero il canale che Vibe utilizza per comunicare con il server.

Con il trasporto HTTP, il server MCP viene eseguito come un servizio web standard e Vibe invia richieste per scoprire e chiamare gli strumenti:

[[mcp_servers]]
name = "my_http_server"
transport = "http"
url = "http://localhost:8000"
headers = { "Authorization" = "Bearer my_token_here" }

Utilizza questa modalità quando il server MCP è in esecuzione continua: un servizio di database, un’API interna o uno strumento web condiviso da tutto il tuo team.

Con il trasporto STDIO, il server è un programma locale che Vibe avvia autonomamente, comunicando tramite stdin/stdout:

[[mcp_servers]]
name = "fetch_server"
transport = "stdio"
command = "uvx"
args = ["mcp-server-fetch"]

Questa è la modalità più semplice da configurare perché Vibe gestisce il ciclo di vita del server: lo avvia all’inizio della sessione e lo arresta alla fine. Nessun avvio manuale, nessun monitoraggio richiesto.

Esiste anche una variante HTTP chiamata streamable-http, progettata per connessioni di lunga durata con streaming:

[[mcp_servers]]
name = "my_stream_server"
transport = "streamable-http"
url = "http://localhost:9000/mcp"

Esempio pratico: aggiungere il recupero web

Uno dei server MCP più utili è mcp-server-fetch, che permette a Vibe di leggere il contenuto delle pagine web. Bastano tre righe di configurazione:

# ~/.vibe/config.toml

[[mcp_servers]]
name = "fetch"
transport = "stdio"
command = "uvx"
args = ["mcp-server-fetch"]

L’impatto sul tuo flusso di lavoro quotidiano è immediato. Ora puoi fare richieste che presuppongono una lettura esterna:

Leggi la documentazione di FastAPI su fastapi.tiangolo.com e riassumimi gli endpoint di sicurezza

L’agente chiama automaticamente lo strumento fetch dal server MCP per ottenere la pagina, quindi ne analizza il contenuto. Non devi aprire un browser né incollare frammenti di documentazione nel terminale.

Filtrare gli strumenti MCP

Questa comodità ha un rovescio della medaglia. Ogni server che aggiungi porta con sé il proprio set di strumenti e, con tre o quattro server attivi, il catalogo diventa disordinato. Il filtraggio ti permette di mantenere solo ciò che è rilevante:

# Abilita solo gli strumenti da un server specifico
enabled_tools = ["fetch_*"]

# Disabilita tutti gli strumenti MCP tranne quelli esplicitamente abilitati
disabled_tools = ["mcp_*"]

Il filtraggio con caratteri jolly serve a due scopi contemporaneamente. Rafforza la sicurezza limitando ciò che l’agente è autorizzato a fare e previene il sovraccarico del contesto del modello: un elenco di strumenti troppo lungo consuma prezioso contesto e degrada la qualità delle decisioni dell’agente.

Configurazione avanzata con autenticazione

I server MCP aziendali richiedono quasi sempre l’autenticazione. Per un token, la tabella [mcp_servers.auth] in modalità static legge la chiave da una variabile d’ambiente il cui nome fornisci, per poi inserirla nell’header di tua scelta:

[[mcp_servers]]
name = "internal_api"
transport = "http"
url = "https://mcp.your-company.com"

[mcp_servers.auth]
type = "static"
api_key_env = "MCP_API_TOKEN"        # nome della variabile, non il token stesso
api_key_header = "Authorization"     # valore predefinito
api_key_format = "Bearer {token}"    # valore predefinito

Per un server che offre il login OAuth, come quello di Linear, imposta type = "oauth" ed effettua il login durante la sessione con /mcp login <nome>: Vibe apre il tuo browser e memorizza i token nel portachiavi di sistema, mai in config.toml. Il comando vibe mcp add gestisce tutto questo dal terminale: vibe mcp add linear --url https://mcp.linear.app/mcp aggiunge il server e avvia il flusso di login.

Il vantaggio è semplice: puoi versionare e condividere il tuo file config.toml con il tuo team senza codificare rigidamente alcun segreto, poiché ogni sviluppatore fornisce il proprio token attraverso il proprio ambiente.

Server MCP popolari

Diversi server pronti all’uso coprono le esigenze più comuni e vengono tutti dichiarati allo stesso modo in config.toml. mcp-server-fetch gestisce il recupero di pagine web e API; mcp-server-filesystem espande le operazioni sui file oltre gli strumenti integrati; mcp-server-git porta un’integrazione Git avanzata con diff, blame e log; mcp-server-sqlite e mcp-server-postgres abilitano l’interrogazione di database SQLite e PostgreSQL. Un agente in grado di leggere sia lo schema di un database sia il codice che lo utilizza individua incongruenze che la sola lettura dei file non rivelerebbe mai.

Durante una sessione, /mcp elenca i server e /mcp <nome> elenca i loro strumenti; /mcp status mostra lo stato di ciascuno. L’agente ti indica anche quali strumenti sta utilizzando nelle sue risposte, che rimane il modo migliore per verificare che un server funzioni effettivamente.

Sicurezza dei server MCP

Un server MCP viene eseguito con le tue autorizzazioni e vede ciò che gli dai: aggiungi solo server fidati, perché un server dannoso potrebbe esporre dati dal tuo codebase. Quindi limita le autorizzazioni con enabled_tools invece di concedere l’accesso completo per impostazione predefinita.

Due abitudini completano questa routine di igiene. Controlla i tuoi header: nessun token dovrebbe apparire in chiaro in config.toml; è esattamente a questo che serve api_key_env. E per gli strumenti locali, preferisci il trasporto STDIO, che è più sicuro di un server HTTP esposto sulla rete, se non altro perché non apre alcuna porta.

Punti chiave

  • MCP ti permette di aggiungere strumenti esterni a Vibe tramite un protocollo standardizzato
  • Due trasporti principali: HTTP (server persistente) e STDIO (processo locale)
  • Il filtraggio degli strumenti (enabled_tools, disabled_tools) controlla ciò che l’agente può utilizzare
  • Le variabili d’ambiente negli header proteggono i segreti
  • Aggiungi solo server MCP fidati e limita le loro autorizzazioni