Comece a usar o Foundry MCP Server (pré-visualização) usando o 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. Não precisa de implementar infraestrutura — o servidor fornece um endpoint seguro e escalável com autenticação integrada através do Microsoft Entra ID.

Use um cliente compatível com MCP, como o Visual Studio Code, para se ligar ao endpoint público, autenticar com o Entra ID e permitir que os LLMs acedam às ferramentas. Depois de se ligar, pode construir agentes que invocam estas ferramentas com prompts em linguagem natural.

Neste artigo, aprende como:

  • Ligue-se 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

Este guia demora cerca de 5 minutos a completar.

Nota

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 cargas de trabalho em produção. Certas funcionalidades podem não ser suportadas ou podem ter capacidades limitadas. Para mais informações, consulte Termos de Utilização Suplementares para Microsoft Azure Pré-visualizações.

Pré-requisitos

Instalar e iniciar o Foundry MCP Server

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

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

  1. Abra a paleta de comandos (Ctrl+shift+p).

  2. Pesquisar MCP: Adicionar Servidor.

  3. Selecione a opção HTTP (HTTP ou Eventos Enviados pelo Servidor).

  4. Introduza https://mcp.ai.azure.com como URL.

  5. Introduza um nome amigo como foundry-mcp-remote e depois pressione Enter. O Visual Studio Code adiciona a seguinte entrada do servidor no seu perfil de utilizador:

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

  6. Abra a paleta de comandos (Ctrl+shift+p).

  7. Procure e selecione MCP: List Servers.

  8. Seleciona o Foundry MCP Server que adicionaste e escolhe Iniciar Servidor.

  9. Um indicador verde aparece ao lado do nome do servidor em MCP: List Servers, confirmando que a ligação está ativa.

  10. Quando solicitado, inicie sessão no Azure para que o servidor MCP possa interagir com os serviços da sua subscrição.

  11. Abra GitHub Copilot e selecione Modo Agente.

  12. Selecione o ícone de ferramentas, procure por Foundry para filtrar a lista e confirme que o servidor aparece.

    Captura de ecrã da lista de ferramentas do GitHub Copilot no modo Agente, mostrando a ferramenta Foundry MCP Server.

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

Utilize prompts para testar o servidor Foundry MCP

  1. Abra o painel de chat GitHub Copilot e confirme que Modo Agente está selecionado.

  2. Introduza um prompt que utilize as ferramentas do Foundry MCP Server — por exemplo Fale-me sobre os modelos mais recentes no Foundry.

  3. O Copilot solicita autorização para executar a operação necessária do servidor MCP da Foundry. Selecione Continuar ou use a seta para escolher um comportamento mais específico:

    • Current session executa sempre a operação na sessão atual do Modo de Agente do GitHub Copilot.
    • Current workspace executa sempre o comando para o Visual Studio Code workspace atual.
    • Always allow define a operação para ser sempre executada em qualquer sessão de Modo Agente GitHub Copilot ou em qualquer espaço de trabalho Visual Studio Code.

    Captura de ecrã das opções para executar operações do Foundry MCP Server.

    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

  4. 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

Resolução de problemas

Problema 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 Certifique-se de que a extensão GitHub Copilot está instalada e que está conectado ao Visual Studio Code com uma conta da Microsoft que tenha 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 Modo Agente no painel de chat Copilot, depois seleciona o ícone de ferramentas e pesquisa por Foundry.
"Acesso negado" ou erros de permissão Verifica se tens um cargo de Contribuidor ou superior no projeto Foundry. O servidor usa o fluxo On-Behalf-Of com as suas credenciais Entra ID.

Liberar recursos

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.

Conteúdo relacionado

Ferramentas e exemplos de prompts do Foundry MCP Server

  • Last updated on