Inicio rápido: Integración de Azure MCP Server con la CLI de GitHub Copilot

En este inicio rápido, aprenderá a conectar el servidor de Protocolo de contexto de modelo de Azure (MCP) a la CLI de GitHub Copilot. Esta integración permite que GitHub Copilot interactúe con los recursos de Azure directamente desde el terminal.

Prerrequisitos

• Cli de Copilot de GitHub instalada.
• CLI de Azure instalada y autenticada (az login).
• Node.js instalado (para ejecutar el servidor mediante npx).

Inicia sesión en Azure MCP Server para desarrollo local

Azure MCP Server se autentica con Microsoft Entra ID mediante la biblioteca de identidad de Azure para .NET. El servidor admite dos modos de autenticación:

• Modo de agente: usa la autenticación nativa del sistema operativo (como el Administrador de cuentas web de Windows) con InteractiveBrowserCredential.
• Modo de cadena de credenciales: intenta varios métodos de autenticación en secuencia: variables de entorno, Visual Studio Code, Visual Studio, CLI de Azure, Azure PowerShell, CLI para desarrolladores de Azure y autenticación interactiva del explorador.

Inicie sesión con cualquiera de estos métodos:

Visual Studio Code

1. Abra la paleta de comandos (Ctrl+Shift+P o Cmd+Shift+P en Mac).
2. Ejecución de Azure: inicie sesión y siga las indicaciones.

Visual Studio

1. Vaya a Configuración de la cuenta>.
2. Seleccione Agregar una cuenta y siga las indicaciones.

Azure CLI

az login

Azure PowerShell

Connect-AzAccount

CLI de desarrollo de Azure

azd auth login

Después de iniciar sesión, Azure MCP Server puede autenticar y ejecutar operaciones en los servicios de Azure en función de los permisos.

Adición de un servidor MCP de Azure

La CLI de Copilot de GitHub admite servidores MCP a través de la familia de /mcp comandos.

1. Abra el terminal.

2. Inicie la CLI de GitHub Copilot en modo interactivo:

   copilot
   

3. En la sesión interactiva, ejecute el siguiente comando para abrir el formulario de configuración del servidor MCP:

   /mcp add
   

4. Rellene los campos de configuración con los siguientes valores:

   Campo	Importancia
   Nombre del servidor	azure-mcp
   Tipo de servidor	1 (Local)
   Comando	npx -y @azure/mcp@latest server start
   Variables de entorno	(dejar en blanco: usa la autenticación de la CLI de Azure)
   Herramientas	*

   Nota:

   Si prefiere usar .NET, establezca el comando en dotnet dnx -p Azure.Mcp server start.

5. Presione Ctrl+S (o Cmd+S en macOS) para guardar la configuración del servidor.

6. Cuando haya terminado, presione esc para cerrar la configuración del servidor.

Comprobación de la conexión

Confirme que ha configurado correctamente el servidor MCP de Azure y que la CLI de GitHub Copilot la reconoce:

1. En la sesión de la CLI de Copilot, ejecute:

   /mcp show
   

2. Revise el resultado. Debería aparecer azure-mcp en la configuración:

   ● MCP Server Configuration:
     • azure-mcp (local): Command: npx
   
   Total servers: 1
   Config file: ~/.copilot/mcp-config.json
   

Uso del servidor MCP de Azure

Una vez conectado, puede usar lenguaje natural para interactuar con los recursos de Azure.

1. Durante la sesión de la CLI de Copilot de GitHub, escriba un mensaje que requiera el contexto de Azure. Por ejemplo:

   > List my Azure resource groups.
   

2. GitHub Copilot identifica la intención y usa las azure-mcp herramientas para capturar la información. Imprime una respuesta en la que se enumeran los grupos de recursos de Azure, de forma similar a:

   I found the following resource groups in your subscription:
   
   - **my-resource-group-1** (East US)
   - **dev-environment** (West Europe)
   - **production-app** (Central US)
   

Administración de servidores MCP

Administre los servidores MCP configurados mediante los siguientes comandos:

• Enumerar servidores:/mcp show
• Quitar un servidor:/mcp remove azure-mcp
• Obtener ayuda:/mcp help

Pasos siguientes

• Obtenga más información sobre la CLI de GitHub Copilot.
• Explore las funcionalidades del servidor MCP de Azure.