Utilizzo dei server MCP in Vibe
In questa pagina
Dalla configurazione all’uso reale
La Lezione 8 ti ha mostrato come dichiarare i server MCP nel file config.toml. Il file è scritto, i server rispondono, ma resta la domanda fondamentale per il lavoro quotidiano: come cambia concretamente il tuo flusso di lavoro? È proprio questo l’argomento della lezione.
Dare accesso al Web
Il primo server da installare è mcp-server-fetch, perché elimina la limitazione più fastidiosa di un agente locale: l’ignoranza di tutto ciò che non si trova sul tuo disco. Una volta configurato, Vibe può leggere qualsiasi pagina web.
Leggi la documentazione delle API di Stripe sui webhook e riassumimi i passaggi per l'implementazione
Recupera il contenuto di questa issue su GitHub: https://github.com/org/repo/issues/42
Controlla l'ultima versione disponibile della libreria fastapi su pypi.org
Nota che in nessun momento hai specificato quale strumento utilizzare. L’agente chiama lo strumento fetch autonomamente non appena rileva la necessità di un URL o di un riferimento web; è il contesto della tua richiesta a guidare la decisione, non un’istruzione esplicita da parte tua.
Interrogare i tuoi dati
Lo stesso principio vale per un database tramite un server MCP SQLite o PostgreSQL. La dichiarazione rimane concisa:
# Configurazione in config.toml
[[mcp_servers]]
name = "db_locale"
transport = "stdio"
command = "uvx"
args = ["mcp-server-sqlite", "--db-path", "./data/app.db"]
In una sessione, poni quindi domande di business, non query SQL: «Mostrami i 10 utenti registrati più di recente con le relative date di creazione» oppure «Quanti ordini sono stati effettuati questo mese? Raggruppali per stato». L’agente scrive la query, la esegue e restituisce un risultato leggibile. SQL diventa un dettaglio implementativo.
Comporre più server
La vera potenza di MCP emerge quando due server lavorano all’interno dello stesso scambio. Con fetch e SQLite attivi simultaneamente, una richiesta come questa coinvolge entrambi:
Confronta i dati del nostro database con la documentazione ufficiale delle API.
Ci sono campi mancanti nel nostro schema?
Vibe legge la documentazione tramite il server fetch, ispeziona il tuo schema tramite il server SQLite e quindi incrocia le due fonti. Due flussi di lavoro comuni si basano su questa composizione. Primo, il monitoraggio tecnologico:
1. Recupera le ultime release di React su GitHub
2. Confrontale con la versione nel nostro package.json
3. Se è disponibile un aggiornamento maggiore, riassumi le modifiche incompatibili (breaking changes)
L’agente concatena la chiamata al server fetch per GitHub, legge il file locale package.json ed esegue l’analisi, senza che tu debba scomporre la richiesta. L’audit delle dipendenze segue la stessa logica, con un’iterazione aggiuntiva:
Per ogni dipendenza in @package.json, controlla su npm le vulnerabilità note
e genera un report
Vibe scorre le dipendenze una per una, chiama il server fetch per ciascuna e compila i risultati in un unico report.
Sapere cosa è disponibile e diagnosticare i guasti
Durante una sessione, non devi indovinare quali strumenti MCP sono attivi. Ogni volta che Vibe ne utilizza uno, indica chiaramente nel suo output il server e lo strumento invocati, che puoi visualizzare premendo Ctrl+O. Puoi anche chiedere direttamente: «Quali strumenti fornisce il server MCP ‘fetch’?».
Quando un server smette di rispondere o restituisce un errore, Vibe te lo comunica esplicitamente. Quattro cause coprono la maggior parte dei casi.
| Causa | Cosa controllare |
|---|---|
| Server non avviato | Per i trasporti HTTP, assicurati che il servizio sia in esecuzione |
| Timeout | Il server impiega troppo tempo a rispondere: aumenta il timeout nella configurazione se necessario |
| Autenticazione | Assicurati che header e token siano corretti |
| Strumento non trovato | Assicurati che il nome dello strumento nel filtro corrisponda a quello esposto dal server |
Per i trasporti STDIO, la questione dell’avvio non si pone: Vibe gestisce autonomamente il ciclo di vita del server e, se il processo si arresta in modo anomalo, tenta di riavviarlo.
Mantenere le sessioni veloci
Ogni server MCP attivo aggiunge i suoi strumenti al contesto dell’agente; non noterai l’impatto finché non ne avrai otto. Gli effetti sono meccanici: il tempo di risposta aumenta perché il modello deve arbitrare tra più opzioni e il costo per richiesta sale perché tutte queste definizioni di strumenti consumano token nel contesto fatturabile. La regola è semplice: attiva solo i server utili per la sessione corrente.
Quando ti interessa solo una parte di ciò che un server espone, il filtraggio è preferibile alla disattivazione completa:
# Usa solo lo strumento fetch dal server, non gli altri
enabled_tools = ["fetch_fetch"]
Infine, preferisci STDIO per qualsiasi cosa eseguita in locale. Vibe avvia e arresta automaticamente questi server: non devi mantenere alcun servizio in background né riavviarli dopo un riavvio del sistema.
Punti chiave
- I server MCP estendono Vibe con capacità web, database e altre ancora
- L’agente sceglie automaticamente quale strumento MCP usare in base al contesto
- Più server MCP possono essere combinati in un unico flusso di lavoro
- Limita il numero di server attivi per mantenere le prestazioni
- Il filtraggio degli strumenti consente un controllo granulare sulle capacità disponibili