クイックスタート:Connector NamespaceでホストMCPサーバーを作成する(プレビュー)

Azure Developer CLI を使用してデプロイする

SQL MCPサーバーをデプロイする最も簡単な方法は、azure-sql-mcpのサンプルにアクセスし、READMEの指示に従ってAzure DeveloperのCLIやazdを使ってデプロイすることです。 サンプルには、コネクターネームスペース、SQL MCPサーバー、SQLデータベース、その他必要なAzureリソースを1コマンドでプロビジョニングできるbicepファイルが含まれています。

SQL MCPサーバーと必要なリソースを最初から最後まで一歩進めたい場合は、以下の指示に従ってください。

• データベースを持つAzure SQL Database サーバー。 ない場合は、Azure SQL データベースを作成します。

• Data API Builder (DAB) CLI がインストールされています。

SQL データベースのシード処理

1. Azure ポータルで、(サーバーではなく) SQL データベースに移動します。

2. 左側のメニューで、[ クエリ エディター ] を選択し、データベース管理者としてサインインします。

3. [ 新しいクエリ ] を選択し、次のコマンドを実行してデータベースをシード処理します。

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

DAB 構成ファイルを生成する

SQL でホストされる MCP サーバーは 、データ API ビルダー (DAB) 上に構築されています。これは、データベースに対してセキュリティで保護されたデータ API を提供し、そのエンティティ (テーブル) を MCP ツールとして公開します。 サーバーには、データベース接続と公開するエンティティを定義する DAB 構成ファイルが必要です。

1. データベースの DAB 構成ファイルを生成し、MCP のみを有効にします。

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

   サーバーはシステム割り当て管理型アイデンティティ(SAMI)を使って基盤データベースにアクセスするため、接続文字列は以下の例のように見えるはずです。

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

2. Books エンティティと関連するアクセス許可を追加します。

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

   エンティティとアクセス許可の構成の詳細については、 データ API ビルダーの承認に関するページを参照してください。

   構成ファイルの例を次に示します。

   {
      "$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. Playwright を検索し、それを選択してサーバーを作成します。

6. SQL MCP Serverを検索して、サーバーを作成するために選択してください。

7. 作成ウィンドウで、送信認証方法として [ID の管理 ] を選択します。

8. 前に生成した DAB 構成ファイルをアップロードします。

9. を選択してを作成します。

名前空間 ID にデータベースへのアクセス権を付与する

ホストされる SQL サーバーは、名前空間の SAMI を使用してデータベースにアクセスします。 名前空間の作成時に SAMI を有効にすることができます。

作成時に SAMI を有効にしなかった場合は、Web ポータルで名前空間インスタンスに移動して有効にする 必要があります 。 左側のメニューで、[ID] タブ を 見つけます。 [システム割り当て済み] トグルを [オン] に切り替えて、更新プログラムを保存します。

Azure ポータルで SQL データベースに移動し、クエリ エディターを開き、次のコマンドを実行してマネージド ID へのアクセスを許可します。

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

<your-connector-namespace-name>をコネクタ名前空間リソースの名前に置き換えます。

4. Copilot のエージェント モードを開き、「11 Times Square に最も近いピッツェリアはどこですか?」と尋ねます。

4. Copilot のエージェント モードを開き、「利用可能なテーブルは何ですか?」と質問します。

4. 特定のツールを呼び出します。 たとえば、次のコマンドは 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. 特定のツールを呼び出します。 たとえば、次のコマンドは describe_entities ツールを呼び出して、使用可能なエンティティを一覧表示します。

   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. read_records ツールを呼び出して、エンティティ (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'
   

SQL Server のトラブルシューティング

ホストされている SQL MCP サーバーが期待どおりに接続またはデータを返さない場合は、次の項目を確認します。

• DAB 構成ファイル。 アップロードされた DAB 構成ファイルが有効であることを確認し、正しい接続文字列を使用し、公開する予定のエンティティとアクセス許可を定義します。
• システム割り当てマネージド ID。 名前空間で SAMI が有効になっていることを確認します。 Web ポータルで名前空間インスタンスに移動し、[ ID ] タブを選択し、[ システム割り当て済み ] が [オン] に設定されていることを確認します。
• データベース アクセス。 名前空間 ID にデータベースへのアクセス権が付与されていることを確認します。 データベースへの名前空間 ID アクセスの許可を参照してください。