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

[Questo articolo è una documentazione preliminare ed è 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, ogni strumento che il server espone diventa disponibile per essere invocato durante una conversazione.

Note

Le funzionalità di questo articolo sono alimentate dal harness GitHub Copilot, che utilizza Copilot Credits per la fatturazione basata sull'uso. Scopri di più sui Crediti Copilot in Panoramica della fatturazione per agenti alimentati dal GitHub Copilot harness.

La fatturazione basata sull'uso si applica all'utilizzo, alla costruzione, al test e alla valutazione degli agenti. Queste azioni potrebbero consumare crediti Copilot.

Usa questo tutorial quando vuoi aggiungere un server MCP a un agente nella nuova esperienza. Per una panoramica dei tipi di strumenti nella nuova esperienza, vedi Strumenti disponibili per agenti.

Prerequisiti

  • Un agente creato nella nuova esperienza. Vedere Creare un agente.
  • L'URL di un server MCP raggiungibile da Copilot Studio. Se non ne hai ancora uno, consulta Crea un nuovo server Model Context Protocol (MCP).
  • Qualsiasi credenziali richiesta dal server (ad esempio, una chiave API o un ID client e un segreto per uno schema di autenticazione supportato).

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 aspetti, affina il nome dello strumento, la descrizione dello strumento o le istruzioni dell'agente. Vedi Configura dettagli e istruzioni dell'agente.

Gestisci il server dopo averlo aggiunto

Per rimuovere un server MCP o spegnere temporaneamente uno, usa il flusso standard di gestione degli strumenti. Vedi Gestisci ed elimina gli strumenti in un agente.

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 possono essere eseguite 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.
  • Last updated on