Fabric Core MCP Server ツール リファレンス

Fabric Core MCP Server には、AI エージェントがMicrosoft Fabricとの対話に使用するツールが用意されています。 各ツールは、Fabric REST API 操作にマップされ、入力の検証とエラー処理が含まれます。

注

Fabric Core MCP Server は現在プレビュー段階です。 使用可能なツールとその機能は、一般公開前に変更される可能性があります。

使用可能なツール

ツール 説明
search_catalog OneLake カタログでワークスペース全体の項目を検索します。 このツールは 、カタログ検索 API を呼び出します。
list_workspaces アクセスできるすべてのワークスペースを一覧表示する
get_workspace 特定のワークスペースに関する詳細情報を取得する
create_workspace Fabric テナントに新しいワークスペースを作成する
update_workspace ワークスペースの名前または説明を更新する
delete_workspace 既存のワークスペースを削除する
add_workspace_role ワークスペースへのアクセス権をユーザーに付与する
list_workspace_roles ワークスペースのすべてのロールの割り当てを一覧表示する
get_workspace_role 特定のロールの割り当ての詳細を取得する
update_workspace_role ワークスペースでユーザーのロールを変更する
delete_workspace_role ワークスペースへのユーザーのアクセス権を削除する
list_items ワークスペース内のすべての項目を一覧表示する
get_item 特定の項目に関する詳細情報を取得する
create_item ワークスペースに新しい項目を作成する
update_item アイテムの名前または説明を更新する
delete_item ワークスペースからアイテムを削除する
get_item_definition アイテムのスキーマまたは定義を取得する
update_item_definition アイテムの定義またはスキーマを更新する
bulk_move_items 複数のアイテムを 1 つのフォルダーに移動する
create_folder ワークスペースに新しいフォルダーを作成する
list_folders ワークスペース内のすべてのフォルダーを一覧表示する
get_folder 特定のフォルダーに関する詳細を取得する
update_folder フォルダーの名前を変更する
delete_folder 空のフォルダーを削除する
move_folder フォルダーを新しい親フォルダーに移動する
list_capacities アクセスできるすべてのFabric容量を一覧表示する
get_operation_state 実行時間の長い操作の状態を確認する
get_operation_result 完了した操作の結果を取得する
get_knowledge 項目の種類のガイドラインとベスト プラクティスを取得する

ワークスペースの役割

Fabric ワークスペースでは、次の 4 つのロール レベルがサポートされます。

役割 アクセス許可
管理者 ワークスペースの設定、ロールの割り当て、削除を含むフル コントロール
メンバー アイテムを作成、編集、削除する。ワークスペースの設定またはロールを管理できない
投稿者 アイテムを作成および編集する。アイテムを削除できない
ビューアー ワークスペースとアイテムへの読み取り専用アクセス

重要な注意事項

  • Fabric テナントにワークスペースを作成するためのアクセス許可が必要です。 一部の組織では、ワークスペースの作成を特定のロールに制限しています。
  • ワークスペースを削除すると、そのワークスペース内のすべての項目が完全に削除されます。 この操作を元に戻すことはできません。
  • 削除する前に、フォルダーを空にする必要があります。 フォルダー内のすべてのアイテムを最初に移動または削除します。
  • Microsoft Graph MCP Server を追加して、電子メール アドレスを自動的に解決します。 これを使用しない場合は、ロール操作用のユーザー プリンシパル ID を指定する必要があります。

ワークフローの例

ワークフロー 1: 環境を調べる

Fabricでアクセスできるリソースを見つけられます。

プロンプト：

  1. "すべての自分のFabric ワークスペースを一覧表示する"
  2. "Sales Analytics ワークスペース内のすべてのアイテムを表示する"
  3. "Sales Analytics にはどのようなレイクハウスが存在しますか?
  4. "CustomerData lakehouse の定義を取得する"

ワークフロー 2: 開発環境を作成する

リソースとチーム アクセスを使用して、完全な開発ワークスペースを設定します。

プロンプト：

  1. "Sales Analytics Dev というワークスペースを作成する"
  2. "Sales Analytics Dev で CustomerData_Dev という名前のレイクハウスを作成する"
  3. "Sales Analytics Dev の共同作成者として john@contoso.com を追加する"
  4. " sarah@contoso.com をメンバーとして Sales Analytics Dev に追加する"

ヒント

このワークフローでは、電子メール アドレスを解決するために Microsoft Graph MCP が必要です。 Graph MCP を使用しない場合は、電子メールの代わりにユーザー プリンシパル ID を指定します。

ワークフロー 3: アクセス許可の監査と管理

ワークスペースのアクセス制御を確認して更新します。

プロンプト：

  1. "Finance ワークスペースのすべてのロールの割り当てを一覧表示する"
  2. "だれが Finance に管理者アクセス権を持っているのですか?
  3. " john@contoso.com をビューアーから財務の共同作成者に変更する"
  4. "Finance ワークスペースから contractor@contoso.com を削除する"

Troubleshooting

無効なワークスペース ID エラー

問題： ワークスペース名または ID を指定すると、エラー メッセージに "無効なワークスペース ID" と表示されます。

Solution:

  1. list_workspacesを実行して、正しいワークスペース ID を取得します。
  2. 後続の操作では、ワークスペース ID (UUID 形式) を使用します。

認証に失敗しました (401 または 403 エラー)

問題： 操作は承認エラーで失敗します。

VS Code のソリューション:

  1. Ctrl キーを押しながら Shift キーを押しながら P キーを押し、[MCP: サーバーの削除] を選択し、[ファブリック] を選択します。
  2. Ctrl キーを押しながら Shift キーを押しながら P キーを押し、[MCP: サーバーの追加>HTTP] を選択します。
  3. https://api.fabric.microsoft.com/v1/mcp/coreを入力し、ブラウザー認証を完了します。

他の MCP ホストのソリューション:

MCP ホストを再起動し、再認証します。 問題が解決しない場合は、OAuth 接続のトラブルシューティングに関するホストのドキュメントを参照してください。

実行時間の長い操作のタイムアウト

問題： 操作がタイムアウトしたか、完了していないように見えます。

ソリューション： 操作ツールを使用して非同期操作を監視します。

  1. 最初の操作から返された operation-id に注意してください。
  2. 状態の確認: "操作 {operation-id}" の状態を確認する
  3. 状態が "Succeeded" になったら、"Get the result of operation {operation-id}" という結果を取得します。

接続の詳細情報

  • エンドポイント：https://api.fabric.microsoft.com/v1/mcp/core
  • Auth: OAuth 2.0 via Microsoft Entra ID
  • スコープ:https://api.fabric.microsoft.com/.default

関連するコンテンツ

  • Last updated on