22.3 Client MCP

The MCP Clients section is used to connect vtenext to an external or internal MCP server, allowing it to retrieve and use the available tools within processes and agents. In practice, this section is where you configure how to reach the MCP server, how to authenticate, and how to keep the list of available tools up to date.

In summary: the MCP client does not publish functions externally. It performs the opposite operation: it connects to an MCP server, retrieves its tools, and makes them available within vtenext.

When to use it

• To connect vtenext to an already available MCP server.
• To use the tools exposed by an MCP server within processes and agents (see AI Actions).
• To keep the list of available tools synchronized over time.
• To quickly connect an MCP server created in the MCP Servers section.

The List View

The list displays all previously configured MCP clients.

AttivoActive	indicaindicates sewhether ilthe client èis abilitatoenabled
NomeName	nomeinternal internoname conused cuito riconosciidentify lathe connessioneconnection
URL	indirizzoaddress delof the MCP server MCPto awhich cui ilthe client si collegaconnects
UltimaLast sincronizzazioneSynchronization	mostrashows quandowhen ithe tooltools sonowere statilast sincronizzatisynchronized, l'ultimaor volta,indicates oppurethat segnala che ilthe client nonhas ènever maibeen stato sincronizzatosynchronized

DallaFrom listathe puoilist, creareyou uncan nuovocreate a new client, modificarloedit oit, eliminarlo.or Sedelete ilit. If the client èis collegatoconnected ato unan internal MCP Server, MCPyou interno,can dallaalso listadirectly puoiopen anchethat aprireserver direttamentefrom quelthe server.list.

CreareCreating una nuovoNew MCP Client MCP

1. ApriOpen la sezionethe ClientMCP MCPClients section.

Click Add. FaiEnter clican sueasily recognizable AggiungiName. InserisciEnter unthe Nome facile da riconoscere. Indica l'URL delof serverthe MCP.MCP server. ScegliChoose il tipo dithe AutenticazioneAuthentication type. Fill in the required credentials, if applicable. Decide whether to enable Periodic Synchronization. CompilaEnable leNotifications credenzialiif richieste,you sewant previste.to be notified when tools change. DecidiSave sethe attivare la Sincronizzazione periodica. Attiva la Notifica se vuoi essere avvisato quando i tool cambiano. Salva la configurazione.configuration.

Importante:Important: alwhen salvataggiosaving, vtenext provaactually aattempts collegarsito davveroconnect alto serverthe MCP.MCP Seserver. laIf connessionethe nonconnection riesce,fails, lathe configurazioneconfiguration nonis vienenot accettata.accepted.

ParametriConfiguration da impostareParameters

AttivoActive	abilita o enables disabilitaor ildisables the client
NomeName	nomedescriptive descrittivoname dellaof connessionethe connection
URL	indirizzofull completoaddress delof the MCP server MCPto daconnect contattareto
AutenticazioneAuthentication	definiscedefines comehow ilthe client siauthenticates autenticawith althe MCP server MCP
Username eand Password	compaionodisplayed se scegli l'autenticazionewhen Basic Authentication is selected
API Key	comparedisplayed se scegli autenticazionewhen Bearer oppureor X-API-Key authentication is selected
SincronizzaSynchronize	permetteallows ad una cron dijob controllareto periodicamenteperiodically icheck toolthe disponibiliavailable etools aggiornarliand inupdate casothem diwhen novitànew ones are detected
NotificaNotification	inviasends unaa notificanotification quandowhen lasynchronization sincronizzazionedetects rilevachanges modifichein neithe toolserver's del servertools

Come funziona l'autenticazione

La scelta dell'autenticazione cambia i campi mostrati nella scheda.

Nessuna autenticazione	non vengono richieste credenziali aggiuntive
Basic	devi inserire username e password
Bearer	devi inserire un token o API key
X-API-Key	devi inserire la chiave API nel campo dedicato
VTE (Access Key)	vtenext usa automaticamente l'access key MCP dedicata dell'utente che effettua la chiamata. Non devi inserire manualmente credenziali

Quando usare VTE (Access Key): questa opzione è particolarmente utile quando il client punta a un Server MCP esposto da vtenext, perché permette al sistema di gestire l'autenticazione in modo automatico.

Verifica della connessione e mappatura dei tool

La schermata del client mette a disposizione anche una funzione di verifica.

Risultato della chiamata: RISULTATO

Risultato della chiamata: HEADERS

Risultato della chiamata: RISPOSTA

• Il pulsante di test controlla se il server MCP risponde correttamente.
• In caso di esito positivo, vtenext può leggere la lista dei tool disponibili.
• Dalla finestra di verifica puoi aggiornare la sezione dei tool disponibili con il comando Mappa tool disponibili.

Questa verifica è utile soprattutto quando stai configurando un nuovo server o quando vuoi controllare se l'autenticazione è corretta prima del salvataggio definitivo.

Tool disponibili

Dopo il salvataggio, oppure dopo la mappatura dalla verifica, vtenext mostra la lista dei tool letti dal server MCP.

Per ogni tool puoi vedere:

• nome del tool
• descrizione
• parametri di input
• campi obbligatori e facoltativi
• struttura dell'output restituito

Queste informazioni vengono salvate localmente, così i tool possono poi essere richiamati dentro gli agenti e i processi senza dover reinterpretare ogni volta la struttura del server remoto.

Sincronizzazione periodica

Se attivi Sincronizza, un processo schedulato può controllare periodicamente se sul server MCP sono disponibili tool nuovi o modificati.

• Se trova cambiamenti, aggiorna la configurazione locale dei tool.
• Se non trova differenze, aggiorna comunque la data dell'ultima sincronizzazione.
• Se hai attivato anche Notifica, ricevi un avviso quando il set dei tool cambia.

Attenzione: quando i tool cambiano sul server MCP, può essere necessario verificare eventuali processi o agenti che li usano, soprattutto se sono cambiati parametri o output.

Esempi pratici

Esempio 1: collegamento a un server MCP esterno

Puoi configurare un client MCP che punta a un server esterno pubblicato da un altro sistema. In questo caso inserisci URL, autenticazione richiesta e poi verifichi i tool disponibili.

Esempio 2: collegamento a un Server MCP di vtenext

Se hai già creato un Server MCP nella relativa sezione, puoi collegare il client allo stesso endpoint e usare l'autenticazione VTE (Access Key) per semplificare la configurazione.

Esempio 3: aggiornamento controllato dei tool

Se i tool del server remoto possono cambiare nel tempo, conviene attivare la sincronizzazione periodica e, se necessario, anche le notifiche, così mantieni allineati processi e agenti.

Web Search MCP - Exa

vtenext mette a disposizione anche un client MCP preconfigurato chiamato Web Search MCP - Exa. Questa voce viene creata automaticamente ma resta disattivata finché non decidi di usarla.

Exa è un servizio di ricerca web pensato per agenti AI. Permette di fare ricerche sul web in tempo reale, recuperare contenuti di pagine specifiche e fornire ai modelli informazioni più aggiornate rispetto alla sola conoscenza già incorporata nel modello.

Come attivarlo

1. Apri la scheda Web Search MCP - Exa nella lista dei Client MCP.
2. Lascia invariato l'URL precompilato, che punta al server MCP pubblico di Exa.
3. Imposta o completa l'autenticazione X-API-Key con la chiave API del tuo account Exa.
4. Attiva il client.
5. Salva e verifica i tool disponibili.

In questo caso l'autenticazione prevista da vtenext è X-API-Key, già selezionata nella configurazione iniziale del client.

Tool disponibili con Exa

Il server MCP espone questi tool:

• web_search_exa: esegue ricerche sul web e restituisce contenuti già pronti da usare da parte dell'agente.
• web_fetch_exa: recupera il contenuto completo di una pagina web a partire da un URL noto.

Quando può essere utile: Exa è particolarmente adatto quando vuoi dare agli agenti e ai processi accesso a ricerca web aggiornata, analisi di pagine online o raccolta rapida di informazioni esterne.

Per ulteriori dettagli sul servizio e sulle funzionalità del server MCP di Exa, consulta il sito ufficiale: https://exa.ai/mcp.