Aggiungi un server Model Context Protocol (MCP) al tuo agente come strumento (GitHub Copilot) (anteprima)

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

Il Model Context Protocol (MCP) è uno standard per l'esposizione degli strumenti a un agente. Quando aggiungi un server MCP al tuo agente, l'agente può utilizzare ogni strumento che il server espone durante una conversazione.

Usa questo tutorial quando vuoi aggiungere un server MCP a un agente basato su GitHub Copilot harness. Per una panoramica dei tipi di strumenti, vedi Strumenti disponibili per agenti (GitHub Copilot).

La scheda MCP nella finestra di dialogo Aggiungi uno strumento elenca i server MCP già pubblicati per la tua organizzazione, come i servizi Microsoft 365, Foundry IQ e Fabric IQ.

  1. Accedi a Copilot Studio e apri il tuo agente.

  2. Nella barra di navigazione agente, seleziona la scheda Build .

  3. Nel pannello componenti a destra, seleziona Tools, poi Add tool.

  4. Nella finestra di dialogo Aggiungi uno strumento , seleziona la scheda MCP e poi seleziona un server.

  5. Nella pagina dettagliata del server, consulta la descrizione e, se disponibile, il link Docs per informazioni su cosa fa il server. Selezionare Aggiungi.

  6. Cosa succede dopo dipende dal server:

    • Alcuni server (ad esempio, server Microsoft 365 di prima parte come Mail) si connettono automaticamente usando la tua identità di accesso e il server viene aggiunto direttamente.
    • Altri server ti chiedono di creare una connessione, con campi specifici per quel server (ad esempio, un nome visualizzato e un tipo di autenticazione, o un URL dell'endpoint e una chiave API). Fornisci i valori richiesti e seleziona Crea.

    Questi valori sono specifici per ogni server. Usa il link Docs del server, se disponibile, per i dettagli della configurazione.

Poiché ogni server può richiedere valori di connessione diversi e cambiare indipendentemente da Copilot Studio, questo articolo non elenca i campi per ogni server. Affidati alla descrizione nel prodotto e al link Docs per il server che stai aggiungendo.

Aggiungi un server MCP personalizzato tramite URL

Usa questo percorso per collegare un server MCP che non sia già pubblicato nella galleria.

Prerequisites

Aggiungi un server MCP dalla scheda Build

  1. Accedi a Copilot Studio e apri il tuo agente.

  2. Nella barra di navigazione agente, seleziona la scheda Build .

  3. Nel pannello componenti a destra, seleziona Strumenti.

  4. Nella finestra di dialogo Aggiungi uno strumento, seleziona Aggiungi accanto alla barra di ricerca, e poi seleziona Model Context Protocol (MCP).

  5. Nella pagina Aggiungi server MCP , inserisci i seguenti dettagli:

    • Nome: un nome breve e descrittivo che aiuta l'agente a decidere quando utilizzare gli strumenti di questo server. Questo nome è quello che l'agente vede.
    • Descrizione: un riassunto di una o due frasi di ciò che fa il server e quando l'agente dovrebbe utilizzarlo.
    • URL del server: l'endpoint HTTPS del server MCP.
    • Autenticazione: scegliere il metodo di autenticazione richiesto dal server e inserire le credenziali o i valori di configurazione necessari a quel metodo.

  6. Seleziona Aggiungi per connetterti.

    Copilot Studio contatta il server MCP, negozia il protocollo handshake e poi elenca gli strumenti che il server espone.

  7. Rivedi l'elenco degli strumenti che appaiono.

    Per ogni strumento, verifica nome e descrizione. Se uno strumento non ha una descrizione chiara, le risposte degli agenti che coinvolgono lo strumento sono meno affidabili. Chiedi all'autore del server MCP di migliorare la descrizione prima di affidarti allo strumento in produzione.

  8. Seleziona Salva per completare l'aggiunta del server.

Il server appare nell'elenco Strumenti dell'agente nella scheda Build .

Testare il server

Dopo aver aggiunto il server, testalo prima di pubblicare l'agente.

  1. Seleziona la scheda Anteprima .

  2. Fai all'agente una domanda che richiede uno degli strumenti del server.

  3. Esaminare la risposta dell'agente. Apri la traccia di attività per verificare quale strumento è stato invocato, quali argomenti sono stati passati e cosa ha restituito lo strumento. Consulta Usa la traccia di attività per eseguire il debug del tuo agente.

Se l'agente non invoca lo strumento quando ti aspetteresti che lo facesse, affina il nome del server, la descrizione del server o le istruzioni dell'agente. I nomi e le descrizioni degli strumenti individuali provengono dal server MCP stesso. Se devono cambiare, chiedi all'autore del server MCP di aggiornarli. Per altre informazioni, vedere Configurare i dettagli dell'agente e le istruzioni.

Gestisci il server dopo averlo aggiunto

Per rimuovere un server MCP o spegnere temporaneamente uno, usa il flusso standard di gestione degli strumenti. Scopri di più su Gestisci e elimina gli strumenti in un agente (GitHub Copilot).

Se l'URL, l'autenticazione o gli strumenti esposti di un server cambiano dopo averlo aggiunto, modifica la voce del server nella stessa finestra di dialogo Strumenti per aggiornare la connessione e rileggi la lista degli strumenti.

Limits

  • Ogni agente può connettersi a più server MCP, ma il numero totale di istanze di server MCP che si eseguono contemporaneamente in una singola conversazione è limitato. Se attacchi più server MCP di quanti il limite consenta e l'agente cerca di usarli tutti nello stesso turno, i server extra vengono saltati e i loro strumenti non sono disponibili per quel turno.
  • Mantieni piccolo il numero di server MCP collegati a un singolo agente, e rimuovi i server che non usi più, così l'agente avrà spazio per attivare i server che ti interessano.
  • Ogni server MCP viene conteggiato nel numero totale di strumenti che un agente può ospitare.
  • Ultimo aggiornamento: