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. Non è necessario distribuire l'infrastruttura. Il server fornisce un endpoint sicuro e scalabile con l'autenticazione predefinita tramite Microsoft Entra ID.

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.

Questo articolo illustra come:

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

Il completamento di questa guida richiede circa 5 minuti.

Nota

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 avere funzionalità limitate. Per altre informazioni, vedere Condizioni supplementari per l'utilizzo delle anteprime di Microsoft Azure.

Prerequisiti

Azure account con una sottoscrizione attiva. Se non è disponibile, creare un account Azure gratuito.
Progetto Foundry. Se non si ha un progetto, crearne uno utilizzando il Quickstart del Microsoft Foundry SDK.
Visual Studio Code (versione 1.99 o successiva).
Sottoscrizione GitHub Copilot (Singola, Business o Enterprise).
Estensione di GitHub Copilot per Visual Studio Code.
Ruolo collaboratore o superiore nel progetto Foundry a cui si vuole accedere.

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).
Cerca MCP: Aggiungi server.
Selezionare l'opzione HTTP (HTTP o eventi Server-Sent).
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 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: Elenca server.
Selezionare Foundry MCP Server aggiunto e scegliere Avvia server.
Accanto al nome del server in MCP: Elenca i server viene visualizzato un indicatore verde, che conferma che la connessione è attiva.
Quando richiesto, accedere a 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 Visual Studio Code.

Installare Foundry MCP Server per un'area di lavoro specifica, per associarlo a quella cartella.

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

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

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

Salvare le modifiche apportate a mcp.json.
Selezionare il pulsante Start sopra la voce del nuovo server.
Accanto al nome del server viene visualizzato un indicatore verde, che conferma che la connessione è attiva.
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, visitare la documentazione Visual Studio Code.

Usare i comandi per testare il server Foundry MCP

Aprire il pannello di chat GitHub Copilot e confermare Agent Mode selezionato.
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 modalità agente di GitHub Copilot della sessione corrente.
- Ambiente di lavoro corrente esegue sempre il comando per l'area di lavoro corrente di Visual Studio Code.
- Always allow imposta l'operazione per l'esecuzione sempre per qualsiasi sessione in modalità agente GitHub Copilot o per qualsiasi area di lavoro 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 Azure.
Gli strumenti della fonderia non vengono visualizzati in modalità agente	Verificare che il server sia in esecuzione (indicatore verde in MCP: Elenca server). Verificare di aver selezionato Agent Mode nel pannello della chat Copilot, quindi selezionare l'icona degli strumenti e cercare Foundry.
Errori di autorizzazione o "Accesso negato"	Verifica di avere il ruolo di collaboratore o superiore nel progetto Foundry. Il server utilizza il flusso On-Behalf-Of con le credenziali di Entra ID.

Pulire le risorse

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 nella cartella del progetto.

Strumenti del server MCP di Foundry e prompt di esempio

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-04-30