Aggiungi il tuo server MCP

Collega un server MCP remoto tramite URL e scegli cosa può fare l'Agent Runner con ciascuno dei suoi strumenti.

Se un servizio che usi ha un server MCP, puoi dare i suoi strumenti all’Agent Runner. Incolla l’URL del server. Runner trova gli strumenti del server. Poi scegli cosa può fare l’Agent con ogni strumento.

Usalo per un servizio che non è in Collega i tuoi strumenti, come il tuo ERP, un sistema di magazzino o uno strumento gestito dal tuo team.

Prima di iniziare

Percorso di accesso: Progetto → Agente → Strumenti → Aggiungi il tuo server MCP

Ti servono:

il ruolo di proprietario del negozio o di amministratore. Gli altri membri non possono aggiungere, modificare o rimuovere un server;
l’URL di un server MCP remoto, ad esempio https://example.com/mcp; e
la chiave API e il nome del suo header, se il server richiede una chiave.

Il server deve rispettare queste condizioni:

Deve essere su internet pubblico. Runner non si collega a localhost né a un indirizzo di rete privata.
Deve usare il trasporto HTTP di MCP (Streamable HTTP). Runner non esegue per te un server locale da riga di comando (stdio).
Deve funzionare senza accesso o con una chiave API in un header della richiesta. OAuth non è ancora disponibile.

Un negozio può avere fino a 10 server MCP. Runner conserva fino a 100 strumenti per ogni server.

Importante: Runner non può controllare cosa fa un server personalizzato con i tuoi dati. Aggiungi solo server che gestisci o conosci bene.

Aggiungi un server

Apri il progetto e seleziona Agente → Strumenti.
Nella riga Aggiungi il tuo server MCP, seleziona Aggiungi server.
Inserisci l’URL del server. Oppure incolla la configurazione JSON dalla documentazione del server in Incolla configurazione JSON. Runner compila l’URL e l’header della chiave a partire dalla configurazione.
Facoltativo: inserisci un Nome. Se lo lasci vuoto, Runner usa il nome del server. Runner mostra questo nome in chat quando usa uno strumento.
In Come accede Runner, seleziona Nessun accesso o Chiave API. Per Chiave API, inserisci il Nome dell’header e la Chiave, ad esempio Authorization e Bearer sk-…. Runner salva la chiave cifrata. Nessuno, nemmeno tu, può rileggerla.
Quali agenti possono usarlo mostra Tutti gli agenti. Puoi cambiarlo per ogni agente in seguito.
Seleziona Mi fido di questo server.
Seleziona Collega e trova strumenti. Runner si collega al server ed elenca i suoi strumenti.
Scegli una regola per ogni strumento. Poi seleziona Aggiungi seguito dal nome del server.

Quando il server è aggiunto, compare in Collegati con l’etichetta MCP personalizzato.

Scegli cosa può fare ogni strumento

Ogni strumento ha una di tre regole:

Consenti: l’Agent usa lo strumento senza chiedertelo.
Chiedi prima: l’Agent ti mostra la chiamata in chat. Lo strumento viene eseguito solo dopo la tua approvazione.
Disattivato: l’Agent non può usare lo strumento.

Runner deduce una regola iniziale dal nome di ogni strumento e raggruppa gli strumenti in base a quella regola:

Gruppo	Regola iniziale	Nomi di strumenti che Runner mette qui
Legge dati	Consenti	Nomi che iniziano con una parola di lettura, come `list`, `get` o `search`. Anche ogni nome che Runner non riconosce.
Modifica dati	Chiedi prima	Nomi che contengono `send`, `reply`, `remove`, `publish`, `pay`, `charge`, `refund` o `price`.
Elimina dati	Disattivato	Nomi che contengono `delete` o `trash`.

Controlla la regola di ogni strumento prima di aggiungere il server. Runner legge solo il nome dello strumento, non quello che fa. Uno strumento come update_inventory o create_customer parte da Consenti in Legge dati, quindi l’Agent potrebbe modificare dati senza chiedertelo. Imposta strumenti come questi su Chiedi prima o Disattivato.

Puoi cambiare la regola di qualsiasi strumento prima di aggiungere il server. In seguito, cambiala in Cosa può fare ogni agente nella pagina del server. Uno strumento che il server aggiunge in seguito parte da Chiedi prima, oppure da Disattivato se il suo nome contiene delete o trash.

Le regole valgono per ogni chat di questo progetto. Runner le controlla a ogni chiamata di uno strumento.

Gestisci un server

Apri il server da Collegati in Agente → Strumenti. La sua pagina ha questi controlli:

Controllo o informazione	Cosa fa
URL del server e pulsante di copia	In Connessione. Copia l’URL del server copia l’URL.
Stato	Mostra quando il server ha risposto l’ultima volta, oppure Non ancora controllato.
Accesso	Mostra Nessun accesso o gli ultimi quattro caratteri della chiave. Aggiungi chiave o Sostituisci cambia la chiave.
Prova connessione o Aggiorna strumenti	Si ricollega al server e recupera l’elenco attuale degli strumenti. I nuovi strumenti partono da Chiedi prima, oppure da Disattivato se sono strumenti di eliminazione.
Rimuovi server	Rimuove il server. Gli agenti perdono i suoi strumenti e le regole dei suoi strumenti vengono eliminate. Puoi aggiungerlo di nuovo in seguito.

Se qualcosa va storto

Messaggio	Cosa fare
Inserisci l’URL completo del server, ad esempio https://example.com/mcp.	Inserisci l’URL completo, percorso incluso.
Runner può raggiungere solo server pubblici. Questo URL punta a una rete privata.	Usa un URL raggiungibile da internet.
Questo URL ha risposto, ma non come server MCP. Controlla il percorso.	Cerca il percorso MCP nella documentazione del server. Spesso termina con `/mcp`.
Runner non riesce a raggiungere questo server. Controlla l’URL e che sia online.	Verifica che il server sia attivo e che l’URL sia corretto.
Il server ha rifiutato la chiave. Controlla il nome dell’header e la chiave.	Controlla entrambi i valori. Alcuni server richiedono `Bearer` prima della chiave.
Il server ha risposto ma non ha strumenti.	Il server non ha strumenti per questa chiave. Controlla le impostazioni del server.
Questo negozio ha già il numero massimo di server MCP. Rimuovine uno prima.	Rimuovi un server che non usi.

In Collegati, un server che ha smesso di funzionare mostra Non raggiungibile o Chiave rifiutata. Seleziona Correggi per aprire il server, poi sostituisci la chiave o controlla il server.