Compartir a través de

Compilación de complementos desde un servidor MCP para Microsoft 365 Copilot

Esta guía le guiará a través del proceso de integración del servicio con Microsoft 365 Copilot agregando un servidor MCP a un agente declarativo mediante microsoft 365 Agents Toolkit. Siguiendo estos pasos, habilitará el acceso conversacional con tecnología de inteligencia artificial a los servicios expuestos por MCP para los usuarios empresariales.

Requisitos previos

Antes de empezar, asegúrese de que tiene los siguientes requisitos previos:

Creación del agente

Para crear el agente:

  1. Abra Visual Studio Code y seleccione el icono Microsoft 365 Agents Toolkit (Kit de herramientas de agentes de Microsoft 365) en la barra de actividad.

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

    Captura de pantalla de la interfaz del kit de herramientas de agentes

  3. Seleccione Agente declarativo.

  4. Seleccione Agregar una acción y, a continuación, seleccione Iniciar con un servidor MCP.

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

    Captura de pantalla del símbolo del sistema para escribir la dirección URL del servidor MCP

  6. Elija una ubicación para el proyecto del agente.

  7. Escriba un nombre para el agente.

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

Adición de herramientas desde el servidor MCP

Para agregar herramientas desde el servidor MCP:

  1. Abra el archivo .vscode/mcp.json . Seleccione el botón Iniciar en el editor de archivos.

  2. Si se le pide que se autentique, seleccione Permitir para autenticarse.

  3. Seleccione el botón ATK: Capturar acción de MCP en el editor de archivos y, a continuación, seleccione ai-plugin.json.

    Captura de pantalla de los botones

  4. Seleccione las operaciones para que el agente las use. Para este ejercicio, elija search_repositories y search_users.

    Captura de pantalla de la interfaz de selección de herramientas en VS Code

    Importante

    Se admiten herramientas y widgets de experiencia de usuario de servidores MCP remotos. Para obtener más información, vea Agregar widgets de interfaz de usuario interactivos a agentes declarativos.

  5. Seleccione OAuth (con registro estático) como tipo de autenticación.

    Captura de pantalla del símbolo del sistema para elegir el tipo de autenticación

Registro de una aplicación de OAuth con GitHub

Para registrar una aplicación de OAuth:

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

  2. Agregue un nombre y una dirección URL de página principal para la aplicación y establezca https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect como la 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 para usarlos en la sección siguiente.

Empaquetar y transferir localmente el agente

Para empaquetar el agente:

  1. Abra el proyecto del agente en Visual Studio Code.

  2. Seleccione el icono microsoft 365 Agents Toolkit en la barra de actividad de la izquierda.

  3. En el panel Cuentas , seleccione Iniciar sesión en Microsoft 365. (Si ya ha iniciado sesión, continúe con el paso siguiente).

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

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

  6. Cuando se le pida que escriba el identificador de cliente para el registro de OAuth..., escriba el identificador de cliente.

  7. Cuando se le pida que escriba el secreto de cliente para el registro de OAuth..., escriba el secreto de cliente.

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

  9. Lea el mensaje en el cuadro de diálogo y seleccione Confirmar para continuar.

  10. Espere a que el kit de herramientas informe de que ha terminado el aprovisionamiento.

Uso del 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, busque el agente. Aparece como el nombre que proporcionó en la sección Crear el agente , con dev 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, inicie sesión con su cuenta de GitHub y autorice al agente.

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

    Captura de pantalla de la respuesta del agente a una consulta de repositorios

Contenido relacionado

  • Last updated on