Compartir a través de


Comience con el servidor MCP de Azure en Windsurf

El Azure servidor MCP usa el Protocolo de contexto de modelo (MCP) para estandarizar las integraciones entre las aplicaciones de IA y las herramientas externas y los orígenes de datos, lo que permite a los sistemas de inteligencia artificial realizar operaciones que tienen en cuenta el contexto de los recursos de Azure.

En este artículo, aprenderá a completar las siguientes tareas:

  • Instalación y autenticación en el servidor MCP de Azure
  • Conexión a Azure servidor MCP mediante el entorno de desarrollo con tecnología de inteligencia artificial de Windsurf
  • Ejecutar comandos para probar las operaciones del servidor MCP de Azure e interactuar con recursos de Azure.

Prerrequisitos

Instalación del servidor MCP de Azure

Para instalar y configurar Azure servidor MCP en Windsurf:

  1. Vaya a Archivo > Preferencias > Configuración de Windsurf.

  2. En la página Configuración de windsurf , seleccione Administrar MCP.

    Captura de pantalla que muestra cómo configurar un servidor MCP en Windsurf.

  3. En la página Administrar configuración de servidores MCP , seleccione Ver configuración sin procesar en la parte superior para abrir el mcp_config.json archivo para su edición.

  4. El mcp_config.json archivo le permite instalar manualmente servidores MCP agregando un objeto de configuración JSON. Actualice el mcp_config.json archivo para que coincida con lo siguiente:

    {
    "mcpServers": {
          "Azure MCP Server": {
            "command": "npx",
            "args": [
                "-y",
                "@azure/mcp@latest",
                "server",
                "start"
            ]
        }
        }
    }
    

Autenticación en Azure

Azure servidor MCP proporciona una experiencia de autenticación sin problemas mediante Azure cuentas y Microsoft Entra ID. Para usar Azure servidor MCP, primero debe autenticarse en Azure mediante herramientas de desarrollo locales como la Azure CLI, la CLI de Azure Developer, Visual Studio o Visual Studio Code. Servidor MCP de Azure detecta automáticamente las credenciales de estas herramientas y las usa para autenticarse en los servicios de Azure.

  1. Por ejemplo, para iniciar sesión con el Azure CLI:

    az login
    
  2. Para comprobar el estado de autenticación, ejecute el comando siguiente para ver con qué cuenta y suscripción ha iniciado sesión actualmente:

    az account show
    
  3. Asegúrese de que la cuenta de usuario tiene las asignaciones de roles adecuadas para los servicios de Azure con los que desea interactuar. Los recursos de Azure a los que pretende acceder con Azure servidor MCP ya deben existir dentro de la suscripción de Azure. Por ejemplo, las asignaciones de roles comunes incluyen:

    • Colaborador de datos de Blob Storage: lectura y escritura de datos de Blob en cuentas de almacenamiento.
    • Colaborador de la cuenta de almacenamiento : administre las configuraciones de la cuenta de almacenamiento.
    • Colaborador : administración general de recursos en toda la suscripción.
    • Reader: acceso de solo lectura a los recursos de Azure.

    Para obtener más información sobre las asignaciones de roles y la autenticación de desarrollo local, consulte Autenticar aplicaciones .NET a servicios de Azure durante el desarrollo local.

Usar avisos para probar el servidor MCP de Azure

  1. Abra la interfaz de chat ai de Windsurf presionando Ctrl+L o haciendo clic en el icono de chat en la barra lateral.

  2. Escriba un mensaje que utilice las capacidades del servidor Azure MCP, como:

    List my Azure storage accounts
    
  3. Si se le pide que se autentique en Azure, ejecute la herramienta de autenticación sugerida para iniciar sesión a través del explorador.

    Nota:

    Windsurf no le pide que inicie sesión en Azure si ya está autenticado a través de otras herramientas locales, como el Azure CLI.

  4. Windsurf le pide que ejecute una herramienta para recuperar las cuentas de almacenamiento, como storage account list. Seleccione Ejecutar herramienta para continuar.

    La salida debe ser similar al texto siguiente:

    The following resource groups are available for your subscription:
    
    1. **DefaultResourceGroup-EUS** (Location: `eastus`)
    2. **rg-testing** (Location: `centralus`)
    3. **rg-azd** (Location: `eastus2`)
    4. **msdocs-sample** (Location: `southcentralus`)
    5. **ai-testing** (Location: `eastus2`)
    
    Let me know if you need further details or actions related to any of these resource groups!
    
  5. Explora más operaciones de MCP de Azure con otras indicaciones pertinentes, como:

    List all of the storage accounts in my subscription
    Get the available tables in my storage accounts
    Show me the configuration of my App Service instances
    

Pasos siguientes