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

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

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

  • Agregue el servidor MCP en Copilot Studio mediante el asistente para incorporación de MCP (recomendado)
  • Creación de 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 Streamable.

Nota:

Dado que el transporte SSE está en desuso, Copilot Studio ya no admite SSE para MCP después de agosto de 2025.

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

Este método tiene dos partes:

  • 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.

    Captura de pantalla del asistente de incorporación de MCP

  5. Rellene los campos obligatorios Nombre del servidor, Descripción del servidor y Dirección URL del servidor. Escriba una breve descripción, pero 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:

  7. Si seleccionó Ninguno, seleccione Crear. Aparece el cuadro de diálogo Agregar herramienta . Salta 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 para autenticarse con el servidor. El usuario del agente proporciona la clave de API y el agente lo incluye en las solicitudes al servidor MCP.
  • 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 nombre del encabezado o parámetro de consulta donde se debe incluir la clave de API.

  4. Seleccione Crear. Aparece el cuadro de diálogo Agregar herramienta . Salta 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.

Captura de pantalla del Asistente para incorporación de MCP con detección dinámica para OAuth 2.0 seleccionado

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

  2. Seleccione Crear para agregar el servidor. El cliente utiliza el punto de acceso de descubrimiento para localizar automáticamente los puntos de acceso necesarios y realizar el proceso de registro con el proveedor de identidad.

  3. Seleccione 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ámico

  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 Siguiente para continuar. Aparece el cuadro de diálogo Agregar herramienta .

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

Manual

  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, a continuación, el proveedor de identidades responde al agente 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 añadirlo al registro de su aplicación con su proveedor de identidad.

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

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

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

  1. En 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. Se le lleva 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 instalación en la documentación de Power Apps en Importar la definición de 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.
  • Last updated on