Inicio rápido: Crea un servidor MCP alojado en Connector Namespace (vista previa)

Implementación mediante la CLI para desarrolladores de Azure

La forma más sencilla de desplegar un servidor SQL MCP es ir al ejemplo azure-sql-mcp y seguir las instrucciones README para desplegar usando la CLI de desarrollo de Azure o azd. La muestra contiene archivos de Bicep que le permiten aprovisionar un espacio de nombres de conector, un servidor SQL MCP, una base de datos SQL y otros recursos de Azure necesarios con un solo comando.

Si prefieres desplegar un servidor SQL MCP y los recursos necesarios de principio a fin, sigue las instrucciones a continuación.

• Un servidor Azure SQL Database con una base de datos. Si no tiene una, cree una base de datos Azure SQL.

• CLI de Data API Builder (DAB) instalada.

Inicialización de la base de datos SQL

1. En el portal de Azure, vaya a la base de datos SQL (no al servidor).

2. En el menú de la izquierda, seleccione Editor de consultas e inicie sesión como administrador de la base de datos.

3. Seleccione Nueva consulta y ejecute el siguiente comando para inicializar la base de datos:

   CREATE TABLE dbo.Books
   (
      Id int IDENTITY(1,1) PRIMARY KEY,
      Title nvarchar(200) NOT NULL
   );
   
   INSERT INTO dbo.Books (Title) VALUES (N'The little prince');
   INSERT INTO dbo.Books (Title) VALUES (N'Pride and prejudice');
   

Generación del archivo de configuración DAB

El servidor MCP hospedado en SQL se basa en data API Builder (DAB), que proporciona una API de datos segura a través de la base de datos y expone sus entidades (tablas) como herramientas de MCP. El servidor requiere un archivo de configuración DAB que defina la conexión de base de datos y las entidades que se van a exponer.

1. Genere un archivo de configuración DAB para la base de datos y habilite solo MCP:

   dab init --database-type "mssql" --host-mode "Development" --graphql.enabled false --rest.enabled false --connection-string "<your-sql-connection-string>"
   

   Como el servidor accede a la base de datos subyacente utilizando una identidad gestionada asignada por el sistema (SAMI), la cadena de conexión debería parecerse al siguiente ejemplo:

   Server=<your-sql-server>.database.windows.net;Database=<your-database>;Authentication=Active Directory Default;Encrypt=True;TrustServerCertificate=False;
   

2. Agregue la entidad Books y el permiso relacionado:

   dab add Books --source "dbo.Books" --permissions "anonymous:*"
   

   Para más información sobre cómo configurar entidades y permisos, consulte Autorización del generador de API de datos.

   Este es un archivo de configuración de ejemplo:

   {
      "$schema": "https://github.com/Azure/data-api-builder/releases/download/v1.7.93/dab.draft.schema.json",
      "data-source": {
         "database-type": "mssql",
         "connection-string": "Server=<your-sql-server>.database.windows.net;Database=<your-database>;Authentication=Active Directory Default;Encrypt=True;TrustServerCertificate=False;",
         "options": {
            "set-session-context": false
         }
      },
      "runtime": {
         "rest": {
            "enabled": false,
            "path": "/api",
            "request-body-strict": true
         },
         "graphql": {
            "enabled": false,
            "path": "/graphql",
            "allow-introspection": true
         },
         "mcp": {
            "enabled": true,
            "path": "/mcp"
         },
         "host": {
            "cors": {
               "origins": [],
               "allow-credentials": false
            },
            "authentication": {
               "provider": "AppService"
            },
            "mode": "development"
         }
      },
      "entities": {
         "Books": {
            "source": {
               "object": "dbo.Books",
               "type": "table"
            },
            "graphql": {
               "enabled": true,
               "type": {
                  "singular": "Books",
                  "plural": "Books"
               }
            },
            "rest": {
               "enabled": true
            },
            "permissions": [
               {
                  "role": "anonymous",
                  "actions": [
                     {
                     "action": "*"
                     }
                  ]
               }
            ]
         }
      }
   }
   

6. Busque Playwright y selecciónelo para crear el servidor.

6. Busca SQL MCP Server y seleccionarlo para crear el servidor.

7. En la ventana de creación, seleccione Administrar identidad para el método de autenticación saliente.

8. Cargue el archivo de configuración DAB generado anteriormente.

9. Selecciona Crear.

Conceda a la identidad del espacio de nombres acceso a su base de datos

El servidor SQL hospedado usa el SAMI del espacio de nombres para acceder a la base de datos. Puede habilitar un SAMI durante la creación del espacio de nombres.

Si no habilitó un SAMI durante la creación, debe habilitarlo accediendo a la instancia de su espacio de nombres en el portal web. En el menú de la izquierda, busque la pestaña Identidad. Active la opción Asignado por el sistema en Activado y guarde los cambios.

Vaya a la base de datos SQL en el portal de Azure, abra el Editor de consultas y ejecute el siguiente comando para conceder acceso a la identidad administrada:

CREATE USER [<your-connector-namespace-name>] FROM EXTERNAL PROVIDER;
ALTER ROLE db_datareader ADD MEMBER [<your-connector-namespace-name>];
ALTER ROLE db_datawriter ADD MEMBER [<your-connector-namespace-name>];
GRANT VIEW DEFINITION TO [<your-connector-namespace-name>];

Sustituya <your-connector-namespace-name> por el nombre de su recurso Connector Namespace.

4. Abra el modo de agente de Copilot y pregunte: "¿Cuál es la pizzería más cercana a 11 Times Square?"

4. Abra el modo agente de Copilot y pregunte "¿Qué tablas están disponibles?"

4. Llame a una herramienta específica. Por ejemplo, el siguiente comando llama a la browser_navigate herramienta:

   npx @modelcontextprotocol/inspector --cli \
   "<your-mcp-endpoint-url>" \
   --transport http \
   --method tools/call \
   --tool-name browser_navigate \
   --tool-arg url="https://www.google.com/search?q=pizza+near+11+Times+Square+New+York" \
   --header "Authorization: Bearer $MCP_TOKEN"
   

4. Llame a una herramienta específica. Por ejemplo, el siguiente comando llama a la describe_entities herramienta para enumerar las entidades disponibles:

   npx @modelcontextprotocol/inspector --cli \
   "<your-mcp-endpoint-url>" \
   --transport http \
   --method tools/call \
   --header "Authorization: Bearer $MCP_TOKEN" \
   --tool-name describe_entities \
   --tool-arg 'nameOnly=true'
   

5. Llame a la read_records herramienta para recuperar registros de una entidad (Books):

   npx @modelcontextprotocol/inspector --cli \
   "<your-mcp-endpoint-url>" \
   --transport http \
   --method tools/call \
   --header "Authorization: Bearer $MCP_TOKEN" \
   --tool-name read_records \
   --tool-arg 'entity=Books' \
   --tool-arg 'first=2'
   

Solución de problemas del servidor SQL Server

Si el servidor de SQL MCP hospedado no se conecta ni devuelve datos según lo previsto, compruebe los siguientes elementos:

• Archivo de configuración DAB. Confirme que el archivo de configuración DAB cargado es válido, usa el cadena de conexión correcto y define las entidades y permisos que espera exponer.
• Identidad administrada asignada por el sistema. Asegúrese de que un SAMI esté habilitado en el espacio de nombres. Accede a la instancia de tu espacio de nombres en el portal web, selecciona la pestaña Identidad y confirma que Asignada por el sistema está configurada en Activada.
• Acceso a la base de datos. Asegúrate de que la identidad del espacio de nombres tiene acceso a la base de datos. Consulte Conceder acceso a la identidad del espacio de nombres a su base de datos.