Conecta el agente en la nube de GitHub Copilot al servidor MCP de Azure

En este artículo se muestra cómo configurar y conectar el agente en la nube de GitHub Copilot al servidor MCP de Azure. Al conectar el agente en la nube al servidor, el agente puede entender tus archivos específicos de Azure y los recursos de Azure para hacer cambios en tus archivos de código.

En tu repositorio de GitHub, al asignar incidencias de GitHub al agente en la nube de GitHub Copilot se crea una solicitud de extracción con los cambios en tu código. Si los cambios solicitados requieren acceso a los recursos de Azure, el agente en la nube de GitHub Copilot debe usar el servidor MCP de Azure. Antes de que el agente en la nube de GitHub Copilot pueda usar el servidor MCP de Azure para realizar cambios en el proyecto basado en Azure de forma agentica, debe configurar el agente en la nube de GitHub Copilot y concederle los permisos adecuados en Azure. Puede configurar manualmente todo, pero muchos pasos se automatizan mediante azd y la coding-agent extensión. GitHub ahora usa el nombre para mostrar "agente de Copilot en la nube" en la interfaz de usuario, pero el identificador estable de la extensión sigue siendo azure.coding-agent y el comando de la CLI sigue siendo azd coding-agent ....

Prerrequisitos

• Una cuenta de Azure y acceso a una suscripción de Azure. Para más información sobre cómo configurarlas, consulte la página de precios de las cuentas de Azure.

• Una cuenta de GitHub y una suscripción a GitHub Copilot. Para más información sobre cómo configurarlas, consulte Creación de una cuenta en GitHub e Inicio rápido para GitHub Copilot, respectivamente.

• Un clon local existente de un repositorio de GitHub. Dado que en este artículo se describe cómo configurar la conexión entre GitHub Copilot agente en la nube y el servidor MCP de Azure, el repositorio de GitHub debe incluir scripts de implementación para Azure, como Bicep o plantillas de Terraform.

Configuración del repositorio de GitHub para usar el servidor de Azure MCP

La azd extensión de agente de codificación simplifica los pasos necesarios para configurar de forma segura la conexión entre el agente en la nube de GitHub Copilot y el servidor MCP de Azure para la suscripción de Azure. En primer lugar, crea una cuenta en la suscripción de Azure y la asigna a un rol con los permisos necesarios. En segundo lugar, proporciona un fragmento de código JSON necesario para introducir el Azure servidor MCP en el agente en la nube de GitHub Copilot.

1. Si aún no tiene azd instalado, siga las instrucciones para instalarla.

2. En el terminal, vaya al clon local del repositorio con el que desea trabajar.

3. Invoque la coding-agent extensión para azd mediante el comando azd coding-agent config.

4. Durante la instalación, se le pedirá que seleccione lo siguiente:

   • Suscripción de Azure
   • GitHub repositorio que usa el agente en la nube de Copilot
   • Si desea crear una identidad administrada de usuario nueva o existente
   • Una ubicación de Azure
   • Un grupo de recursos de Azure
   • Repositorio de GitHub donde se creará una nueva rama que contiene el archivo de instalación de flujo de trabajo de Acciones de GitHub generado.

   Al seleccionar la ubicación y el grupo de recursos, es posible que quiera usar la misma ubicación de destino y el mismo grupo de recursos que los recursos de Azure en la aplicación.

5. Después de unos instantes, la coding-agent extensión para azd crea (o usa la identidad administrada asignada por el usuario) existente, la asigna a un rol, almacena los valores de identidad en el entorno del repositorio de GitHub y crea e inserta una rama que contiene el archivo de instalación de flujo de trabajo de Acciones de GitHub generado.

6. Verá un mensaje en la consola:

   (!)
   (!) NOTE: Some tasks must still be completed, manually:
   (!)
   

   Normalmente hay tres tareas:

   • Combine la rama que contiene el archivo de instalación del flujo de trabajo de Acciones de GitHub generado.
   • Configure los roles de identidad administrada del agente en la nube de Copilot en el Portal de Azure. De forma predeterminada, se asigna el rol "Lector". Sin embargo, es posible que quiera concederle otros permisos en función de lo que quiera que el agente en la nube haga de forma autónoma.
   • Visite el vínculo para configurar la configuración de MCP. Para ir allí manualmente, en GitHub vaya a Configuración>Copilot>agente de nube>configuración de MCP y pegue el fragmento JSON proporcionado. Este es un ejemplo:

   {
       "mcpServers": {
           "Azure": {
               "type": "local",
               "command": "npx",
               "args": [
                   "-y",
                   "@azure/mcp@latest",
                   "server",
                   "start"
               ],
               "tools": [
                   "*"
               ]
           }
       }
   }
   

7. Por último, puedes permitir la extensión coding-agent para azd para abrir el navegador y poder crear la solicitud de extracción con el fin de fusionar la rama que contiene el archivo de configuración del flujo de trabajo de Acciones de GitHub generado.

Creación de un problema en GitHub para iniciar GitHub Copilot agente en la nube

En este punto, ha configurado correctamente el agente en la nube de GitHub Copilot para usar el servidor MCP de Azure en cualquier incidencia de GitHub que asigne al agente en la nube de GitHub Copilot y que requiera comprender las implementaciones y los recursos de Azure.

Por ejemplo, supongamos que desea aumentar la memoria asignada a PostgreSQL cuando se implementa en Azure Database for PostgreSQL. Deberías crear una incidencia para modificar tu plantilla de Bicep con el fin de utilizar el siguiente nivel de almacenamiento disponible y asignársela a GitHub Copilot.

1. En GitHub, en el repositorio que contiene el proyecto basado en Azure en el que ha habilitado el servidor de Azure MCP, vaya a Problemas.

2. Seleccione el botón Nuevo problema . Describa el cambio que desea que GitHub Copilot agente en la nube realice en los campos de título y descripción. Seleccione el botón Crear.

   En el ejemplo anterior, puede usar el texto siguiente para describir el problema.

   Title: Increase database storage
   
   Currently, when deploying to Azure via Bicep, we're creating a PostgreSQL database with 32gb of storage. I need the next tier higher -- whatever that is.
   

   Este problema de ejemplo hace una solicitud sencilla y clara aunque el usuario no sepa exactamente lo que solicita. Permite que Azure MCP Server investigue los niveles de almacenamiento disponibles para Azure Database for PostgreSQL Flexible Server y la configuración necesaria en la plantilla de Bicep para realizar ese cambio.

   Importante

   Asegúrese de usar la palabra "Azure" en su solicitud para asegurarse de que GitHub Copilot solicite herramientas al servidor Azure MCP.

3. Selecciona el botón Asignar a Copilot en Asignados. Aparecerá el cuadro de diálogo Asignar Copilot a la incidencia, que te permite modificar el repositorio de destino, la rama base y añadir un mensaje opcional. Seleccione el botón "Asignar".

4. Una vez asignada la incidencia al agente en la nube de GitHub Copilot, verás un enlace a la solicitud de incorporación de cambios con el prefijo [WIP], que te indica que el trabajo está en marcha.

5. Seleccione el vínculo "[WIP]" para ver la solicitud de incorporación de cambios.

6. En el cuerpo de la solicitud de incorporación de cambios, seleccione el vínculo para ver la sesión de codificación. Esto muestra el progreso que realiza el agente en la nube de Copilot en la solicitud, similar a la experiencia en Visual Studio.

7. Cuando termine, GitHub Copilot agente en la nube solicita una revisión de código. Utiliza tu flujo de trabajo habitual para colaborar con GitHub, tratando al agente en la nube de GitHub Copilot como si fuera un compañero de trabajo.

8. Una vez que apruebas los cambios y combinas el pull request, GitHub Copilot resuelve el problema original que creaste.

Contenido relacionado

• agente en la nube de GitHub Copilot