Conexión del agente a un servidor de Protocolo de contexto de modelo (MCP) existente

Si ya tiene configurado un servidor de Protocolo de contexto de modelo (MCP), puede conectar el servidor MCP al agente.

Hay dos maneras de conectar el agente a un servidor MCP en Copilot Studio:

• Agregue el servidor MCP en Copilot Studio mediante el Asistente para incorporación de MCP (recomendado)
• Crear un conector personalizado en el servidor a través de Power Apps

Si aún no tiene configurado un servidor MCP, consulte Creación de un nuevo servidor MCP para obtener información sobre cómo empezar.

Transportes admitidos

En MCP, los transportes son la base para la comunicación cliente-servidor. Los transportes se encargan de la mecánica de envío y recepción de mensajes. Actualmente, Copilot Studio admite el tipo de transporte que admite transmisión continua.

Opción 1: Usar el asistente de integración MCP (recomendado)

La manera más sencilla de conectarse a un servidor MCP existente se encuentra directamente en Copilot Studio mediante el Asistente para la incorporación de MCP.

Hay dos partes en este método:

• Configuración de los detalles básicos del servidor MCP
• Configuración de la autenticación con el servidor MCP

Configuración de los detalles básicos del servidor

1. Vaya a la página Herramientas del agente.

2. Seleccione Agregar una herramienta.

3. Seleccione Nueva herramienta.

4. Seleccione Protocolo de contexto de modelo. Aparece el asistente de configuración de MCP.

   

5. Rellene los campos obligatorios Nombre del servidor, Descripción del servidor y Dirección URL del servidor. Asegúrese de escribir una breve descripción clara de lo que hace el servidor MCP. El orquestador del agente usa esta información para identificar si se debe llamar al servidor en tiempo de ejecución.

6. Seleccione el tipo de autenticación para el servidor MCP, si procede. Tiene tres opciones:

   • Ninguno
   • Clave de API: Configuración de la autenticación de clave de API
   • OAuth 2.0: Configuración de la autenticación de OAuth 2.0

7. Si seleccionó Ninguno, seleccione Crear. Aparece el cuadro de diálogo Agregar herramienta . Vaya a Crear una nueva conexión y agregar el servidor MCP al agente.

Configuración de la autenticación con el servidor MCP

Si el servidor requiere autenticación, tiene dos opciones:

• Clave de API: seleccione esta opción si el servidor MCP requiere una clave de API para la autenticación. Una clave de API es una opción sencilla cuando solo la aplicación (agente) necesita autenticarse con el servidor.
• OAuth 2.0: seleccione esta opción si el servidor MCP usa OAuth 2.0 para la autenticación. OAuth 2.0 permite a los usuarios individuales autenticarse con el servidor y conceder permisos a la aplicación (agente) sin compartir sus credenciales.

Si decide usar la autenticación, debe configurar los detalles de autenticación. Los pasos dependen del tipo de autenticación que seleccione.

Configuración de la autenticación de clave de API

1. Seleccione Clave de API como tipo de autenticación. Aparecen más campos para configurar la clave de API.

2. Seleccione el tipo de clave de API que se va a usar. Tiene dos opciones:

   • Encabezado: seleccione esta opción si el servidor MCP requiere que se envíe la clave de API en el encabezado de solicitud.
   • Consulta: seleccione esta opción si el servidor MCP requiere que la clave de API se envíe como parámetro de consulta en la dirección URL.

3. Escriba el encabezado o la cadena de consulta adecuados para la clave de API.

4. Selecciona Crear. Aparece el cuadro de diálogo Agregar herramienta . Vaya a Crear una nueva conexión y agregar el servidor MCP al agente.

Configuración de la autenticación de OAuth 2.0

1. Seleccione OAuth 2.0 como tipo de autenticación.

2. Seleccione el tipo de autenticación de OAuth 2.0 que se va a usar. Tiene tres opciones:

   • Detección dinámica: seleccione esta opción si el servidor MCP admite el registro dinámico de cliente (DCR) de OAuth 2.0 con el mecanismo de detección. El cliente puede usar un punto de conexión de detección para detectar automáticamente los puntos de conexión necesarios y registrarse en el proveedor de identidades.
   • Dinámico: seleccione esta opción si el servidor MCP admite DCR dinámico de OAuth 2.0, pero no admite el mecanismo de detección dinámica. El cliente todavía puede registrarse con el proveedor de identidades, pero debe proporcionar manualmente los puntos de conexión necesarios.
   • Manual: seleccione esta opción si el servidor MCP requiere la configuración manual de la configuración de OAuth 2.0.

Detección dinámica

Si el servidor MCP admite el mecanismo registro dinámico de cliente (DCR) de OAuth 2.0, puede usar la opción de detección dinámica. Si se admite, DCR con detección es el método más sencillo para configurar la autenticación de OAuth 2.0 con el servidor MCP en Copilot Studio.

1. Seleccione Detección dinámica como tipo de autenticación de OAuth 2.0.

2. Seleccione Crear para agregar el servidor. El cliente usa el punto de conexión de detección para encontrar automáticamente los puntos de conexión necesarios y registrarse en el proveedor de identidades.

3. Seleccione Next (Siguiente) para continuar. Aparece el cuadro de diálogo Agregar herramienta .

4. Continúe con crear una nueva conexión y agregar el servidor MCP a su agente.

Dinámica

1. Seleccione Dinámico como tipo de autenticación de OAuth 2.0.

2. Rellene los campos obligatorios:

   • Dirección URL de autorización: la dirección URL del servidor del proveedor de identidades donde se puede acceder a los puntos de conexión de registro y autorización del cliente.
   • Plantilla de URL del token: el punto final en el que el agente intercambia un código de autorización (o token de actualización) por un token de acceso y token de actualización. El token de acceso permite al agente usar el servidor MCP en nombre del usuario. Los tokens de actualización permiten que el agente obtenga nuevos tokens de acceso y actualización desde el punto de conexión de actualización cuando expire el token de acceso anterior.

3. Seleccione Crear para agregar el servidor. Según la configuración, podría aparecer una dirección URL de callback. La URL de callback es donde el proveedor de identidades responde con el código de autorización después de que el usuario inicie sesión y conceda permisos a tu agente.

4. Si ve la URL de devolución de llamada, copie la dirección URL de devolución de llamada para agregarla al registro de su aplicación con su proveedor de identidades.

5. Seleccione Next (Siguiente) para continuar. Aparece el cuadro de diálogo Agregar herramienta .

6. Continúe con la creación de una nueva conexión y la adición del servidor MCP a su agente.

Manual de instrucciones

1. Seleccione Manual como tipo OAuth 2.0. Aparecen más campos para configurar las opciones de OAuth 2.0.

2. Rellene los campos obligatorios:

   • ID de cliente: el identificador de cliente que emite el proveedor de identidades cuando registras tu aplicación. El identificador de cliente permite al proveedor de identidades saber qué aplicación está realizando la solicitud.
   • Secreto de cliente: secreto de cliente que emite el proveedor de identidades al registrar la aplicación. El agente envía el secreto de cliente junto con el identificador de cliente para demostrar que el agente está autorizado para solicitar tokens de acceso para el servidor MCP.
   • Dirección URL de autorización: el punto de conexión del proveedor de identidades donde el agente redirige al usuario para iniciar sesión y conceder permisos al agente (tarjeta de consentimiento presentada en el chat del agente). El usuario se autentica aquí y luego el proveedor de identidades responde al agente en la dirección URL de devolución de llamada con un código de autorización.
   • Plantilla de URL de token: El punto de conexión en el que tu agente intercambia el código de autorización (o el token de actualización) por un token de acceso y un token de actualización. El token de acceso permite al agente usar el servidor MCP en nombre del usuario. Los tokens de actualización permiten que el agente obtenga nuevos tokens de acceso y actualización desde el punto de conexión de actualización cuando expire el token de acceso anterior.
   • Url de actualización: punto de conexión para solicitar un nuevo token de acceso mediante un token de actualización (de modo que el usuario no tenga que iniciar sesión de nuevo cuando expire el token).
   • Ámbitos (opcional): los permisos que solicita la aplicación, como una lista separada por espacios.

3. Seleccione Crear para agregar el servidor. Aparece una dirección URL de devolución de llamada . La URL de callback es donde el proveedor de identidades responde con el código de autorización después de que el usuario inicie sesión y conceda permisos a tu agente.

4. Copie la dirección URL de devolución de llamada para agregarla al registro de su aplicación con su proveedor de identidad.

5. Seleccione Next (Siguiente) para continuar. Aparece el cuadro de diálogo Agregar herramienta .

6. Continúe con crear una nueva conexión y agregue el servidor MCP a su agente.

Cree una nueva conexión y agregue el servidor MCP al agente.

1. En el cuadro de diálogo Agregar herramienta , seleccione Crear una nueva conexión para el servidor MCP o use una existente.

2. Seleccione Agregar al agente para terminar de agregar el servidor MCP al agente.

Opción 2: Creación de un conector MCP personalizado en Power Apps

Puede crear un conector personalizado en Power Apps manualmente para configurar una conexión al servidor.

Para llevar a cabo este procedimiento, necesita un archivo de esquema para el servidor MCP. El archivo de esquema es un archivo YAML de especificación OpenAPI que describe la API de su servidor MCP.

Para obtener instrucciones sobre el aspecto del archivo de especificación, consulte algunos de los ejemplos de esquema de servidor MCP proporcionados.

1. Vaya a la página Herramientas del agente.

2. Seleccione Agregar una herramienta.

3. Seleccione Nueva herramienta.

4. Seleccione Conector personalizado. Será redirigido a Power Apps para crear un nuevo conector personalizado.

5. Seleccione Nuevo conector personalizado.

6. Seleccione Importar archivo OpenAPI.

7. Vaya a su archivo de esquema y seleccione Importar para importar el archivo.

8. Seleccione Continuar para completar la configuración en Power Apps. Puede obtener más información sobre el proceso de configuración en la documentación de Power Apps en Importar la definición OpenAPI.

Ejemplo de esquema de servidor MCP

Este es un archivo de esquema openAPI de ejemplo para un servidor MCP mediante datos ficticios, en formato YAML. Debe completar los detalles de su propio servidor MCP. En este ejemplo se usa el tipo de transporte que admite transmisión continua.

swagger: '2.0'
info:
  title: Contoso
  description: MCP Test Specification, YAML for streamable MCP support in Copilot Studio
  version: 1.0.0
host: contoso.com
basePath: /
schemes:
  - https
paths:
  /mcp:
    post:
      summary: Contoso Lead Management Server
      x-ms-agentic-protocol: mcp-streamable-1.0
      operationId: InvokeMCP
      responses:
        '200':
          description: Success

Editar una conexión MCP

Para editar el conector MCP o agregar parámetros personalizados:

1. Vaya al portal de Power Apps o Power Automate y seleccione Conectores personalizados.
2. Busque el archivo del conector en la lista de conectores y realice las actualizaciones necesarias mediante uno de los métodos disponibles.