Démarrage rapide : Créer un serveur MCP hébergé dans Connector Namespace (aperçu)

Déployer à l’aide d’Azure Developer CLI

La façon la plus simple de déployer un serveur SQL MCP est d’aller dans l’exemple azure-sql-mcp et de suivre les instructions README pour déployer en utilisant la CLI Azure Developer ou azd. L’exemple contient des fichiers biceps qui vous permettent de provisionner un espace de noms Connector, un serveur SQL MCP, une base de données SQL et d’autres ressources Azure nécessaires avec une seule commande.

Si vous préférez déploier progressivement un serveur SQL MCP et les ressources nécessaires du début à la fin, suivez les instructions ci-dessous.

• Un serveur Azure SQL Database avec une base de données. Si vous n'en avez pas, créez une base de données Azure SQL.

• L’interface CLI du Générateur d’API de données (DAB) est installée.

Amorçage de la base de données SQL

1. Dans le portail Azure, accédez à votre base de données SQL (et non au serveur).

2. Dans le menu de gauche, sélectionnez l’éditeur de requête et connectez-vous en tant qu’administrateur de base de données.

3. Sélectionnez Nouvelle requête et exécutez la commande suivante pour amorçage de la base de données :

   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');
   

Générer le fichier de configuration DAB

Le serveur MCP hébergé par SQL repose sur le générateur d’API de données (DAB), qui fournit une API de données sécurisée sur votre base de données et expose ses entités (tables) en tant qu’outils MCP. Le serveur nécessite un fichier de configuration DAB qui définit la connexion de base de données et les entités à exposer.

1. Générez un fichier de configuration DAB pour votre base de données et activez uniquement MCP :

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

   Parce que le serveur accède à la base de données sous-jacente en utilisant une identité managée (SAMI) attribuée par le système, la chaîne de connexion doit ressembler à l’exemple suivant :

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

2. Ajoutez l’entité Books et l’autorisation associée :

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

   Pour plus d’informations sur la configuration des entités et des autorisations, consultez l’autorisation du générateur d’API de données.

   Voici un exemple de fichier de configuration :

   {
      "$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. Recherchez Playwright et sélectionnez-le pour créer le serveur.

6. Cherchez SQL MCP Server et sélectionnez-le pour créer le serveur.

7. Dans la fenêtre de création, sélectionnez Gérer l’identité pour la méthode d’authentification sortante.

8. Chargez le fichier de configuration DAB généré précédemment.

9. Cliquez sur Créer.

Accorder à l’identité de l’espace de noms l’accès à votre base de données

Le serveur SQL hébergé utilise le SAMI de l’espace de noms pour accéder à votre base de données. Vous pouvez activer un SAMI lors de la création de l’espace de noms.

Si vous n’avez pas activé un SAMI lors de la création, vous devez l’activer en accédant à votre instance d’espace de noms dans le portail web. Dans le menu de gauche, recherchez l’onglet Identité. Définissez le bouton bascule Affecté par le système sur Activé, puis enregistrez les modifications.

Accédez à votre base de données SQL dans le portail Azure, ouvrez l’éditeur de requête et exécutez la commande suivante pour accorder l’accès à l’identité managée :

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>];

Remplacez <your-connector-namespace-name> par le nom de votre ressource d’espace de noms de connecteur.

4. Ouvrez assistant Copilot mode et demandez « Quelle est la pizza la plus proche de 11 Times Square ? »

4. Ouvrez assistant Copilot mode et demandez « Quelles tables sont disponibles ? »

4. Appelez un outil spécifique. Par exemple, la commande suivante appelle l’outil browser_navigate :

   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. Appelez un outil spécifique. Par exemple, la commande suivante appelle l’outil describe_entities pour répertorier les entités 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. Appelez l’outil read_records pour récupérer des enregistrements à partir d’une entité (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'
   

Résoudre les problèmes liés au serveur SQL

Si votre serveur SQL MCP hébergé ne se connecte pas ou ne retourne pas de données comme prévu, vérifiez les éléments suivants :

• Fichier de configuration DAB. Vérifiez que le fichier de configuration DAB chargé est valide, utilise la chaîne de connexion correcte et définit les entités et autorisations que vous prévoyez d’exposer.
• Identité managée affectée par le système. Vérifiez qu’un SAMI est activé sur l’espace de noms. Accédez à votre instance d’espace de noms dans le portail web, sélectionnez l’onglet Identité et vérifiez que l’affectation du système est activée.
• Accès à la base de données. Vérifiez que l’identité de l’espace de noms est autorisée à accéder à la base de données. Voir Accorder à l’identité de l’espace de noms l’accès à votre base de données.