Compartir a través de

Registro y detección de servidores MCP remotos 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 modelo remoto (MCP) y ayudar a las partes interesadas a detectarlos mediante el 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.

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.

Registro manual de un servidor MCP en el inventario de API

En las secciones siguientes se describe cómo realizar un inventario manual de un servidor MCP remoto en el centro de API.

Tipo de API de MCP

Registre manualmente un servidor MCP en el inventario del centro de API de forma similar a la manera de registrar otras API, especificando el tipo de API como MCP. Para registrar una API mediante Azure Portal, consulte Tutorial: Registro de API en el inventario de API.

Como se describe en las secciones siguientes, al registrar un servidor MCP, puede especificar un entorno, una implementación y una definición.

Tip

Si administra servidores MCP en Azure API Management, puede habilitar la sincronización automática para mantener el centro de API actualizado con los servidores MCP y otras API de la instancia de API Management. Para más información, consulte Synchronize API from Azure API Management instance (Sincronizar API desde la instancia de Azure API Management).

Entorno e implementación para el servidor MCP

En el Centro de API, especifique un entorno y una implementación para el 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, y la implementación es una URL de ejecución para el servicio MCP.

Para obtener información sobre cómo crear un entorno y una implementación, consulte Tutorial: Adición de entornos e implementaciones para las API.

Definición del servidor MCP remoto

Opcionalmente, agregue una definición de API para un servidor MCP remoto en formato OpenAPI 3.0. La definición de API debe incluir un punto de conexión de dirección URL para el servidor MCP. Para obtener un ejemplo de cómo agregar una definición de OpenAPI, consulte Tutorial: Registro de API en el inventario de API.

Puede usar la siguiente definición de API ligera de OpenAPI 3.0 para el servidor MCP, que incluye un url punto de conexión para el servidor MCP:

{
  "openapi": "3.0.0",
  "info": {
    "title": "Demo MCP server",
    "description": "Very basic MCP server that exposes mock tools and prompts.",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://my-mcp-server.contoso.com"
    }
  ]
}

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.

Captura de pantalla de los servidores MCP asociados en el portal.

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 proporciona para completar el registro.

Al agregar un servidor MCP asociado, el Centro de API configura automáticamente lo siguiente:

  • 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 una definición de OpenAPI para el servidor MCP si está disponible desde el asociado.

Para compilar y registrar un servidor MCP de Logic Apps, consulte Compilación y registro de un servidor MCP de Logic Apps.

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. Los usuarios pueden examinar y filtrar servidores MCP en el inventario y ver detalles, como el punto de conexión URL del servidor MCP, si están disponibles en la definición de API del servidor MCP.

Captura de pantalla del servidor MCP en el portal del Centro de API.

Note

El punto de conexión de dirección URL del servidor MCP solo es visible en el portal del Centro de API si se configura una implementación de MCP y una definición de API para el servidor MCP en el centro de API.

Contenido relacionado

  • Last updated on