Claude的结构和电源BI工具包
自动配置MCP服务器 克劳德代码 与Microsoft Fabric和Power BI合作。
所得
- 织物芯 --138多种用于Microsoft Fabric的MCP工具（工作区、湖畔小屋、SQL、DAX、笔记本电脑、管道、OneLake、Microsoft Graph、Git、CI/CD、环境、连接、管理、Spark作业）
- powerbi建模 --Power BI Desktop中的实时语义模型编辑（度量、列、翻译、关系）
- powerbi翻译审计 --通过PASS/FAIL判定验证翻译覆盖率
- CLAUDE.md知识库 --全面的代理说明，使Claude知道如何正确使用所有工具
- 交互式设置CLI --基于终端的设置，包括菜单、微调器、进度和项目范围的安装
v3.1中的新增功能
raw_api_call工具（API覆盖率100%） --一个让克劳德打电话的逃生舱口工具 *任何* Microsoft API（结构、Power BI、图形、存储、Azure ARM），具有自动的Microsoft Entra ID令牌管理功能。- 深度代币节省 --所有138+MCP工具现在都在使用 *延迟加载*，这意味着Claude Code不会浪费约5000多个代币，持续将其保存在上下文中。它仅在需要时使用工具搜索来发现和加载模式。
- 加载缓慢的API文档 --The
raw_api_call该工具附带了一个庞大的捆绑Markdown文档库（涵盖所有Fabric/Graph/Power BI API）。它使用索引系统(INDEX.md→audience/_index.md→category.md)因此Claude只读取它需要的特定API文档。 - 交互式CLI设置 --“完整设置”打开一个交互式终端菜单，其中包含项目范围或全局安装目标。
- 公司配置同步 --拉动公司特定
CLAUDE.md来自共享GitHub仓库的代理和技能。
先决条件
| 需求 | 如何安装 |
|---|---|
| Python 3.12+ | python.org |
| 紫外线 （Python包管理器） | docs.astral.sh/uv |
| Azure命令行界面 | 安装Azure命令行界面 或 winget install -e --id Microsoft.AzureCLI |
| ODBC驱动程序18 （可选，适用于SQL） | 下载 |
| .NET 9.x+运行时 （用于Power BI建模） | dotnet.microsoft.com 或 winget install -e --id Microsoft.DotNet.Runtime.9 |
| Power BI建模MCP （可选） | 从VS代码市场安装： analysis-services.powerbi-modeling-mcp |
入门指南
1.安装必备组件
确保已安装Python 3.12+、uv和Azure CLI（见上表）。
2.登录Azure
az login这是必需的。MCP工具使用您的Azure凭据访问结构和Power BI API。否则，所有工具都会因身份验证错误而失败。
3.在VS Code中打开一个工作区
打开任何文件夹——扩展程序在检测到时会自动激活 .pbip, .Dataset，或 .SemanticModel 文件夹。
4.运行完整安装程序
打开命令选项板(Ctrl+Shift+P)并运行：
Fabric & Power BI: Full Setup这将打开一个交互式终端，您可以在其中：
- 选择MCP服务器 --选择要安装的服务器（结构核心、Power BI建模、翻译审核）
- 选择安装范围 --项目(
mcp/文件夹）或全局(~/.fabric-mcp/) - 配置公司知识库 --使用捆绑默认值或从公司GitHub仓库同步
- 检查先决条件 --验证Python、uv、Azure CLI。NET，ODBC
- 安装服务器 --带有进度微调器和实时输出
- 验证 --烟雾测试验证每个服务器是否可以启动
- 见摘要 --显示所有内容的确切安装位置
设置后，CLI将返回主菜单，您可以在其中运行单个任务。
5.重新启动克劳德代码
安装后，重新启动Claude Code以加载新的MCP服务器。你准备好了。
安装范围
项目（mcp/）
一切都安装到一个 mcp/ 工作区中的文件夹：
your-project/
└── mcp/
├── .claude/
│ ├── agents/ ← agent instruction files
│ └── skills/ ← skill documentation
├── .servers/
│ ├── fabric-core/ ← Python MCP server + venv
│ └── translation-audit/
├── .mcp.json ← config pointing to local servers
└── CLAUDE.md ← knowledge base优点：自包含、可移植，如果有东西坏了，不会影响其他项目。
全局（~/.织物mcp/）
服务器安装到 ~/.fabric-mcp/，配置转到 ~/.claude/settings.json。在所有工作区共享。
公司配置同步
团队可以在共享的GitHub仓库中维护特定于公司的CLAUDE.md、代理和技能：
github.com/org/fabric-configs/
├── companies/
│ ├── acme/
│ │ ├── CLAUDE.md
│ │ ├── agents/
│ │ └── skills/
│ └── contoso/
│ ├── CLAUDE.md
│ └── agents/从CLI主菜单中，选择“Company Config”--CLI会克隆存储库，列出所有公司，并允许您选择一个。所选公司文件将替换您的 mcp/ 文件夹。随时再次运行它以获取最新更改。
命令
| 命令 | 描述 |
|---|---|
Fabric & Power BI: Full Setup | 在终端中打开交互式设置CLI |
Fabric & Power BI: Check Prerequisites | 验证是否安装了所有必备组件 |
Fabric & Power BI: Regenerate .mcp.json | 在不重新运行完整安装程序的情况下重建MCP配置 |
使用Claude代码
一旦设置完成，Claude Code可以：
- 查询您的数据 --“按收入计算，前十大客户是什么？”
- 建造管道 --“创建一个ETL笔记本，将CSV加载到湖畔小屋”
- 管理语义模型 --“将年初至今收入指标添加到销售表中”
- 翻译报告 --“将Power BI报告翻译成瑞典语”
- 开发onelake --“湖边小屋里有什么文件？”
- 发送通知 --“将结果发布到Teams频道”
故障排除
MCP工具因身份验证错误而失败
跑 az login 然后重新运行 Fabric & Power BI: Full Setup.
工具找不到我的工作区/湖畔小屋
Claude需要在查询之前设置活动工作区和湖畔小屋。告诉它要使用哪个工作区，或者在请求中包含工作区名称。
SQL查询不返回新表的结果
新的增量表需要5-10分钟才能出现在SQL端点中。请稍候，然后重试。
安装后未检测到先决条件
VS Code在启动系统PATH时对其进行快照。如果你在VS Code已经打开的情况下安装工具（uv、az、.net等），它将看不到它们。 关闭所有VS Code窗口并重新打开 以获取新的PATH。该扩展还检查常见的安装位置作为回退，但完全重启是最可靠的修复方法。
安装CLI未打开/终端为空
CLI需要Node.js。该扩展首先尝试VS Code的内置运行时，但如果失败，请从以下位置安装Node.js 18+ .
未检测到Power BI建模MCP
从VS代码市场安装：搜索 powerbi-modeling-mcp 微软。也需要。NET 9.x+运行时环境。
公司配置同步失败
确保 git 位于您的PATH中，您可以访问公司仓库。CLI克隆如下 --depth 1 所以它很快。
许可证
麻省理工学院