--- lastModified: 2026-11-13 title: Aggiungi il tuo server MCP description: Collega un server MCP remoto tramite URL e scegli cosa può fare l'Agent Runner con ciascuno dei suoi strumenti. seo: description: "Collega il tuo server MCP remoto a Runner tramite URL, con o senza chiave API, e imposta ogni strumento su Consenti, Chiedi prima o Disattivato prima che l'Agent possa usarlo." --- 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 1. Apri il progetto e seleziona **Agente → Strumenti**. 2. Nella riga **Aggiungi il tuo server MCP**, seleziona **Aggiungi server**. 3. 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. 4. Facoltativo: inserisci un **Nome**. Se lo lasci vuoto, Runner usa il nome del server. Runner mostra questo nome in chat quando usa uno strumento. 5. 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. 6. **Quali agenti possono usarlo** mostra **Tutti gli agenti**. Puoi cambiarlo per ogni agente in seguito. 7. Seleziona **Mi fido di questo server**. 8. Seleziona **Collega e trova strumenti**. Runner si collega al server ed elenca i suoi strumenti. 9. 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. ## Guide correlate - [Connetti e controlla le app Agent](./agent-apps) - [Panoramica di app e integrazioni](../apps-and-integrations) - [Risolvi i problemi di connessione di un'app](./troubleshooting)