Compilación de un complemento para un agente declarativo desde un servidor MCP

En esta guía se muestra cómo integrar el servicio con un agente declarativo para Microsoft 365 Copilot agregando un servidor MCP como complemento mediante el Kit de herramientas de agentes de Microsoft 365. Siguiendo estos pasos, habilitará el acceso conversacional impulsado por IA a sus servicios expuestos a MCP para usuarios comerciales.

En este tutorial se usa el servidor MCP de GitHub como ejemplo. El servidor MCP de GitHub es un servidor MCP remoto, proporcionado y mantenido por GitHub, que expone herramientas para trabajar con repositorios, problemas, solicitudes de incorporación de cambios y otras características de GitHub. Puede usarlo aquí para crear un agente que pueda buscar en repositorios y usuarios de GitHub desde indicaciones en lenguaje natural. Puede seguir los mismos pasos con su propio servidor MCP.

Cree y use el complemento en cuatro pasos: cree un cliente OAuth para la autenticación, cree el agente, publique y transfiera localmente el agente, y use el agente.

Requisitos previos

Antes de comenzar, asegúrate de cumplir los siguientes requisitos previos:

• Requisitos especificados en Requisitos para las opciones de extensibilidad de Copilot
• Visual Studio Code
• Kit de herramientas de agentes de Microsoft 365 , versión 6.12.0 o posterior

Para completar el ejemplo de GitHub de este tutorial, también necesita una cuenta de GitHub. No se requiere una cuenta de GitHub para crear un complemento desde su propio servidor MCP.

Paso 1: Crear un cliente OAuth para la autenticación

El servidor MCP de GitHub requiere que cada usuario inicie sesión para devolver datos, por lo que el complemento necesita un cliente OAuth. En esta guía, use OAuth (con registro estático). Al crear el agente y seleccionar este tipo de autenticación, Kit de herramientas de agentes le solicita inmediatamente esos valores, por lo que debe crear primero el cliente. A continuación, Copilot usa el registro para obtener un token de acceso en nombre del usuario que ha iniciado sesión cada vez que el agente llama al servidor MCP.

Para crear un cliente OAuth:

1. Vaya a https://github.com/settings/developers en el explorador. Seleccione Aplicaciones >OAuthNueva aplicación OAuth.

2. Agregue un nombre y una dirección URL de página principal para la aplicación y establézcalos https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect como dirección URL de devolución de llamada de autorización. Seleccione Registrar aplicación.

3. Una vez creada la aplicación, seleccione Generar un nuevo secreto de cliente. Copie el secreto y el identificador de cliente que especificará al crear el agente.

Paso 2: Crear el agente

Para crear el agente:

1. Abra Visual Studio Code y seleccione el icono del Kit de herramientas de agentes de Microsoft 365 en la barra de actividades.

2. Seleccione Crear un nuevo agente o aplicación en el panel de tareas Kit de herramientas de agentes.

   

3. Seleccione Agente declarativo.

4. Seleccione Agregar una acción y, después, Iniciar con un servidor MCP.

5. Escriba la dirección URL https://api.githubcopilot.com/mcp/del servidor MCP de GitHub.

   

6. Seleccione el tipo de autenticación. Para este ejercicio, seleccione OAuth (con registro estático).

   

7. Cuando se le solicite, escriba el ID de cliente de la aplicación OAuth que registró y, a continuación, introduzca el secreto de cliente.

8. Cuando se le pida ámbitos, presione Entrar para continuar.

9. Elige una ubicación para el proyecto del agente.

10. Introduzca un nombre para el agente.

Después de completar estos pasos, Kit de herramientas de agentes genera los archivos necesarios para el agente y abre una nueva ventana de Visual Studio Code con el proyecto de agente cargado.

Agents Toolkit configura el manifiesto de complemento generado (ai-plugin.json) para la detección dinámica de herramientas, de modo que el agente resuelva las herramientas del servidor MCP, incluidas las que devuelvan widgets de interfaz de usuario (aplicaciones MCP), en tiempo de ejecución, y no se añadan herramientas manualmente. Para anclar un conjunto fijo y seleccionado de herramientas en su lugar, consulte Configuración de herramientas ancladas con Agents Toolkit.

Paso 3: Publicar y transferir localmente el agente

Para publicar y transferir localmente el agente:

1. En el panel Cuentas del Kit de herramientas de agentes , seleccione Iniciar sesión en Microsoft 365. (Si ya has iniciado sesión, continúa con el paso siguiente).

2. Confirme que tanto la carga de aplicaciones personalizadas habilitada como el acceso de Copilot habilitado se muestran en su cuenta de Microsoft 365. Si no lo hacen, póngase en contacto con el administrador de la organización. Consulte Requisitos para las opciones de extensibilidad de Copilot para obtener más información.

3. En el panel Ciclo de vida , seleccione Aprovisionar.

4. Lee el mensaje en el cuadro de diálogo y selecciona Confirmar para continuar.

5. Espere a que el kit de herramientas informe de que ha terminado de aprovisionarse.

Paso 4: Usar el agente

Para usar el agente:

1. En el explorador, vaya a https://m365.cloud.microsoft/chat.

2. En la sección Agentes de la barra lateral, localiza a tu agente. Aparece con el nombre que dio en el Paso 2: Crear el agente, con dev un anexado al final. Seleccione el agente.

3. Pida al agente que busque un repositorio o un usuario. Por ejemplo, can you find a repo for kiota?.

4. Cuando se le solicite, seleccione Iniciar sesión en {agent-name}. En la ventana emergente, inicia sesión con tu cuenta de GitHub y autoriza al agente.

5. Cuando se cierra la ventana emergente, el agente devuelve una respuesta.

   

6. Si la herramienta a la que llama el agente devuelve un widget de interfaz de usuario (aplicación MCP), confirme que el agente representa el widget en línea en la respuesta. Para obtener más información, consulte Agregar aplicaciones MCP a agentes declarativos en Microsoft 365 Copilot.

Contenido relacionado

• Agregar aplicaciones MCP a agentes declarativos en Microsoft 365 Copilot