Integrare un Server Personalizzato in Vibe
In questa pagina
Aggiornamento 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; tieni presente che alcuni menu qui descritti potrebbero aver cambiato nome o posizione.
Connetti il tuo Server MCP a Vibe
Il tuo server è distribuito e risponde via HTTPS a un indirizzo stabile. Ora arriva il passo che dà senso a tutto il lavoro precedente: renderlo utilizzabile nelle conversazioni dal tuo pubblico target, inclusi coloro che non apriranno mai un terminale. Vibe accetta qualsiasi server MCP conforme come connettore personalizzato. Questa lezione copre l’aggiunta del connettore, l’analisi dei flussi di chiamata durante la conversazione e la diagnosi dei guasti, perché il primo tentativo spesso fallisce.
Aggiungere il Connettore
Apri Vibe all’indirizzo chat.mistral.ai e naviga nella scheda Connettori nella barra laterale. Troverai due sezioni distinte: i connettori in evidenza, preconfigurati da Mistral (GitHub, Notion e altri), e i tuoi connettori personalizzati, inizialmente vuoti. Clicca su Aggiungi Connettore Personalizzato e compila i campi:
- Nome: Un nome descrittivo (es. “Gestore Attività”)
- URL Server: L’URL completo del tuo endpoint MCP (es.
https://my-server.com/tasks/mcp) - Descrizione: Cosa fa il tuo server (opzionale ma raccomandato)
Successivamente, scegli il tuo metodo di autenticazione: Nessuna autenticazione per un server pubblico, Token se incolli il tuo token API, oppure OAuth 2.0 per un flusso di consenso completo. Cliccando su Connetti si avvia la scoperta: se ha successo, Vibe visualizza l’elenco degli strumenti trovati sul tuo server, mostrando nome e descrizione di ciascuno. Questo è il tuo primo vero feedback sulla qualità delle tue docstring: le leggi qui esattamente come le riceverà il modello.
Cosa Succede nella Conversazione
Una volta connesso, il tuo server appare nella sezione Strumenti della barra laterale della chat, contrassegnato da un’icona che indica la disponibilità di strumenti esterni. L’utente formula la sua richiesta in linguaggio naturale e il modello la traduce:
Utente: Crea un'attività ad alta priorità per preparare la demo MCP
Vibe: [Chiamata di create_task con i seguenti argomenti]
- title: "Preparare la demo MCP"
- priority: "high"
→ Vuoi autorizzare questa chiamata allo strumento?
Utente: [Autorizza]
Vibe: L'attività "Preparare la demo MCP" è stata creata con successo
con alta priorità. Il suo ID è abc123.
Questo prompt di conferma è il comportamento predefinito. Puoi approvarlo ad hoc o impostare un’autorizzazione permanente per uno strumento. Resisti alla tentazione di farlo per qualsiasi server che non possiedi. La conferma protegge non solo dai bug; è la tua unica difesa contro le iniezioni di prompt, dove istruzioni nascoste nei dati restituiti da uno strumento guidano il modello verso chiamate che nessuno ha richiesto. Vedere gli argomenti scorrere prima della validazione è ciò che ti permette di individuare l’anomalia.
Quando Non Funziona
Il messaggio “Impossibile connettersi” deriva quasi sempre da una di queste quattro cause: l’URL è irraggiungibile dall’esterno, il protocollo non è HTTPS (che Vibe richiede), il server semplicemente non è in esecuzione, oppure CORS non è configurato anche se Vibe invia richieste da un browser. Il seguente comando distingue tra le prime due ipotesi in pochi secondi:
# Test di accessibilità
curl -X POST https://your-url/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'
Se la connessione ha successo ma non appare alcuno strumento, traccia la catena a ritroso lato server: verifica che il decoratore @app.tool() sia presente su ogni funzione, che non manchino docstring e che il server MCP sia montato sulla route che pensi. Usa MCP Inspector prima di qualsiasi altra indagine.
Il caso più confuso è quando tutto funziona, ma il modello chiama lo strumento sbagliato o nessuno affatto. Il problema allora non è tecnico: il modello sceglie in base alle descrizioni e, se due strumenti sembrano simili o se uno rimane vago, sceglie male. Usa tre leve, in questo ordine: rendi la descrizione più specifica chiarendo il caso d’uso, rinomina lo strumento per rimuovere l’ambiguità e riduci il numero di strumenti attivi simultaneamente. Infine, se uno strumento restituisce un errore, controlla i log del server, ripeti la chiamata manualmente nell’inspector e verifica che le variabili d’ambiente siano impostate e che il token o gli scope OAuth concedano le autorizzazioni previste.
MCP Inspector: Usalo Prima di Vibe
L’inspector testa i tuoi strumenti senza coinvolgere il modello, isolando metà delle variabili del problema:
npx @modelcontextprotocol/inspector
Apre un’interfaccia web in cui ti connetti al tuo server remoto tramite il suo URL, elenchi tutti gli strumenti con le loro descrizioni e parametri, esegui uno strumento con argomenti a tua scelta e leggi la risposta grezza del server. Prendi l’abitudine di eseguire questo controllo sistematicamente prima di aggiungere un server a Vibe, poiché ti offre una diagnosi immediata: se uno strumento risponde correttamente nell’inspector ma fallisce in Vibe, la colpa non è del server e il problema risiede nella descrizione o nel prompt.
Gestire Più Server
Una volta installati diversi connettori, la disciplina diventa il fattore primario per la qualità. Vibe ti permette di attivare/disattivare ogni connettore: mantieni attivi solo gli strumenti necessari per l’attività corrente, perché un modello sommerso da cinquanta strumenti sceglie con meno accuratezza e risponde più lentamente. Questa igiene si basa sulla separazione dei domini trattata nella Lezione 10: un server per la gestione progetti, uno per il monitoraggio, uno per gli strumenti interni, poiché così devi attivare solo quello corrispondente alla conversazione corrente.
Infine, adatta i tuoi prompt alle capacità effettivamente esposte:
# Buono: riflette le capacità dello strumento
"Crea un'attività ad alta priorità intitolata 'Preparare la demo'"
# Cattivo: troppo vago, il modello non sa quale strumento usare
"Gestisci il mio progetto"
Un ultimo punto da conoscere prima di progettare i tuoi server: i connettori MCP configurati in Vibe rimangono disponibili sull’app mobile. I tuoi strumenti interni diventano così accessibili da un telefono, aprendo scenari di utilizzo sul campo che potresti non considerare sviluppando su desktop.
Punti chiave
- Aggiungere un connettore personalizzato in Vibe richiede 3 passaggi: nome, URL, auth
- Mantieni abilitata la conferma manuale delle chiamate agli strumenti per sicurezza
- Usa MCP Inspector per testare e debuggare prima di integrare in Vibe
- Migliora le descrizioni degli strumenti se il modello non li usa correttamente
- Mantieni attivi solo gli strumenti necessari per l’attività corrente
- I tuoi server MCP sono accessibili anche su mobile