Passa al contenuto principale

Client MCP

Il Model Context Protocol (MCP) è uno standard aperto per rendere disponibili strumenti ai modelli AI. Molti servizi offrono un server MCP e può scriverne uno Lei stesso. Un client MCP AI collega MonoChat a un server MCP, così gli strumenti offerti da quel server possono essere messi a disposizione dei Suoi nodi AI e dei Suoi agenti AI, accanto alle funzioni Strumento AI che scrive in MonoChat.

Li gestisce in Impostazioni › Automazione › Client MCP AI.

Come funziona​

  1. Aggiunge l'indirizzo del server MCP e si collega. MonoChat legge ciò che il server offre: i suoi Strumenti, Risorse, Modelli di risorse e Prompt.
  2. Quando salva, MonoChat conserva quell'elenco come contenuto del client.
  3. In un nodo Crea completamento chat AI o in un nodo Agente AI sceglie gli strumenti che desidera per quel nodo e può riscrivere la descrizione di ogni strumento per il modello.
  4. Durante la conversazione il modello decide quando chiamare uno strumento; MonoChat chiama il server MCP e restituisce il risultato al modello.

Solo gli strumenti che aggiunge a un nodo sono disponibili per quel nodo, così ogni nodo vede solo ciò che gli serve.

Aggiungere un client MCP​

  1. Vada in Impostazioni › Automazione › Client MCP AI e faccia clic su + (Crea).

  2. Compili i campi:

    CampoDescrizione
    NomeUn nome per il server, mostrato accanto a ciascuno dei suoi strumenti nei pannelli dei nodi.
    DescrizioneNote facoltative.
    VersioneLa versione del client che MonoChat comunica al server quando si collega, ad esempio 1.0.0.
    EndpointL'URL di base del server MCP. MonoChat si collega con il trasporto SSE all'indirizzo <Endpoint>/sse, quindi inserisca l'indirizzo senza /sse.
    Tipo di autenticazioneNessuno, Basic (con Nome utente e Password) oppure Bearer (con Token). Le credenziali vengono salvate con il client.

  3. Faccia clic su Collega. MonoChat si collega al server e mostra in schede ciò che ha trovato:

    • Informazioni sul server: Nome, Versione, Versione del protocollo e Istruzioni del server.
    • Strumenti: nome e descrizione di ogni strumento.
    • Risorse, Modelli di risorse e Prompt, se il server ne offre.

  4. Se l'elenco Le sembra corretto, faccia clic su Salva. Per cambiare l'indirizzo e riprovare, faccia clic sul pulsante Disconnetti accanto ad esso.

suggerimento

Se Collega non riesce, verifichi che l'endpoint sia raggiungibile da internet, che il server supporti il trasporto SSE e che l'URL non termini già con /sse.

Aggiornare l'elenco degli strumenti​

Quando il server MCP aggiunge o modifica strumenti, apra il client con Aggiorna. MonoChat si collega di nuovo e mostra il contenuto attuale; faccia clic su Aggiorna per salvare il nuovo elenco.

L'eliminazione di un client ne rimuove anche il contenuto, quindi i nodi perdono gli strumenti che provenivano da esso.

Assegnare strumenti a un nodo​

Nodo Crea completamento chat AI​

  1. Apra il nodo e scorra fino a Impostazioni dello strumento contenuti client MCP AI.
  2. Faccia clic su Imposta gli strumenti contenuti client MCP AI. Il pannello Strumenti contenuti client MCP AI elenca gli strumenti già aggiunti a questo nodo.
  3. Faccia clic su + (Crea), poi scelga uno strumento in Strumenti contenuti client MCP AI. Gli strumenti sono elencati come <client name> - <tool name>.
  4. La Descrizione viene compilata con la descrizione dello strumento stesso. La modifichi se vuole indicare al modello con più precisione quando usare lo strumento, ad esempio "Usalo per cercare un ordine tramite il suo numero". La descrizione è obbligatoria.
  5. Ripeta per ogni strumento, poi salvi il nodo.

Nello stesso pannello può aggiornare la descrizione di uno strumento o rimuoverlo dal nodo.

Nodo Agente AI​

Il nodo Agente AI ha lo stesso pulsante Imposta gli strumenti contenuti client MCP AI nella sezione Impostazioni dello strumento. Gli strumenti MCP selezionati vengono offerti all'agente insieme agli ambiti AI e agli strumenti AI del nodo, su ogni harness. Vedere Agenti AI.

informazioni

Un'esecuzione dell'agente verifica che ogni strumento MCP del nodo esista ancora nel Suo workspace. Se elimina un client MCP usato da un nodo, le esecuzioni di quel nodo non riescono con "Un ambito AI o uno strumento MCP non è stato trovato in questo workspace." finché non rimuove lo strumento dal nodo.

Permessi​

L'accesso è controllato dai permessi di ruolo Leggere / Creare / Aggiornare / Eliminare client MCP AI nell'automazione e Leggere i contenuti dei client MCP AI nell'automazione. Vedere Ruoli.