Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Aggiungi un connettore MCP personalizzato

Lezione 11 di 14 Aggiornata il 2 novembre 2026 Intermedio
In questa pagina
  1. Oltre la directory ufficiale
  2. Il processo di aggiunta
  3. Metodi di autenticazione
  4. Prerequisiti per il tuo server MCP
  5. Test con MCP Inspector
  6. Gestione organizzativa
  7. Sicurezza dei connettori personalizzati
  8. 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 disponibile nella modalità Chat; nella modalità Work, gli agenti sono ora competenze (invocate con @), le memorie fungono da base di conoscenza e la ricerca approfondita è 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.

Oltre la directory ufficiale

I connettori integrati coprono molti casi d’uso, ma la tua organizzazione probabilmente si affida a strumenti interni, API proprietarie o servizi di nicchia assenti dalla directory di Vibe. È qui che entrano in gioco i connettori personalizzati: puoi aggiungere qualsiasi server MCP remoto a Vibe semplicemente fornendone l’URL. Quel CRM interno sviluppato sei anni fa diventa utilizzabile in una conversazione, proprio come GitHub o Notion.

Il processo di aggiunta

Aggiungere un connettore richiede solo pochi clic nell’interfaccia. Apri la scheda Connettori, clicca su Add a custom connector in fondo all’elenco e compila i dettagli richiesti:

  • Name: un nome descrittivo per identificare il connettore (ad esempio, “CRM Interno” o “API Meteo”)
  • Server URL: l’indirizzo pubblico del tuo server MCP, incluso l’endpoint /mcp (ad esempio, https://mon-serveur.example.com/mcp)
  • Description: una breve spiegazione di ciò che fa il connettore (opzionale ma consigliata)
  • Authentication method: Nessuno, Token o OAuth 2.0

Infine, clicca su Create per salvare il connettore. Vibe interroga automaticamente il server per scoprire gli strumenti disponibili: appare l’elenco delle funzioni esposte e puoi iniziare a usarle nelle tue conversazioni.

Questa richiesta di scoperta restituisce il name, la description testuale, i parameters attesi (con nome, tipo e descrizione) e il return type per ogni strumento. Questi sono gli unici dettagli che il modello Mistral utilizza per decidere quando e come invocare ogni strumento, motivo per cui la prossima lezione si concentra fortemente sulla qualità della descrizione. Uno strumento ben scritto con una descrizione scarsa rimane invisibile al modello.

Metodi di autenticazione

Il caso più semplice è nessuna autenticazione: il tuo server MCP è accessibile a chiunque ne conosca l’URL. Questo funziona per strumenti pubblici che non gestiscono dati sensibili, prototipi, demo e server MCP che avvolgono API pubbliche. L’autenticazione tramite token prevede la fornitura di una chiave inviata con ogni richiesta al server; Vibe archivia il token in modo sicuro. Scegli questa opzione per API interne protette da una chiave API, server che devono identificare il chiamante e qualsiasi scenario in cui desideri limitare l’accesso. Infine, c’è OAuth 2.0, il flusso completo con reindirizzamento alla pagina di autorizzazione del servizio: è il meccanismo più sicuro ma anche il più complesso da implementare lato server e sarà trattato in profondità nelle future guide di Mistral AI.

Prerequisiti per il tuo server MCP

Cosa richiede Vibe da un server MCP
  • Accessibile tramite un URL pubblico (no localhost)
  • Espone un endpoint in formato Streamable HTTP (/mcp)
  • Risponde alle richieste di tool discovery nel formato JSON MCP standard
  • Gestisce correttamente le tool calls e restituisce i risultati nel formato previsto

Il requisito dell’URL pubblico potrebbe sembrare un ostacolo allo sviluppo locale, ma esiste una soluzione durante la fase di debug. Se stai sviluppando sulla tua macchina e vuoi testare con Vibe prima del deploy, apri un tunnel verso il tuo server locale utilizzando ngrok:

ngrok http 8000

ngrok ti fornisce un URL pubblico temporaneo che puoi usare come URL del connettore in Vibe. Questo approccio è ideale per lo sviluppo e il testing: modifichi il codice, riavvii e Vibe vede immediatamente la nuova versione senza alcun deploy.

Test con MCP Inspector

Prima di aggiungere il tuo server a Vibe, testalo con MCP Inspector, uno strumento open source che verifica che il tuo server risponda correttamente alle richieste di scoperta, elenchi gli strumenti disponibili con le loro descrizioni e parametri, esegua manualmente le chiamate agli strumenti per controllare i risultati e aiuti a debuggare problemi di formattazione o di tipo. Avvialo con un semplice comando npx:

npx @modelcontextprotocol/inspector

Inspector apre un’interfaccia web locale dove colleghi il tuo server MCP e testi ogni strumento individualmente. Questo passaggio non è una semplice formalità: ti evita di bruciare messaggi di conversazione nel debug e isola chiaramente gli errori del server dagli errori di interpretazione del modello.

Gestione organizzativa

Se fai parte di un’organizzazione su Vibe, nota che i connettori personalizzati che aggiungi sono visibili agli altri membri. Un amministratore può disabilitare qualsiasi connettore per l’intera organizzazione se lo ritiene inappropriato o insicuro. Tuttavia, ogni utente deve fornire le proprie credenziali (token o OAuth) per i connettori che richiedono autenticazione: condividere un connettore non significa mai condividere le credenziali di accesso.

Sicurezza dei connettori personalizzati

A differenza dei connettori ufficiali validati da Mistral AI, un connettore personalizzato può eseguire codice arbitrario lato server e la descrizione testuale che vedi non garantisce nulla su ciò che il server fa effettivamente. Attieniti a server che hai sviluppato tu stesso, quelli di colleghi o partner fidati e server open source il cui codice hai verificato. Anche con i tuoi connettori, mantieni abilitata la validazione umana durante tutta la fase di debug; una volta certo che tutto funzioni, puoi considerare di impostare gli strumenti di sola lettura su “Always Allow”.

Punti chiave

  • Puoi aggiungere qualsiasi server MCP remoto come connettore personalizzato in Vibe
  • Il server deve essere accessibile tramite un URL pubblico con un endpoint /mcp
  • Sono supportati tre metodi di autenticazione: nessuno, token e OAuth 2.0
  • Usa ngrok per testare il tuo server locale con Vibe prima del deploy
  • MCP Inspector è essenziale per il debug del tuo server prima dell’integrazione
  • Aggiungi solo connettori da fonti fidate e mantieni abilitata la validazione umana