Registro y detección de servidores MCP en el inventario de API

En este artículo se describe cómo usar el Centro de API de Azure para mantener un inventario (o registro) de servidores de protocolo de contexto de modelos remotos o locales (MCP) y ayudar a las partes interesadas a detectarlos a través del portal del Centro de API. Los servidores MCP exponen las API de back-end o los orígenes de datos de forma estándar a los agentes y modelos de IA que los consumen.

Como se muestra en este artículo, puede registrar servidores MCP remotos o locales mediante Azure Portal similar a la forma en que registra las API y otros recursos. El Centro de API también proporciona vínculos a servidores MCP asociados que puede registrar en el inventario.

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

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.

La arquitectura MCP se basa 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

• Un centro de API. Si aún no tiene un centro de API, consulte el inicio rápido para crear un centro de API.
• Un punto de conexión remoto de dirección URL del servidor MCP o un paquete de servidor MCP que desea registrar.
• (Para un servidor MCP remoto) Un entorno del centro de API que se va a asociar al servidor MCP. El entorno es la ubicación del servidor MCP, como una plataforma de gestión de API o un servicio de cómputo.

Registro de un servidor MCP remoto

Para registrar un servidor MCP remoto:

1. Inicie sesión en Azure Portal y vaya al Centro de API.
2. En el menú de la barra lateral, en Inventario, seleccione Recursos.
3. Seleccione + Registrar un activoservidor MCP.
   
4. En el formulario Registrar un servidor MCP , proporcione la información sobre el servidor MCP:
   1. Escriba un título para el servidor MCP. El Centro de API genera automáticamente una identificación basada en el título, pero puede editarla si es necesario.
   2. Escriba un resumen y una descripción para el servidor MCP para proporcionar más contexto sobre él.
   3. Opcionalmente, escriba una dirección URL de icono para asociar una imagen con el servidor MCP.
   4. En Casos de uso, proporcione opcionalmente un nombre y una descripción para uno o varios casos de uso para el servidor MCP.
   5. En Remotos, haga lo siguiente:
      1. Seleccione + Agregar remoto.
      2. Escriba una dirección URL en tiempo de ejecución para el servidor MCP.
      3. Seleccione un entorno del Centro de API que corresponda a la ubicación del servidor MCP, como una plataforma de API Management o un servicio de proceso.
      4. Haga clic en Guardar.
      5. Opcionalmente, repita los pasos anteriores para agregar más remotos si el servidor MCP tiene varios puntos de conexión o se implementa en varios entornos.
   6. Opcionalmente, seleccione Agregar repositorio para proporcionar una dirección URL a un repositorio de código asociado al servidor MCP.
   7. En Título de la versión, proporcione un título de versión, identificación de versión y ciclo de vida de la versión para el servidor MCP. Obtenga más información sobre las versiones en el Centro de API.
   8. Opcionalmente, agregue vínculos de documentación externa y licencia y información asociada para el servidor MCP.
   9. Selecciona Crear.

Definiciones del servidor MCP remoto

El Centro de API genera automáticamente las siguientes definiciones de OpenAPI para un servidor MCP remoto y las asocia a la versión del servidor que registra:

• Definición de SSE, para usar eventos enviados por el servidor (SSE) como protocolo agente
• Definición que se puede transmitir para usar un protocolo de agentes de transporte independiente

Registro de un servidor MCP local

Puede registrar un servidor MCP instalado localmente mediante un administrador de paquetes como npm o pypi.

Para registrar un servidor MCP local:

1. Inicie sesión en Azure Portal y vaya al Centro de API.
2. En el menú de la barra lateral, en Inventario, seleccione Elementos.
3. Seleccione + Registrar un activo>servidor MCP.
4. En el formulario Registrar un servidor MCP , proporcione la información sobre el servidor MCP:
   1. Escriba un título para el servidor MCP. El Centro de API genera automáticamente una identificación basada en el título, pero puede editarla si es necesario.
   2. Escriba un resumen y una descripción para el servidor MCP para proporcionar más contexto sobre él.
   3. Opcionalmente, escriba una dirección URL de icono para asociar una imagen con el servidor MCP.
   4. En Casos de uso, proporcione opcionalmente un nombre y una descripción para uno o varios casos de uso para el servidor MCP.
   5. En Paquetes, haga lo siguiente:
      1. Seleccione + Agregar paquete.
      2. Escriba un registro de paquetes para la instalación del servidor MCP. Por ejemplo: npm.
      3. Escriba un nombre de paquete del registro de paquetes y una versión.
      4. En Sugerencia de tiempo de ejecución, escriba el comando de tiempo de ejecución que se utiliza para ejecutar el MCP. Por ejemplo: npx.
      5. En Argumentos en tiempo de ejecución, opcionalmente pase argumentos al ejecutar el servidor MCP.
      6. Haga clic en Guardar.
      7. Opcionalmente, repita los pasos anteriores para agregar más paquetes si el servidor MCP está disponible en varios registros de paquetes o tiene varias versiones.
   6. Opcionalmente, seleccione Agregar repositorio para proporcionar una dirección URL a un repositorio de código asociado al servidor MCP.
   7. En Título de la versión, proporcione un título de versión, identificación de versión y ciclo de vida de la versión para el servidor MCP. Obtenga más información sobre las versiones en el Centro de API.
   8. Opcionalmente, agregue vínculos de documentación externa y licencia y información asociada para el servidor MCP.
   9. Selecciona Crear.

Registro de un servidor MCP asociado

Azure API Center proporciona una lista seleccionada de servidores MCP asociados que puede agregar al inventario de API. Esta lista incluye servidores MCP de servicios de Microsoft, como Azure Logic Apps, GitHub y otros.

Registre uno o varios de los servidores MCP asociados en el inventario de API para que estén disponibles para los desarrolladores y otras partes interesadas de su organización.

Para registrar un servidor MCP asociado:

1. En Azure Portal, vaya al Centro de API.
2. En el menú de la barra lateral, en Detectar, seleccione MCP (versión preliminar).
3. Examine los servidores MCP de asociados disponibles. Seleccione Registrar para agregar un servidor MCP al inventario de API. Siga las instrucciones en pantalla si se proporcionan para completar el registro.

Al agregar un servidor MCP asociado, el Centro de API configura automáticamente las siguientes opciones:

• Crea una entrada de API en el inventario de API con el tipo de API establecido en MCP.
• Crea un entorno y una implementación para el servidor MCP.
• Agrega definiciones de OpenAPI para el servidor MCP si el asociado los proporciona.

Compilación y registro de sus propios servidores MCP

Para compilar servidores MCP mediante los servicios de proceso de Azure y registrarlos en el centro de API, consulte los ejemplos siguientes:

• Compilación y registro de un servidor MCP de Logic Apps
• Compilación y registro de un servidor MCP de Azure Functions

Detección de servidores MCP mediante el portal del Centro de API

Configure el portal del Centro de API para que los desarrolladores y otras partes interesadas de la organización puedan detectar servidores MCP en el inventario de API. En el portal del Centro de API, los usuarios pueden hacer lo siguiente:

• Examine y filtre los servidores MCP en el inventario.
• En el caso de los servidores MCP remotos, vea los detalles, como el punto de conexión de dirección URL del servidor MCP y la definición de API, e instale el servidor MCP en su entorno de Visual Studio Code.

Administrar el acceso a los servidores MCP

Opcionalmente, use las funcionalidades de administración de acceso del Centro de API para administrar quién puede ver y acceder a los servidores MCP del inventario. Para más información, consulte Autorización del acceso a las API en el centro de API.

Contenido relacionado

• Acerca de los servidores MCP en API Management
• Importe las API a su centro API desde API Management
• Utilice la extensión de Visual Studio para el Centro de API para crear y registrar API desde Visual Studio Code.
• Para obtener un ejemplo en directo de cómo Azure API Center puede impulsar el registro de MCP privado y listo para la empresa, visite centro de MCP.