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

Puede ampliar las funcionalidades del agente de Foundry mediante la conexión a herramientas hospedadas en servidores remotos del Protocolo de Contexto de Modelo (MCP) especificando 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 servidores y servicios que no son de Microsoft

El uso de servicios conectados que no son de 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 del uso de datos y servicios que no son de Microsoft, junto con los cargos asociados a ese uso.

Los servidores MCP remotos que decide usar con la herramienta MCP que se describe en este artículo se crearon mediante terceros, no Microsoft. Microsoft no ha probado ni comprobado estos servidores. Microsoft no tiene ninguna responsabilidad para usted u otros usuarios en relación con el uso de cualquier servidor MCP remoto.

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 llevar un servidor MCP remoto (un punto de conexión de servidor MCP existente) al servicio Foundry Agent. 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 agrega 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. Puede especificar encabezados incluyéndolos en tool_resources en 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 pasan solo están disponibles para la ejecución actual y no se conservan.

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.
• Descripción y mitigación de los riesgos de seguridad en las implementaciones de MCP en el blog de la comunidad de seguridad de Microsoft.

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 servidor MCP de GitHub. Cree o actualice un agente de Foundry con la 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. Cree una ejecución y pase información adicional sobre la herramienta mcp en tool_resources con 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 de call_id. Revise la herramienta y los argumentos para que pueda tomar una decisión informada para su aprobación.

5. Envíe su aprobación al agente con call_id estableciendo approve a 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 quiere agregar herramientas desde un servidor MCP local, tendrá que hospedarla automáticamente en Azure Container Apps o Azure Functions para obtener un punto de conexión remoto del servidor MCP. Preste atención a las siguientes consideraciones al intentar hospedar servidores MCP locales en la nube:

Contenido relacionado

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