Esercitazione: Configurare il connettore MCP nell'agente SRE di Azure

In questa esercitazione si connette l'agente SRE a un server degli strumenti esterno usando il protocollo MCP (Model Context Protocol), selezionare gli strumenti per l'agente e testarli nella chat. Questo tutorial usa il server MCP di GitHub come esempio. Gli stessi passaggi funzionano per Datadog, Splunk, New Relic e qualsiasi connettore partner.

Tempo stimato: 10 minuti

In questa esercitazione apprenderai a:

  • Aggiungere un connettore MCP all'agente
  • Selezionare gli strumenti per l'agente
  • Strumenti di test nella chat

Prerequisiti

  • Un agente SRE di Azure attivo
  • URL dell'endpoint server MCP (esplorare i server disponibili nel Centro MCP di Azure)
  • Accesso di rete tra l'agente e il server MCP
  • Informazioni di autenticazione per il server MCP (chiave API, login OAuth per server remoti supportati, token OAuth o identità gestita, a seconda del server)

Suggerimento

Per il primo connettore MCP, provare uno dei server verificati dal Centro MCP di Azure. Molti includono istruzioni di configurazione e non richiedono configurazioni aggiuntive.

Passaggio 1: Aggiungere il connettore MCP

Registrare il server MCP come connettore nel portale dell'agente SRE.

  1. Passare a sre.azure.com e selezionare l'agente.
  2. Passare a Builder>Connettori.
  3. Selezionare + Aggiungi connettore.
  4. Selezionare Server MCP come tipo di connettore.
  5. Immettere l'URL del server MCP e l'autenticazione richiesta. Il metodo di autenticazione varia a seconda del server (chiave API, login OAuth per server remoti supportati, token OAuth o identità gestita). Per i dettagli, vedi Autenticazione.
  6. Seleziona Aggiungi.

Dovresti vedere il tuo connettore nell'elenco dei connettori. Lo stato mostra inizializzazione brevemente, quindi passa a Connesso (segno di spunta verde). Il nome della connessione visualizzato nell'elenco è l'ID connessione usato per fare riferimento agli strumenti.

Suggerimento

Se lo stato è Non riuscito o Disconnesso, controllare l'URL del server, le credenziali di autenticazione e la configurazione di rete. Per altre informazioni, vedere la sezione Monitoraggio dell'integrità del connettore MCP in Connettori.

Passaggio 2: Selezionare gli strumenti per l'agente

Durante la configurazione del connettore (o modificando il connettore in un secondo momento), selezionare gli strumenti che l'agente può usare direttamente nella chat.

  1. Dopo che il connettore è connesso, selezionare Modifica nel connettore.
  2. Nella sezione Strumenti MCP controllare gli strumenti desiderati oppure selezionare Seleziona tutto per aggiungere tutto.
  3. Seleziona Salva.

È ora possibile accedere agli strumenti selezionati direttamente nella chat principale.

Suggerimento

L'agente può usare fino a 80 strumenti totali in tutti i connettori. Il selettore di strumenti mostra una barra di capacità in modo da poter gestire il budget degli strumenti.

Suggerimento

Per i flussi di lavoro complessi, è anche possibile assegnare strumenti MCP a un agente personalizzato nell'area di disegno agente. Questo approccio è utile quando si vogliono agenti specializzati per piattaforme diverse o è necessario controllare quali strumenti sono disponibili in quale contesto.

Passaggio 3: Testare nella chat

Verificare che l'agente possa usare gli strumenti MCP testandoli nella chat.

  1. Aprire un nuovo thread di chat.
  2. Porre una domanda che usa gli strumenti connessi. Ad esempio: "Cercare file correlati all'autenticazione nei repository".
  3. Premere INVIO.

Le schede di chiamata dello strumento mostrano il nome della connessione, il nome dello strumento e lo stato Completato . Per altre informazioni sull'ambiente di test, vedere Agent playground.

Esempio: Connettersi al server MCP di Microsoft Learn

Questo esempio illustra come connettere l'agente al server MCP di Microsoft Learn. Usando questo server, l'agente ottiene l'accesso agli strumenti di ricerca della documentazione.

Connettere il server

Aggiungere il server MCP di Microsoft Learn come connettore.

  1. Passare a Impostazioni>Connettori>Aggiungi connettore>Aggiungi server MCP.

  2. Immettere i dettagli della connessione:

    Campo Valore
    Nome MicrosoftLearnMCP
    Tipo di connessione SSE (Eventi inviati dal server)
    URL https://learn.microsoft.com/api/mcp
    Autenticazione Intestazioni personalizzate (lasciare vuote; questo server non richiede l'autenticazione)

  3. Selezionare Aggiungi e attendere che lo stato visualizzi Connesso.

Selezionare gli strumenti dal connettore

Dopo che il connettore è attivo, selezionare gli strumenti da usare.

  1. Selezionare Modifica nel MicrosoftLearnMCP connettore.
  2. Nella sezione Strumenti MCP selezionare gli strumenti dalla MicrosoftLearnMCP connessione.
  3. Selezionare Salva e testare gli strumenti nella chat.

Trovare altri server MCP

È possibile individuare i server MCP per connettersi dai registri seguenti:

Registry URL Descrizione
Centro MCP di Azure mcp.azure.com Server MCP verificati per i servizi di Azure
Directory MCP GitHub github.com/mcp Server MCP della comunità e open source

Risolvere i problemi comuni

In caso di problemi, esaminare la tabella seguente per individuare problemi e soluzioni comuni.

Issue Soluzione
Stato visualizzato Non riuscito Controllare l'URL, le credenziali e l'accesso alla rete.
Gli strumenti MCP non vengono visualizzati nella selezione degli strumenti Verificare che il connettore mostri lo stato Connesso in Builder>Connectors.
Le chiamate agli strumenti falliscono nella chat Verificare che gli strumenti siano selezionati per l'agente principale. Modifica il connettore e controlla la sezione Strumenti MCP .
Raggiungere il limite di 80 strumenti Rimuovere gli strumenti inutilizzati da altri connettori per liberare capacità.

Passo successivo

Informazioni sui connettori

Contenuti correlati

  • Last updated on