Introducción a Foundry MCP Server (versión preliminar) mediante Visual Studio Code

Foundry MCP Server (versión preliminar) es una implementación hospedada en la nube del Protocolo de contexto de modelo (MCP). Expone herramientas seleccionadas que permiten a los agentes realizar operaciones de lectura y escritura en servicios Foundry sin llamar directamente a las API de back-end. No es necesario implementar la infraestructura: el servidor proporciona un punto de conexión seguro y escalable con autenticación integrada a través de Microsoft Entra ID.

Usa un cliente compatible con MCP, como Visual Studio Code, para conectarte al punto de conexión público, autenticarse con Entra ID y permitir que los LLMs accedan a las herramientas. Después de conectarse, puede crear agentes que invoquen estas herramientas con avisos de lenguaje natural.

En este artículo, aprenderá a:

Conexión al servidor MCP de Foundry con GitHub Copilot en Visual Studio Code
Ejecución de avisos para probar las herramientas del servidor MCP de Foundry e interactuar con los recursos de Azure

Esta guía tarda unos 5 minutos en completarse.

Nota

Esta característica está actualmente en versión preliminar pública. Esta versión preliminar se proporciona sin un contrato de nivel de servicio y no se recomienda para cargas de trabajo de producción. Es posible que algunas características no se admitan o que tengan funcionalidades restringidas. Para obtener más información, vea Supplemental Terms of Use for Microsoft Azure Previews.

Requisitos previos

Cuenta de Azure con una suscripción activa. Si no tiene una, cree una cuenta gratuita de Azure.
Un proyecto de fundición. Si no tiene un proyecto, cree uno con el Quickstart del SDK de Microsoft Foundry.
Visual Studio Code (versión 1.99 o posterior).
Una suscripción GitHub Copilot (individual, empresarial o para empresas).
GitHub Copilot Visual Studio Code extensión.
Colaborador o rol superior en el proyecto Foundry al que desea acceder.

Instalación e inicio del servidor MCP de Foundry

Seleccione una opción para instalar Foundry MCP Server en Visual Studio Code.

Perfil de usuario
Instalación de espacio de trabajo

Instale Foundry MCP Server en el perfil de usuario para que esté disponible para todas las áreas de trabajo de Visual Studio Code.

Abra la paleta de comandos (Ctrl+Mayús+P).
Busque MCP: Agregar servidor.
Seleccione la opción HTTP (HTTP o Server-Sent Events).
Escriba https://mcp.ai.azure.com como dirección URL.
Escriba un nombre descriptivo como foundry-mcp-remote y presione Entrar. Visual Studio Code agrega la siguiente entrada de servidor en el perfil de usuario:
```
{ 
  "servers": { 
    "foundry-mcp-remote": { 
      "type": "http", 
      "url": "https://mcp.ai.azure.com" 
    } 
  } 
}
```
Abra la paleta de comandos (Ctrl+Mayús+P).
Busque y seleccione MCP: Enumerar servidores.
Seleccione Foundry MCP Server que agregó y elija Iniciar servidor.
Aparece un indicador verde junto al nombre del servidor en MCP: Enumerar servidores y confirmar que la conexión está activa.
Cuando se le solicite, inicie sesión en Azure para que el servidor MCP pueda interactuar con los servicios de su suscripción.
Abra GitHub Copilot y seleccione Agent Mode.
Seleccione el icono de herramientas, busque Foundry para filtrar la lista y confirme que aparece el servidor.

Obtenga más información sobre el modo de agente en la documentación de Visual Studio Code.

Instale foundry MCP Server para un área de trabajo específica para limitarlo a esa carpeta:

Abra una carpeta vacía o una carpeta de proyecto existente en Visual Studio Code.
En la raíz de la carpeta, cree una .vscode carpeta si no existe.

Dentro de la .vscode carpeta , cree un archivo denominado mcp.jsony agregue el siguiente JSON.

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

Guarde los cambios en mcp.json.
Seleccione el botón Iniciar situado encima de la nueva entrada de servidor.
Aparece un indicador verde junto al nombre del servidor, confirmando que la conexión está activa.
Cuando se le solicite, inicie sesión para que el servidor MCP pueda interactuar con los servicios de la suscripción.
Abra GitHub Copilot y seleccione Modo de agente.
Seleccione el icono de herramientas, busque Foundry para filtrar los resultados y confirme que aparece el servidor.

Captura de pantalla que muestra Foundry MCP Server como herramienta de GitHub Copilot.

Para obtener más información sobre el modo de agente, visite la documentación de Visual Studio Code.

Utilizar avisos para realizar pruebas en el Servidor Foundry MCP

Abra el panel de chat de GitHub Copilot y confirme Agent Mode está seleccionado.
Escriba un mensaje que use las herramientas del servidor MCP de Foundry; por ejemplo, cuéntame sobre los modelos más recientes de Foundry.
Copilot solicita permiso para ejecutar la operación necesaria del servidor MCP de Foundry. Seleccione Continuar o use la flecha para elegir un comportamiento más específico:
- Sesi\u00F3n actual siempre ejecuta la operaci\u00F3n en la sesi\u00F3n actual del modo Agente de GitHub Copilot.
- Área de trabajo actual siempre ejecuta el comando para el área de trabajo actual de Visual Studio Code.
- Always allow establece que la operación siempre se ejecute para cualquier sesión del modo agente de GitHub Copilot o cualquier área de trabajo de Visual Studio Code.
La respuesta es similar a la siguiente salida abreviada. Los resultados reales varían en función de la disponibilidad del modelo actual.
```
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 y pruebe las operaciones del servidor MCP de Foundry con otros mensajes, 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

Solución de problemas

Problema	Resolución
El servidor no se inicia	Compruebe que ha escrito correctamente la dirección URL `https://mcp.ai.azure.com` . Abra la paleta de comandos y ejecute MCP: Enumerar servidores para comprobar el estado del servidor.
No aparece el mensaje de autenticación	Asegúrese de que la extensión GitHub Copilot esté instalada y haya iniciado sesión en Visual Studio Code con un cuenta Microsoft que tenga acceso a la suscripción de Azure.
Las herramientas de fundición no aparecen en modo de agente	Confirme que el servidor se está ejecutando (indicador verde en MCP: Enumerar servidores). Compruebe que seleccionó Agent Mode en el panel de chat de Copilot y, a continuación, seleccione el icono de herramientas y busque Foundry.
Errores de permiso o "Acceso denegado"	Compruebe que tiene el rol Colaborador o superior en el proyecto Foundry. El servidor utiliza el flujo "On-Behalf-Of" con las credenciales de Entra ID.

Limpieza de recursos

Para quitar la configuración del servidor:

Perfil de usuario: abra la paleta de comandos, ejecute MCP: List Servers, seleccione el servidor Foundry y elija Quitar servidor.
Área de trabajo: elimine la entrada del servidor del archivo en la .vscode/mcp.json carpeta del proyecto.

Preguntas de ejemplo y herramientas de servidor MCP de Foundry

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-04-30