Introduzione a Foundry MCP Server (anteprima) con Visual Studio Code

Foundry MCP Server (anteprima) è un'implementazione ospitata nel cloud del protocollo MCP (Model Context Protocol). Espone strumenti curati che consentono agli agenti di eseguire operazioni di lettura e scrittura nei servizi Foundry senza chiamare direttamente le API back-end.

Usare un client conforme a MCP, come Visual Studio Code, per connettersi all'endpoint pubblico, autenticarsi con Entra ID e consentire agli LLM di accedere agli strumenti. Dopo la connessione, è possibile compilare agenti che richiamano questi strumenti con prompt del linguaggio naturale.

In questo articolo vengono illustrate le operazioni seguenti:

Connettersi al server MCP Foundry con GitHub Copilot in Visual Studio Code
Eseguire richieste per testare gli strumenti del server McP Foundry e interagire con le risorse di Azure

Annotazioni

Questa funzionalità è attualmente disponibile in anteprima pubblica. Questa anteprima viene fornita senza un contratto di servizio e non è consigliabile per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.

Prerequisiti

Account Azure con una sottoscrizione attiva. Se non è disponibile, creare un account Azure gratuito.
Progetto Foundry. Se non si ha un progetto, crearne uno con l'avvio rapido di Microsoft Foundry SDK.
Visual Studio Code (versione 1.99 o successiva).
GitHub Copilot Estensione di Visual Studio Code.
Ruolo collaboratore o superiore nel progetto Foundry a cui si vuole accedere.

Vantaggi di Foundry MCP Server

Interfaccia ospitata nel cloud per l'orchestrazione degli strumenti di intelligenza artificiale: Foundry MCP Server (anteprima) fornisce un endpoint sicuro e scalabile per i client conformi a MCP. Non è necessario implementare l'infrastruttura per abilitare una perfetta integrazione e scenari multi-agente.
Controllo di identità e accesso: il server applica l'autenticazione e l'autorizzazione con Microsoft Entra ID. Esegue tutte le operazioni all'interno delle autorizzazioni dell'utente autenticato (flusso On-Behalf-Of).
Strumenti estendibili incentrati sullo scenario: Foundry MCP Server espone un set crescente di strumenti per operazioni di lettura e scrittura su modelli, distribuzioni, valutazioni e agenti in Foundry. Gli strumenti sono estendibili, consentendo agli sviluppatori e agli agenti di interagire con i servizi senza conoscere le API back-end o gli schemi di dati.
Agente accelerato e produttività per sviluppatori: i flussi di lavoro in linguaggio naturale (tramite client MCP e modelli linguistici di grandi dimensioni) consentono l'individuazione rapida degli strumenti e la chiamata, lo sviluppo e l'orchestrazione multi-agente.

Installare e avviare Foundry MCP Server

Selezionare un'opzione per installare Foundry MCP Server in Visual Studio Code.

Profilo utente
Installazione dell'area di lavoro

Installare Foundry MCP Server nel profilo utente in modo che sia disponibile per tutte le aree di lavoro in Visual Studio Code.

Aprire il riquadro comandi (CTRL+MAIUSC+P).
Effettua una ricerca per MCP:Add Server.
Selezionare l'opzione HTTP (HTTP o server-sent events).
Immettere https://mcp.ai.azure.com come URL.
Immettere un nome descrittivo, ad esempio foundry-mcp-remote, quindi premere INVIO. Visual Studio Code aggiunge la seguente voce del server nel tuo profilo utente:
```
{ 
  "servers": { 
    "foundry-mcp-remote": { 
      "type": "http", 
      "url": "https://mcp.ai.azure.com" 
    } 
  } 
}
```
Aprire il riquadro comandi (CTRL+MAIUSC+P).
Cerca e seleziona MCP:List Servers.
Selezionare Foundry MCP Server aggiunto e scegliere Avvia server.
Quando richiesto, accedere ad Azure in modo che il server MCP possa interagire con i servizi nella sottoscrizione.
Aprire GitHub Copilot e selezionare Modalità agente.
Selezionare l'icona degli strumenti, cercare Foundry per filtrare l'elenco e verificare che venga visualizzato il server.

Altre informazioni sulla modalità agente sono disponibili nella documentazione di Visual Studio Code.

Installare il server Foundry MCP in un'area di lavoro specifica per circoscriverla a quella cartella.

Aprire una cartella vuota o una cartella di progetto esistente in Visual Studio Code.
Nella radice della cartella creare una .vscode cartella, se non esiste.

All'interno della .vscode cartella creare un file denominato mcp.jsone aggiungere il codice JSON seguente.

{ 
  "servers": { 
    "azure-ai-foundry-mcp-preview": { 
      "type": "http", 
      "url": "https://mcp.ai.azure.com" 
    } 
  } 
}

Salvare le modifiche apportate a mcp.json.
Selezionare il pulsante Start sopra alla voce del nuovo server.
Quando richiesto, accedere in modo che il server MCP possa interagire con i servizi nella sottoscrizione.
Aprire GitHub Copilot e selezionare Modalità agente.
Selezionare l'icona degli strumenti, cercare Foundry per filtrare i risultati e verificare che venga visualizzato il server.

Per altre informazioni sulla modalità agente, vedere la documentazione di Visual Studio Code.

Usare istruzioni per testare Foundry MCP Server

Aprire il pannello di chat di GitHub Copilot e verificare che sia selezionata la modalità agente .
Immettere un prompt che usa gli strumenti del server Foundry MCP, ad esempio Informazioni sui modelli più recenti in Foundry.
Copilot richiede l'autorizzazione per eseguire l'operazione richiesta del server MCP Foundry. Selezionare Continua o usare la freccia per scegliere un comportamento più specifico:
- La sessione corrente esegue sempre l'operazione nella sessione attuale in Modalità Agente di GitHub Copilot.
- L'area di lavoro corrente esegue sempre il comando per l'area di lavoro corrente di Visual Studio Code.
- Consenti sempre imposta l'operazione in modo che venga eseguita sempre per qualsiasi sessione in modalità agente di GitHub Copilot o per qualsiasi area di lavoro di Visual Studio Code.
La risposta è simile all'output abbreviato seguente. I risultati effettivi variano in base alla disponibilità del modello corrente.
```
Latest / Notable Foundry Models (Preview Snapshot)

1. Frontier & Reasoning Models
gpt-4o (2024-11-20) – Flagship multimodal model; strong multi-turn coherence.
o3 (2025-04-16) – Balanced reasoning with good accuracy/quality trade-off.
o4-mini (2025-04-16) – Strong quality with better latency than o3.
Phi-4 – Microsoft small frontier open model; competitive quality at lower cost.

// Further output omitted
```

Esplorare e testare le operazioni del server MCP Foundry con altre richieste, ad esempio:

What tools can I use from Foundry MCP Server (preview)?
Tell me about the latest models on Foundry
Show me details about the GPT-4o model on Foundry

Risoluzione dei problemi

Problema	Risoluzione
Il server non viene avviato	Verificare che l'URL `https://mcp.ai.azure.com` sia stato immesso correttamente. Aprire il riquadro comandi ed eseguire MCP: Elenca server per controllare lo stato del server.
La richiesta di autenticazione non viene visualizzata	Assicurarsi che l'estensione GitHub Copilot sia installata e che sia stato eseguito l'accesso a Visual Studio Code con un account Microsoft che abbia accesso alla sottoscrizione di Azure.
Gli strumenti Foundry non vengono visualizzati in Modalità Agente	Verificare che il server sia in esecuzione (indicatore verde in MCP: Elenca server). Verificare di aver selezionato Modalità agente nel pannello della chat di Copilot, quindi selezionare l'icona degli strumenti e cercare Foundry.
Errori di autorizzazione o "Accesso negato"	Verificare di avere il ruolo Collaboratore o superiore nel progetto Foundry. Il server utilizza il flusso On-Behalf-Of con le credenziali Entra ID.

Rimuovere il server Foundry MCP

Per rimuovere la configurazione del server:

Profilo utente: aprire il riquadro comandi, eseguire MCP: Elenca server, selezionare il server Foundry e scegliere Rimuovi server.
Area di lavoro: eliminare la voce server dal file .vscode/mcp.json nella cartella del progetto.

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-02-28