Comece a usar o Foundry MCP Server (pré-visualização) usando Visual Studio Code

Foundry MCP Server (pré-visualização) é uma implementação alojada na cloud do Model Context Protocol (MCP). Expõe ferramentas selecionadas que permitem aos seus agentes realizar operações de leitura e escrita em serviços Foundry sem recorrer diretamente às APIs backend.

Utilize um cliente compatível com MCP, como o Visual Studio Code, para conectar-se ao ponto de extremidade público, autenticar-se com o Entra ID e permitir que os LLMs acedam às ferramentas. Depois de se conectar, você pode criar agentes que invocam essas ferramentas com prompts de linguagem natural.

Neste artigo, você aprenderá a:

Liga-te ao Foundry MCP Server com o GitHub Copilot no Visual Studio Code
Execute prompts para testar as ferramentas do Foundry MCP Server e interagir com os recursos do Azure

Observação

Esta funcionalidade está atualmente em pré-visualização pública. Esta pré-visualização é fornecida sem um acordo de nível de serviço, e não a recomendamos para trabalhos em produção. Algumas funcionalidades poderão não ser suportadas ou poderão ter capacidades limitadas. Para obter mais informações, veja Termos Suplementares de Utilização para Pré-visualizações do Microsoft Azure.

Pré-requisitos

Conta do Azure com uma assinatura ativa. Se você não tiver uma, crie uma conta gratuita do Azure.
Um projeto da Foundry. Se não tiver um projeto, crie um com o Microsoft Foundry SDK Quickstart.
Visual Studio Code (versão 1.99 ou posterior).
Copiloto do GitHub Extensão de código do Visual Studio.
Contribuidor ou função superior no projeto Foundry ao qual deseja ter acesso.

Benefícios do Foundry MCP Server

Interface alojada na cloud para orquestração de ferramentas de IA: O Foundry MCP Server (pré-visualização) fornece um endpoint seguro e escalável para clientes compatíveis com MCP. Você não precisa implantar infraestrutura, permitindo cenários de integração perfeita e multiagentes.
Controle de identidade e acesso: O servidor impõe autenticação e autorização com o Microsoft Entra ID. Executa todas as operações dentro das permissões do utilizador autenticado (fluxo "On-Behalf-Of").
Ferramentas focadas em cenários e extensíveis: O Foundry MCP Server expõe um conjunto crescente de ferramentas para operações de leitura e escrita em modelos, implementações, avaliações e agentes no Foundry. As ferramentas são extensíveis, permitindo que desenvolvedores e agentes interajam com serviços sem conhecer APIs de back-end ou esquemas de dados.
Produtividade acelerada de agentes e desenvolvedores: fluxos de trabalho em linguagem natural (por meio de clientes MCP e modelos de linguagem grandes) permitem a descoberta e a invocação rápidas de ferramentas, simplificando o desenvolvimento e a orquestração de vários agentes.

Instalar e iniciar o Foundry MCP Server

Selecione uma opção para instalar o Foundry MCP Server no Visual Studio Code.

Perfil do utilizador
Instalação do espaço de trabalho

Instala o Foundry MCP Server no teu perfil de utilizador para que esteja disponível para todos os espaços de trabalho no Visual Studio Code.

Abra a Paleta de Comandos (Ctrl+Shift+P).
Procurar MCP:Add Server.
Selecione a opção HTTP (Http ou Server-Sent Events ).
Insira https://mcp.ai.azure.com como o URL.
Introduza um nome amigo como foundry-mcp-remote e depois pressione Enter. O Visual Studio Code adiciona a seguinte entrada de servidor em seu perfil de usuário:
```
{ 
  "servers": { 
    "foundry-mcp-remote": { 
      "type": "http", 
      "url": "https://mcp.ai.azure.com" 
    } 
  } 
}
```
Abra a Paleta de Comandos (Ctrl+Shift+P).
Procure e selecione MCP:List Servers.
Seleciona o Foundry MCP Server que adicionaste e escolhe Iniciar Servidor.
Quando solicitado, entre no Azure para que o servidor MCP possa interagir com os serviços em sua assinatura.
Abra o GitHub Copilot e selecione Modo de agente.
Selecione o ícone de ferramentas, procure Foundry para filtrar a lista e confirme que o servidor aparece.

Saiba mais sobre o Modo de Agente na documentação do Visual Studio Code.

Instala o Foundry MCP Server para um espaço de trabalho específico para delimitá-lo a essa pasta:

Abra uma pasta vazia ou uma pasta de projeto existente no Visual Studio Code.
Na raiz da pasta, crie uma .vscode pasta se ela não existir.

Dentro da .vscode pasta, crie um arquivo chamado mcp.jsone adicione o seguinte JSON.

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

Salve suas alterações em mcp.json.
Selecione o botão Iniciar acima da nova entrada do servidor.
Quando solicitado, entre para que o servidor MCP possa interagir com os serviços em sua assinatura.
Abra o GitHub Copilot e selecione Modo de agente.
Selecione o ícone de ferramentas, procure por Foundry para filtrar os resultados e confirme se o servidor está visível.

Para saber mais sobre o Modo Agente, visite a documentação do Visual Studio Code.

Use prompts para testar o Foundry MCP Server

Abra o painel de bate-papo do GitHub Copilot e confirme se o Modo de agente está selecionado.
Introduza um prompt que utilize as ferramentas do Foundry MCP Server — por exemplo Fale-me sobre os modelos mais recentes no Foundry.
O Copilot solicita autorização para executar a operação necessária do Foundry MCP Server. Selecione Continuar ou use a seta para escolher um comportamento mais específico:
- A sessão atual sempre executa a operação na sessão atual do Modo de Agente Copiloto do GitHub.
- O espaço de trabalho atual sempre executa o comando para o espaço de trabalho atual do Visual Studio Code.
- Sempre permitir define a operação para sempre ser executada para qualquer sessão do Modo de Agente Copiloto do GitHub ou qualquer espaço de trabalho do Visual Studio Code.
A resposta assemelha-se à seguinte saída encurtada. Os resultados reais variam consoante a disponibilidade atual do modelo.
```
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
```

Explore e teste as operações do Foundry MCP Server com outros prompts, tais como:

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

Solução de problemas

Questão	Resolução
O servidor não arranca	Confirma se introduziste o URL `https://mcp.ai.azure.com` corretamente. Abra a Paleta de Comandos e execute MCP: List Servers para verificar o estado do servidor.
O prompt de autenticação não aparece	Certifica-te de que a extensão do GitHub Copilot está instalada e que iniciaste sessão no Visual Studio Code com uma conta Microsoft com acesso à subscrição do Azure.
As ferramentas do Foundry não aparecem no Modo Agente	Confirme que o servidor está a funcionar (indicador verde no MCP: Listar Servidores). Verifica se selecionaste o Modo Agente no painel de chat do Copilot, depois seleciona o ícone de ferramentas e procura por Foundry.
"Acesso negado" ou erros de permissão	Verifica se tens um cargo de Contribuidor ou superior no projeto Foundry. O servidor utiliza o fluxo On-Behalf-Of com as suas credenciais do Entra ID.

Remover o Servidor MCP da Foundry

Para remover a configuração do servidor:

Perfil de utilizador: Abra a Paleta de Comandos, execute MCP: Listar Servidores, selecione o servidor Foundry e selecione Remover Servidor.
Workspace: Apaga a entrada do servidor do .vscode/mcp.json ficheiro na pasta do teu projeto.

Feedback

Esta página foi útil?

Last updated on 2026-02-28