Exposición de la API REST en API Management como un servidor MCP

SE APLICA A: Básico | Estándar | Premium

En API Management, puede exponer una API REST administrada en API Management como un servidor remoto de Protocolo de contexto de modelo (MCP). Exponga una o varias de las operaciones de API como herramientas a las que los clientes de MCP pueden llamar mediante el protocolo MCP.

El uso de API Management para exponer servidores MCP remotos proporciona control centralizado sobre la autenticación, la autorización y la supervisión. Simplifica el proceso de exponer LAS API como servidores MCP, a la vez que ayuda a mitigar los riesgos comunes de seguridad y a garantizar la escalabilidad.

Nota:

Esta funcionalidad actualmente está en su versión preliminar. Se publica primero en el grupo de actualizaciones anticipadas de AI Gateway. Después de unirse al grupo, puede tardar 2 horas en acceder a las características del servidor MCP.

En este artículo aprenderá a:

• Exposición de una API REST en API Management como servidor MCP
• Configurar directivas para el servidor MCP
• Probar el servidor MCP generado desde un cliente MCP

Acerca de los servidores MCP

Los agentes de inteligencia artificial se están adoptando ampliamente debido a las funcionalidades mejoradas del modelo de lenguaje grande (LLM). Sin embargo, incluso los modelos más avanzados se enfrentan a limitaciones debido a su aislamiento de datos externos. Cada nuevo origen de datos puede requerir implementaciones personalizadas para extraer, preparar y hacer que los datos sean accesibles para los modelos.

El protocolo de contexto del modelo (MCP) ayuda a resolver este problema. MCP es un estándar abierto para conectar modelos y agentes de inteligencia artificial con orígenes de datos externos, como orígenes de datos locales (bases de datos o archivos de equipo) o servicios remotos (sistemas disponibles a través de Internet, como bases de datos remotas o API).

Arquitectura de MCP

En el diagrama siguiente se muestra la arquitectura de MCP:

La arquitectura consta de los siguientes componentes:

Componente	Descripción
Servidores de MCP	Aplicaciones LLM, como aplicaciones de chat o asistentes de inteligencia artificial en los IDE (como GitHub Copilot en Visual Studio Code) que necesitan acceder a funcionalidades externas
Clientes MCP	Clientes de protocolo, dentro de la aplicación host, que mantienen conexiones 1:1 con servidores
Servidores MCP	Programas ligeros que exponen funcionalidades específicas y proporcionan contexto, herramientas y mensajes a los clientes
Protocolo MCP	La capa de transporte central

MCP sigue una arquitectura de servidor cliente donde una aplicación host puede conectarse a varios servidores. Siempre que el host o el cliente de MCP necesiten una herramienta, se conecta al servidor MCP. A continuación, el servidor MCP se conecta a, por ejemplo, una base de datos o una API. Los hosts y servidores de MCP se conectan entre sí a través del protocolo MCP.

Servidores MCP locales frente a remotos

MCP utiliza una arquitectura cliente-host-server basada en JSON-RPC 2.0 para la mensajería. La comunicación entre clientes y servidores se produce a través de capas de transporte definidas y admite principalmente dos modos de funcionamiento:

• Servidores MCP remotos : los clientes MCP se conectan a servidores MCP a través de Internet, estableciendo una conexión mediante eventos enviados por HTTP y servidor (SSE) y autorizando el acceso del cliente MCP a los recursos de la cuenta del usuario mediante OAuth.

• Servidores MCP locales Los clientes MCP se conectan a servidores MCP en la misma máquina mediante la entrada y salida estándar como un método de transporte local.

Prerrequisitos

• Complete el siguiente inicio rápido: Creación de una instancia de Azure API Management. Actualmente solo los niveles Premium, Estándar y Básico de API Management admiten servidores MCP.
• Asegúrese de que la instancia administra una API REST que le gustaría exponer como un servidor MCP. Para importar una API de ejemplo, consulte Importación y publicación de la primera API.

  Nota:

  Solo las API HTTP de API Management se pueden exponer como servidores MCP.

• Para probar el servidor MCP, puede usar Visual Studio Code con acceso a GitHub Copilot.

Exponer la API como un servidor MCP

1. En Azure Portal, acceda a la versión preliminar del servidor MCP en la siguiente dirección URL:

   https://portal.azure.com/?Microsoft_Azure_ApiManagement=mcp
   

2. Dirígete a tu instancia de Administración de API.

3. En el menú izquierdo, seleccione API>> (Servidores MCP+ Crear nuevo servidor MCP).

4. En API, seleccione una API REST para exponerla como un servidor MCP.

5. Seleccione una o varias operaciones de API para exponerlas como herramientas. Puede seleccionar todas las operaciones o solo operaciones específicas.

6. Selecciona Crear.

El servidor MCP se crea y las operaciones de API se exponen como herramientas. El servidor MCP aparece en el panel Servidores MCP . La columna URL muestra el punto de conexión del servidor MCP al que puede llamar para realizar pruebas o dentro de una aplicación cliente.

Configurar directivas para el servidor MCP

Configure una o varias directivas de API Management para ayudar a administrar el servidor MCP. Las directivas se aplican a todas las operaciones de API expuestas como herramientas en el servidor MCP y se pueden usar para controlar el acceso, la autenticación y otros aspectos de las herramientas.

Para ver un tutorial sobre cómo configurar directivas, consulte Transformación y protección de la API.

Para configurar directivas para el servidor MCP:

1. En el portal, en API, seleccione Servidores MCP.

2. Seleccione el servidor MCP que creó.

3. En el menú izquierdo, en MCP, seleccione Directivas.

4. En el editor de directivas, agregue o edite las directivas que desea aplicar a las herramientas del servidor MCP. Las directivas se definen en formato XML. Por ejemplo, puede agregar una directiva para limitar las llamadas a las herramientas del servidor MCP (en este ejemplo, 5 llamadas por cada 30 segundos por dirección IP del cliente).

    <rate-limit-by-key calls="5" renewal-period="30" counter-key="@(context.Request.IpAddress)" remaining-calls-variable-name="remainingCallsPerIP" />
   

   

Prueba y uso del servidor MCP

Para comprobar que el servidor MCP funciona, puede usar Visual Studio Code para enviar solicitudes a las herramientas del servidor MCP.

En Visual Studio Code, use el chat de GitHub Copilot en modo agente (versión preliminar) para agregar el servidor MCP y usar las herramientas. Para obtener información sobre los servidores MCP en Visual Studio Code, consulte Uso de servidores MCP en VS Code (versión preliminar).

Adición del servidor MCP en Visual Studio Code

Para agregar el servidor MCP en Visual Studio Code:

1. Use el comando MCP: Agregar servidor desde la paleta de comandos.

2. Cuando se le solicite, seleccione el tipo de servidor: HTTP (HTTP o Eventos enviados por el servidor).

3. Escriba la dirección URL del servidor MCP en API Management. Ejemplo: https://<apim-service-name>.azure-api.net/<api-name>-mcp/sse (para el punto de conexión SSE) o https://<apim-service-name>.azure-api.net/<api-name>-mcp/mcp (para el punto de conexión de MCP)

4. Escriba un identificador de servidor de su elección.

5. Seleccione si desea guardar la configuración en la configuración del área de trabajo o en la configuración del usuario.

   • Configuración del área de trabajo : la configuración del servidor se guarda en un .vscode/mcp.json archivo solo disponible en el área de trabajo actual.

   • Configuración del usuario: la configuración del servidor se agrega al archivo global settings.json y está disponible en todas las áreas de trabajo. La configuración es similar a la siguiente:

   

Agregue campos a la configuración JSON para ajustes como el encabezado de autenticación. En el ejemplo siguiente se muestra la configuración de una clave de suscripción de API Management que se pasa en un encabezado como valor de entrada. Más información sobre el formato de configuración

Uso de herramientas en modo de agente

Después de agregar un servidor MCP, puede usar herramientas en modo agente.

1. En el chat de GitHub Copilot, seleccione Modo de agente y seleccione el botón Herramientas para ver las herramientas disponibles.

   

2. Seleccione una o varias herramientas del servidor MCP para que estén disponibles en el chat.

   

3. Escriba un mensaje en el chat para invocar la herramienta. Por ejemplo, si seleccionó una herramienta para obtener información sobre un pedido, puede preguntar al agente sobre un pedido.

   Get information for order 2
   

   Seleccione Continuar para ver los resultados. El agente usa la herramienta para llamar al servidor MCP y devuelve los resultados en el chat.

   

Contenido relacionado

• Ejemplo de Python: Protección de servidores MCP remotos mediante Azure API Management (experimental)

• Laboratorio de autorización de cliente de MCP

• Uso de la extensión de Azure API Management para VS Code para importar y administrar LAS API

• Registro y detección de servidores MCP remotos en el Centro de API de Azure