Conexión a servidores de Protocolo de contexto de modelo (versión preliminar) (clásico)

Puede ampliar las funcionalidades de su agente de Foundry conectándolo a herramientas hospedadas en servidores remotos del Protocolo de Contexto de Modelo (MCP), aportando su propio punto de conexión de servidor MCP. Los desarrolladores y las organizaciones mantienen estos servidores. Los servidores exponen herramientas a las que pueden acceder los clientes compatibles con MCP, como foundry Agent Service.

MCP es un estándar abierto que define cómo las aplicaciones proporcionan herramientas y datos contextuales a modelos de lenguaje grandes (LLM). Permite una integración coherente y escalable de herramientas externas en flujos de trabajo de modelo.

Consideraciones para usar servicios y servidores no pertenecientes a Microsoft

El uso de servicios conectados que no pertenecen a Microsoft está sujeto a los términos entre usted y el proveedor de servicios. Cuando se conecta a un servicio que no es de Microsoft, algunos de los datos (como el contenido del mensaje) se pasan al servicio que no es de Microsoft o la aplicación puede recibir datos del servicio que no es de Microsoft. Usted es responsable de su uso de servicios que no sean de Microsoft y de los datos, junto con cualquier cargo asociado con ese uso.

Los servidores MCP remotos que decide usar con la herramienta MCP descrita en este artículo se crearon por terceros, no Microsoft. Microsoft no ha probado ni comprobado estos servidores. Microsoft no tiene responsabilidad alguna con respecto a su uso de servidores MCP remotos.

Le recomendamos que revise detenidamente y realice un seguimiento de los servidores MCP que agregue al servicio foundry Agent. También se recomienda confiar en servidores hospedados por proveedores de servicios de confianza en lugar de servidores proxy.

La herramienta MCP permite pasar encabezados personalizados, como claves de autenticación o esquemas, que podría necesitar un servidor MCP remoto. Se recomienda revisar todos los datos que se comparten con servidores MCP remotos y que registre los datos con fines de auditoría. Sea consciente de las prácticas que no son de Microsoft para la retención y la ubicación de los datos.

Cómo funciona

Debe traer un servidor MCP remoto (un punto de conexión de servidor MCP existente) a Foundry Agent Service. Puede traer varios servidores MCP remotos agregándolos como herramientas. Para cada herramienta, debe proporcionar un valor único server_label dentro del mismo agente y un server_url valor que apunte al servidor MCP remoto. Asegúrese de revisar cuidadosamente qué servidores MCP añade al Servicio de Agente de Foundry.

La herramienta MCP admite encabezados personalizados, por lo que puede conectarse a los servidores MCP mediante los esquemas de autenticación que requieren o pasando otros encabezados que requieren los servidores MCP. Solo puede especificar encabezados incluyéndolos en tool_resources a cada ejecución. De este modo, puede colocar claves de API, tokens de acceso de OAuth u otras credenciales directamente en la solicitud.

El encabezado más usado es el encabezado de autorización. Los encabezados que se pasen estarán disponibles solo para la ejecución actual y no se conservarán.

Para obtener más información sobre el uso de MCP, consulte:

• Procedimientos recomendados de seguridad en el sitio web del Protocolo de contexto de modelo.
• Introducción y mitigación de riesgos de seguridad en implementaciones de MCP en el blog de Seguridad de Microsoft Community.

Soporte de uso

Configuración

1. Cree un agente de Foundry siguiendo los pasos descritos en el inicio rápido.

2. Busque el servidor MCP remoto al que desea conectarse, como el GitHub servidor MCP. Cree o actualice un agente de Foundry con una herramienta mcp con la siguiente información:

   1. server_url: la dirección URL del servidor MCP; por ejemplo, https://api.githubcopilot.com/mcp/.
   2. server_label: un identificador único de este servidor MCP para el agente; por ejemplo, github.
   3. allowed_tools: una lista opcional de herramientas a las que este agente puede acceder y usar.

3. Inicie una ejecución y transmita información adicional sobre la mcp herramienta en tool_resources con los encabezados:

   1. tool_label: Use el identificador que proporcionó al crear el agente.
   2. headers: pase un conjunto de encabezados que requiere el servidor MCP.
   3. require_approval: opcionalmente, determine si se requiere aprobación. Los valores admitidos son:
      • always: un desarrollador debe proporcionar aprobación para cada llamada. Si no proporciona un valor, este es el valor predeterminado.
      • never: no se requiere ninguna aprobación.
      • {"never":[<tool_name_1>, <tool_name_2>]}: proporciona una lista de herramientas que no requieren aprobación.
      • {"always":[<tool_name_1>, <tool_name_2>]}: proporciona una lista de herramientas que requieren aprobación.

4. Si el modelo intenta invocar una herramienta en el servidor MCP con la aprobación necesaria, obtendrá un estado de ejecución de requires_action. En el campo requires_action, puede obtener más detalles sobre qué herramienta se llama en el servidor MCP, los argumentos que se van a pasar y el valor call_id. Revise la herramienta y los argumentos para que pueda tomar una decisión informada para su aprobación.

5. Envíe la aprobación al agente con call_id estableciendo approve en true.

Hospedaje de un servidor MCP local

El entorno de ejecución del servicio del agente solo acepta un punto de conexión remoto del servidor MCP. Si desea agregar herramientas desde un servidor MCP local, tendrá que auto-alojarlo en Azure Container Apps o Azure Functions para obtener un punto de conexión de servidor MCP remoto. Preste atención a las siguientes consideraciones al intentar hospedar servidores MCP locales en la nube:

Limitaciones conocidas

• Tiempo de espera de llamada de la herramienta MCP no streaming: las llamadas no streaming a la herramienta MCP tienen un tiempo de espera de 50 segundos. Si el servidor MCP tarda más de 50 segundos en responder, se produce un error en la llamada. Para evitar tiempos de espera, asegúrese de que el servidor MCP responde dentro de este límite. Si el caso de uso requiere tiempos de procesamiento más largos, considere la posibilidad de optimizar la lógica del lado servidor o dividir la operación en pasos más pequeños.

Contenido relacionado

• Ejemplos de código para la herramienta Protocolo de contexto de modelo