ローカル Fabric MCP Server をインストールし、AI エージェントを使用して、開発用コンピューターからFabric API、OneLake データ、および項目定義を操作します。
注
Fabric MCP Server は、GitHub上のオープンソース プロジェクトです。 このクイックスタートでは、GitHub リポジトリに関する詳細なセットアップ手順とトラブルシューティングについて説明します。
前提条件
MCP サーバー Fabricインストールする前に、次の内容を確認してください。
- MCP 互換 AI エージェント — GitHub Copilot (推奨) または stdio トランスポートをサポートする任意の MCP ホストを含む VS Code
追加の前提条件は、インストール方法によって異なります。
| Method | 前提条件 |
|---|---|
| VS Code 拡張機能 | None |
| npm/npx | Node.js 20 LTS 以降 (ダウンロード) |
| ソース ビルド | .NET 9 SDK 以降 (ダウンロード) |
インストール
オプション 1: VS Code 拡張機能 (推奨)
VS Code の 安定ビルド と Insider ビルドの両方で動作します。
- GitHub Copilot Chat 拡張機能をインストールします。
- Fabric MCP Server 拡張機能をインストールします。
それ以上の構成は必要ありません。 拡張機能によって MCP サーバーが自動的に登録されます。
オプション 2: npm/npx (任意の MCP クライアント)
20 LTS 以降 Node.js 必要です。
node --version で確認します。
クライアントの mcp.json ファイルに次のコードを追加します。
{
"mcpServers": {
"fabric-mcp-server": {
"command": "npx",
"args": [
"-y",
"@microsoft/fabric-mcp@latest",
"server",
"start",
"--mode",
"all"
]
}
}
}
オプション 3: ソースからビルドする (.NET)
.NET 9 SDK 以降が必要です。
dotnet --version で確認します。
git clone https://github.com/microsoft/mcp.git
cd mcp
dotnet build servers/Fabric.Mcp.Server/src/Fabric.Mcp.Server.csproj --configuration Release
次に、クライアントの mcp.json ファイルに次のコードを追加します。
{
"mcpServers": {
"Fabric MCP Server": {
"command": "/path/to/repo/servers/Fabric.Mcp.Server/src/bin/Release/fabmcp",
"args": [
"server",
"start"
],
"type": "stdio"
}
}
}
注
Windowsで円記号を使用し、.exe 拡張子を追加します: C:\path\to\repo\servers\Fabric.Mcp.Server\src\bin\Release\fabmcp.exe
注
Visual StudioまたはVisual Studio Codeを手動で構成する場合は、ルート JSON キーとして servers ではなく、mcpServers を使用します。
クライアント固有の構成
VS Code 拡張機能を使用していない場合は、MCP ホストに必要な場所に mcp.json 構成を配置します。
| Client | ファイルの場所 | ドキュメント |
|---|---|---|
| VS Code |
.vscode/mcp.json (ワークスペース) または settings.json (ユーザー) |
VS Code MCP のドキュメント |
| その他のホスト | MCP サーバー構成ファイルの場所については、ホストのドキュメントを参照してください | — |
インストールの検証
VS Code Agent モード に切り替えます。ツールの一覧で [更新 ] を選択します。 Fabric MCP サーバー ツールが一覧表示されます。
Fabricコンテキストを使用するプロンプトを試してください。
What Fabric workload types are available?
エージェントからワークロードの種類の一覧Fabric返された場合、サーバーは正常に動作しています。
プロンプトの例
インストール後、次のプロンプトを試して、サーバーで実行できる操作を調べてみてください。
| Scenario | プロンプトの例 |
|---|---|
| API 仕様を参照する | "'notebook' の OpenAPI 操作を表示し、サンプル作成本文を指定する" |
| 項目スキーマを調べる | "データ パイプライン項目定義の JSON スキーマを表示する" |
| ベスト プラクティスを取得する | Fabric での API スロットリングを処理するためのベストプラクティスを紹介する |
| ワークスペースを一覧表示する | "Fabric ワークスペースを一覧表示する" |
| ファイルの操作 | "sales lakehouse から config.json ファイルをダウンロードする" |
| アイテムの作成 | "開発ワークスペースに CustomerData という名前の新しい Lakehouse を作成する" |
ツールとマルチステップ ワークフローの例の完全な一覧については、ツール リファレンスを 参照してください。
次のステップ
- ツール リファレンス - 使用可能なツールとサンプル ワークフローの完全な一覧
- Fabric MCP サーバーの概要 — アーキテクチャと機能
- トラブルシューティング ガイド — 一般的な問題と解決策
- 投稿ガイド - オープンソース プロジェクトに貢献する