Compartir a través de

Compilación de complementos desde un servidor MCP para Microsoft 365 Copilot (versión preliminar)

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.

Importante

Esta característica está disponible actualmente en versión preliminar pública.

Requisitos previos

Creación del 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 de la izquierda.

  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.

Una vez completados 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

  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

    Solo se admiten herramientas de servidores MCP.

  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

  1. Vaya a https://github.com/settings/developers en el explorador. Seleccione Aplicaciones de OAuth y, a continuación, 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

  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.

Importante

Aunque esta característica se encuentra en versión preliminar pública, es posible que se produzca un error en la validación del manifiesto para los parámetros de función en los siguientes casos.

  • Objetos anidados en el properties miembro
  • Propiedades del properties miembro con los minimummiembros , maximumo default presentes

Si se produce un error en el paso durante el teamsApp/validateAppPackage aprovisionamiento, quite los miembros no admitidos y vuelva a intentar el paso de aprovisionamiento.

Uso del 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. Se muestra 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

  • Last updated on