Registro de servidores MCP hospedados en Azure Functions en el Centro de API de Azure

Después de hospedar el servidor MCP de forma remota en Azure Functions, regístrelo en el Centro de API de Azure. Azure API Center mantiene un inventario (o registro) de servidores MCP remotos para que se puedan detectar fácilmente en toda la organización. Todos los servidores MCP registrados aparecen en el portal del Centro de API para los equipos de su organización.

Sugerencia

El nombre del Centro de API se convierte en el nombre de tu catálogo privado de herramientas en el filtro del registro. Elija un nombre informativo que ayude a los usuarios a identificar el catálogo de herramientas de su organización.

Crear recursos

1. Inicie sesión en Azure Portal y cree un recurso del Centro de API de Azure si aún no tiene uno.

2. Cree un entorno en el recurso del Centro de API. EnTipo de>, seleccione Azure Functions.

Registro del servidor MCP

Registre el servidor MCP remoto agregándolo como UNA API:

1. En el panel de navegación izquierdo del recurso del Centro de API, seleccione API.

2. Seleccione + Registrar una API. En la tabla siguiente se proporcionan valores de ejemplo para la configuración necesaria. También puede rellenar la configuración opcional, como la descripción del servidor MCP, el repositorio, la documentación externa y otra información que se muestra en el portal del Centro de API.

   Configuración	Importancia
   Título de LA API	Escriba un nombre descriptivo para el servidor MCP, como Weather MCP Server.
   Identificación	Este valor se genera automáticamente en función del título de la API, pero puede modificarlo.
   Tipo de API	MCP
   URL del runtime	Escriba el punto de conexión del servidor MCP, como https://contoso.azurewebsites.net/mcp
   Medio ambiente	Seleccione el entorno que creó anteriormente.
   Título de la versión	Escriba un título de versión de su elección, como v1.
   Identificación de la versión	Después de escribir el título anterior, Azure API Center genera este identificador, que puede invalidar.
   Ciclo de vida de una versión	Seleccione el valor más adecuado en la lista desplegable, como Pruebas o Producción.

3. Selecciona Crear.

   Ahora debería ver el servidor MCP registrado como una API en la lista.

Actualización de la definición del servidor

1. Cree una definición de API para un servidor MCP remoto en formato OpenAPI 3.0. Necesitas esta definición para que el portal del Centro de API muestre el punto de conexión URL del servidor MCP. Guarde la definición donde puede acceder a ella. Usted debe cargarlo en el siguiente paso.

   Ejemplo de definición de API de OpenAPI 3.0 para el servidor MCP:

   {
       "openapi": "3.0.0",
       "info": {
           "title": "Weather MCP server",
           "description": "MCP server with tools returning weather forecast and alerts.",
           "version": "1.0"
       },
       "servers": [
           {
               "url": "https://my-mcp-server.azurewebsites.net/mcp"
           }
       ]
   }
   

2. Actualice la definición del servidor:

   a) En el menú de la izquierda, busque Recursos:> API.

   b. Seleccione el nombre del servidor MCP para abrir el registro.

   c. En el menú de la izquierda, busque Detalles:> versiones.

   d. En "Versión", busque y expanda "v1". A continuación, seleccione Definición que se puede transmitir para... para abrir la definición.

   d. Seleccione Reemplazar.

   e. En el panel lateral que se abre, cambie la "Versión de especificación" a 3.0 y cargue la definición desde el último paso.

   f. Seleccione Reemplazar.

Configuración del portal del Centro de API

1. Configure el portal si aún no tiene uno.

2. Una vez configurado el portal, puede acceder a él en https://<service-name>.portal.<location>.azure-apicenter.ms. Reemplace <service-name> y <location> por el nombre del centro de API y la ubicación donde la implementó. Debe iniciar sesión para ver los servidores MCP registrados.

3. Al seleccionar un nombre de servidor, se abre un panel que muestra información basada en los datos proporcionados durante el registro del servidor y la definición de API cargada. Los usuarios con acceso al portal pueden conectarse a los servidores de su elección copiando la dirección URL del punto de conexión o la instalación en la integración de Visual Studio Code.

   

Artículos relacionados

Acerca de los servidores MCP en Azure API Management