ローカルのFabric MCPサーバーを使用することで、AIエージェントは自然言語の会話を通じてOneLake内でワークスペースの閲覧、ファイルの読み取り、テーブルスキーマの検査、ディレクトリ管理が可能です。 サーバーはあなたのマシン上で動作し、モデルコンテキストプロトコル (MCP)を通じてあなたのエージェントをOneLakeに接続します。
Tip
セットアップを簡単にするには、そのアイテムで利用可能で、必要なツールをサポートしている場合は、ホスト型の OneLake MCP サーバー から始めましょう。 ローカルMCPサーバーを設置せずにHTTPS経由で接続します。 ホストサーバーとローカルサーバーは異なるツールを公開しています。この記事ではローカルサーバーについて説明します。
Fabricのアイテムは、OneLakeにデータを保存するためにオープンフォーマットを使用しています。 これらの項目には、レイクハウス、ミラーリングされたデータベース、OneLake の可用性が有効な KQL データベースおよびセマンティック モデルが含まれます。 ローカルサーバーのOneLakeツールは、AIエージェントが単一のコマンドセットでこれらのアイテムを探索できるようにします。
前提条件
- OneLake にデータを格納するアイテムが少なくとも 1 つ含まれるFabric ワークスペース。
-
Azure CLIインストールおよびサインイン (
az login)。 - Visual Studio Code と MCP 互換の AI 拡張機能 (GitHub Copilot など)。
ローカルのFabric MCPサーバーをインストールする
Visual Studio Codeにローカルサーバーをインストールするには、Fabric MCPサーバーVS Code拡張機能を使用します。 拡張機能をインストールすると、OneLake ツールが自動的に使用できるようになります。
手動構成または VS Code の外部での使用については、Fabric MCP Server README のセットアップ手順を参照してください。
認証とアクセス許可
ローカルサーバーのOneLakeツールは、既存のAzure IDとFabric権限を利用します。 AI エージェントは、既に表示するアクセス許可を持っているワークスペースとアイテムにのみアクセスできます。 通常のワークスペース アクセスを超える追加のロールやアクセス許可は必要ありません。
ツールを使用する前に、Azure CLIでサインインします。
az login
ローカルOneLake MCPツールの機能
このツールは、OneLake の 3 つの領域をカバーします。
| カテゴリ | 実行可能事項 | 使用される OneLake API |
|---|---|---|
| ワークスペースと項目の検出 | ワークスペースの一覧表示、ワークスペース内のアイテムの一覧表示、新しい項目の作成 (lakehouses、ノートブック、SQL データベースなど)。 | OneLake データ プレーン API および Fabric REST API |
| ファイルとディレクトリの操作 | ファイルとディレクトリの参照、読み取り、書き込み、アップロード、ダウンロード、削除を行います。 DFS エンドポイントとBlob Storage エンドポイントの両方を使用できます。 | OneLake ファイル システム API |
| テーブル操作 | テーブル API の構成、名前空間 (スキーマ)、テーブルの一覧表示、列名、型、メタデータを含む完全なテーブル定義の取得を行います。 | OneLake テーブル API |
ツールには 19 個のコマンドが含まれています。 ほとんどのコマンドは、フレンドリ名と GUID を受け入れます。たとえば、GUID ではなく SalesLakehouse.lakehouse として項目を参照できます。
パラメーターと出力例の完全なコマンド リファレンスについては、GitHubの OneLake ツール README を参照してください。
例: レイクハウスを探索する
ローカルのFabric MCPサーバーをインストールした後、AIエージェントにデータの探索を依頼してください。 例えば次が挙げられます。
"Sales lakehouse のテーブルを一覧表示し、それぞれのスキーマについて教えてください。"
エージェントは、OneLake MCP ツールを使用して、コードを記述したり、Fabric ポータルを開いたりすることなく、ワークスペースの検索、レイクハウスの検索、テーブルの名前空間の検出、テーブルの完全な定義の取得を行います。
AI エージェントに完了を依頼できるその他のタスク:
- ワークスペースのインベントリ - "自分のワークスペースをスキャンし、そこにある項目、その大きさ、および含まれるテーブルを教えてください"。
- ファイルの読み取りと書き込み — "この CSV を自分の lakehouse のファイル フォルダーにアップロードする" または "監視フォルダー内の構成ファイルを読み取る" です。
- ミラー化されたデータベースを文書化 する - "ミラー化されたデータベースのテーブルとストレージ構造について説明する"。
- アイテムを作成 する - "Analytics ワークスペースで StagingData という名前の新しいレイクハウスを作成します。"
制限事項
- 現在、
item createコマンドには GUID ベースのワークスペース ID が必要です。 AI エージェントは、onelake workspace listを呼び出してワークスペース名を ID に解決することで、これを自動的に処理します。 - OneLake MCP ツールには、ショートカット管理コマンドは含まれません。 ショートカットを一覧表示または作成するには、 OneLake ショートカット REST API を使用します。
関連するコンテンツ
- AIエージェントをホストされたOneLake MCPサーバーに接続します
Fabric MCP Server — GitHub README - OneLake ツール - 完全なコマンド リファレンス
- OneLake に接続する
- OneLake テーブル API の概要
- PowerShell を使用して OneLake を管理する