Detección de API con el servidor MCP del Centro de API de Azure

El servidor MCP del Centro de API de Azure expone el catálogo de API de la organización como una superficie de herramientas nativa para agentes de IA y flujos de trabajo agente. Al habilitar el servidor MCP del Centro de API, hará que las API y los recursos de inteligencia artificial sean reconocibles por el creciente ecosistema de clientes de IA compatibles con MCP, incluidos Visual Studio Code Copilot, Claude Code y agentes personalizados.

El servidor MCP del Centro de API de Azure expone las siguientes herramientas que usan los agentes para detectar y recuperar recursos del inventario (registro) del centro de API.

Herramienta Description
mcp_registry_search Busca en el registro de API Center para descubrir API y recursos de IA por nombre, tipo o metadatos. Devuelve resultados coincidentes, incluidos el tipo de recurso (REST, MCP, complemento, aptitud), el estado del ciclo de vida y las descripciones.
mcp_registry_fetch Captura información detallada sobre una API específica o un recurso de IA del registro, incluidos los puntos de conexión de implementación, las versiones, las definiciones y las especificaciones asociadas.

Prerequisites

  • Un centro de API en la suscripción de Azure. Si no tiene una, consulte Inicio rápido: Creación del centro de API.

  • Una o varias API o recursos de IA registrados en el inventario del centro de API, como servidores MCP o aptitudes.

  • El portal del centro de API está habilitado y configurado para su centro de API. Para más información, consulte Configuración y personalización del portal del Centro de API. El método de acceso que elija para el portal (autenticación anónima o Microsoft Entra ID) determina cómo se autentican los desarrolladores cuando acceden al servidor MCP.

  • Un cliente compatible con MCP, como Visual Studio Code con Copilot, Claude Code o un agente personalizado.

  • Para el uso de la CLI, asegúrese de que la herramienta de la CLI de MCP esté instalada.

Habilitación del servidor MCP del Centro de API de Azure

Para habilitar el servidor MCP mediante el portal de Azure:

  1. En Azure Portal, vaya al Centro de API.
  2. En el menú de la barra lateral, en Consumo, seleccione Configuración de Data API.
  3. En Punto de conexión de MCP, seleccione Habilitar punto de conexión MCP del Centro de API.

Captura de pantalla del punto de conexión MCP del Centro de API en el portal.

El punto de conexión del servidor MCP sigue este formato:

https://<service name>.data.<region>.azure-apicenter.ms/mcp

Ejemplo: https://myapicenter.data.eastus.azure-apicenter.ms/mcp

Importante

Puedes habilitar el endpoint MCP solo para el nivel Estándar. Si tu Centro de API está en el nivel Gratuito, debes actualizar a Estándar para habilitar el servidor MCP. Para más información sobre cómo actualizar tu centro de API, consulta las preguntas frecuentes.

Conexión al servidor MCP

Después de habilitar el servidor MCP del Centro de API, los desarrolladores pueden detectar el punto de conexión del servidor MCP cuando inicien sesión en el portal del Centro de API. Los desarrolladores pueden conectarse al servidor MCP mediante un cliente MCP, como Visual Studio Code o la CLI de MCP. La conexión requiere el punto de conexión del servidor MCP y las credenciales de autenticación adecuadas, si está configurada.

Para conectarse al servidor MCP mediante Claude Code, consulte Adición de un servidor MCP a Claude Code.

Conexión a través de VS Code

Los desarrolladores pueden añadir la configuración del servidor MCP a su archivo settings.json de Visual Studio Code bajo la clave mcp.

  1. Abra Visual Studio Code y presione Ctrl+Shift+P (o Cmd+Shift+P en Mac).

  2. Busque Open User Settings (JSON) (Abrir configuración de usuario [JSON]).

  3. Pegue el siguiente fragmento de código en la mcp clave y guarde el archivo. Sustituya el valor url por el extremo del servidor MCP de API Center.

    {
  "servers": {
    "api-center": {
      "url": "https://myapicenter.data.eastus.azure-apicenter.ms/mcp",
      "type": "http"
    }
  },
  "inputs": []
}

  4. VS Code Copilot detecta y se conecta automáticamente al servidor MCP.

Conexión a través de la CLI

Los desarrolladores pueden usar la CLI de MCP para conectarse directamente al servidor e invocar las herramientas del Registro.

  1. Conéctese al servidor MCP mediante un comando como en el ejemplo siguiente. Sustituya la dirección URL por el punto de conexión del servidor MCP del Centro de API.

    mcp connect http https://myapicenter.data.eastus.azure-apicenter.ms/mcp

  2. Busque activos en el registro:

    mcp run mcp_registry_search --query "customer-support"

  3. Obtener los detalles de un recurso específico:

    mcp run mcp_registry_fetch --id "my-agent-skill"

Contenido relacionado

  • Last updated on