Power BI Authoring MCP Server
Локальный MCP-сервер Microsoft для семантических моделей Power BI: агент создает таблицы, меры DAX и связи в Power BI Desktop, Fabric и файлах PBIP
- 1 240 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент создает, меняет и удаляет объекты семантической модели с вашими правами, в том числе в рабочей области Fabric
- Данные и метаданные модели попадают в клиент и могут уйти провайдеру LLM, а токены доступа отправляются на разрешенные хосты
Установка
- Работает в
Ручная установка
{"powerbi-authoring-local": {"type": "stdio", "command": "npx", "args": ["-y", "@microsoft/powerbi-modeling-mcp@latest", "--start"]}}Для остальных клиентов MCP. Нужен Node.js. Прочитайте EULA и примите его до вызова остальных инструментов.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент создает, меняет и удаляет объекты семантической модели с вашими правами, в том числе в рабочей области Fabric
- Данные и метаданные модели попадают в клиент и могут уйти провайдеру LLM, а токены доступа отправляются на разрешенные хосты
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает ИИ-агенту 21 инструмент для редактирования семантической модели Power BI. Модель может лежать в Power BI Desktop, в рабочей области Fabric или в проектных файлах PBIP с определением в формате TMDL. Агент создает и меняет таблицы, столбцы, меры DAX, связи, иерархии, группы вычислений, роли безопасности на уровне строк, перспективы и переводы. Отдельные инструменты управляют транзакциями, секциями и параметрами Power Query. Также сервер выполняет и проверяет запросы DAX. Для этого есть встроенные промпты CreateDAXQuery, RunDAXQueryWithMetrics и AnalyzeDAXQuery, а подключение к модели делают промпты ConnectToPowerBIDesktop, ConnectToFabric и ConnectToPBIP. Массовые операции вроде переименования сотен объектов идут пакетами с транзакциями. Сервер запускается локально и подключается к модели через XMLA с вашими правами. По умолчанию он работает в режиме записи и просит подтверждение перед первой правкой в каждой базе. Флаг --readonly запрещает любые изменения. Сервер меняет только модель и не трогает страницы отчетов.
Для кого. Для BI-разработчиков и аналитиков, которые строят семантические модели в Power BI и хотят поручить Copilot или другому агенту переименование, документирование и рефакторинг мер DAX.
Подходит, если
- В модели десятки таблиц с разным стилем имен, и агент должен проанализировать соглашения и массово переименовать объекты
- Нужно сгенерировать описания всех мер, столбцов и таблиц и объяснить логику DAX простым языком
- Требуется перевести модель на французский или другой язык: инструменты культур и переводов объектов делают это за один проход
- Несколько близких мер вроде скользящих средних за 6 и 12 месяцев хочется свернуть в группу вычислений и добавить варианты 24M и 3M
- Нужно сравнить время выполнения одного запроса DAX на двух версиях модели и разобрать метрики
Не подходит, если
- Модель находится в рабочей области Fabric: сам Microsoft рекомендует для нее удаленный размещенный сервер Power BI Authoring MCP без локальной установки
- Нужно менять страницы отчетов или раскладку диаграммы модели: сервер выполняет только операции моделирования
- У вас нет права записи в семантическую модель: без него правки не пройдут
- Резервной копии модели нет, а доверять агенту правки вслепую нельзя: автор советует сначала сделать копию
Пример запроса к агенту
Подключись к «Продажи.pbix» в Power BI Desktop, проверь соглашения об именах и предложи переименования для таблицы Sales.MCP
- Транспорт
- stdio
- Авторизация
- OAuth
Переменные окружения
AZURE_CLIENT_ID- Идентификатор приложения Microsoft Entra, нужен при --authmode=serviceprincipal.
AZURE_TENANT_ID- Идентификатор тенанта Microsoft Entra.
AZURE_CLIENT_SECRETсекрет- Секрет сервисного принципала, если вход идет по секрету.
PBI_MODELING_MCP_ACCEPT_EULA- Значение true принимает EULA для запуска без участия человека.
PBI_MODELING_MCP_ALLOWED_CONNECTION_HOSTS- Список доверенных хостов Analysis Services или XMLA, куда сервер может отправлять токены доступа.
Ограничения
- Нужно право Write на семантическую модель. Сервер подключается через конечную точку XMLA.
- Перед использованием пакета npm нужно принять лицензионное соглашение EULA: пока вы этого не сделали, сервер блокирует остальные инструменты. Для запуска без участия человека есть флаг --accepteula и переменная PBI_MODELING_MCP_ACCEPT_EULA.
- Данные и метаданные модели уходят клиенту и могут попасть к провайдеру LLM.
- ПО может собирать данные об использовании и отправлять их в Microsoft.
- Блокировать сервер настройкой тенанта нельзя: остановить доступ можно только отключением конечной точки XMLA.
Как отключить. В VS Code отключите или удалите расширение Power BI Authoring MCP. При ручной установке уберите запись powerbi-authoring-local из конфигурации MCP клиента. Если сервер нужен только для чтения, добавьте аргумент --readonly.
Частые вопросы
Как подключить Power BI MCP к VS Code и GitHub Copilot?
Установите Visual Studio Code, расширение GitHub Copilot Chat и расширение Power BI Authoring MCP. Затем в чате Copilot проверьте, что powerbi-modeling-mcp есть в списке инструментов. Если его нет, проверьте, включен ли параметр MCP servers in Copilot: для корпоративных аккаунтов его включает администратор.
Как запустить Power BI Authoring MCP через npx?
Добавьте в конфигурацию клиента stdio-сервер с командой npx и аргументами -y, @microsoft/powerbi-modeling-mcp@latest, --start. До принятия EULA все остальные инструменты заблокированы: агент может вызвать accept_eula только после вашего явного разрешения.
Может ли агент испортить модель Power BI?
Может, если у вас есть право записи. По умолчанию сервер просит подтверждение перед первой правкой в каждой базе, а флаг --readonly запрещает любые изменения. Автор советует сделать резервную копию модели перед работой.
Работает ли сервер с моделями в Fabric и с файлами PBIP?
Да. Подключиться можно к файлу в Power BI Desktop, к семантической модели в рабочей области Fabric и к папке definition в проекте PBIP. Для моделей в Fabric Microsoft рекомендует удаленный сервер, который не требует установки.
Какие инструменты есть в Power BI Authoring MCP Server?
Двадцать один инструмент: от `connection_operations` и `database_operations` до `measure_operations`, `relationship_operations`, `dax_query_operations`, `security_role_operations` и `object_translation_operations`. Агент может объяснить их сам по запросу «Tell me with some examples what I can do with the Power BI Authoring MCP server».
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер и CLI для управления настоящим Microsoft Excel: Power Query, DAX, VBA, сводные таблицы, диаграммы
CLI и 13 скиллов для Claude Code: модель данных Power BI, меры DAX, безопасность на уровне строк и страницы отчета PBIR прямо из чата
Marketplace плагинов для Claude Code и GitHub Copilot по Power BI и Microsoft Fabric: семантические модели, DAX, TMDL, отчеты
dbt MCP
dbt-mcp
Официальный сервер MCP от dbt Labs: Semantic Layer, метаданные проекта, запуск команд dbt и SQL к хранилищу из агента
Официальный MCP-сервер MathWorks: агент запускает и завершает MATLAB, пишет и выполняет код, проверяет его на ошибки и стиль
Официальный MCP-сервер YDB
YDB MCP
Официальный MCP-сервер YDB от разработчиков базы: SQL-запросы с параметрами, план выполнения, обзор директорий и основа для своих серверов
Коротко о README
README начинается с замечания, что для моделей в Fabric нужно брать удаленный сервер Microsoft. Затем идут возможности: правки на естественном языке, массовые операции, проверка лучших практик, работа с TMDL и запросы DAX. Раздел об установке описывает расширение для VS Code, запуск через npx и ручную распаковку пакета VSIX. После него перечислены инструменты, промпты, параметры командной строки и переменные окружения. В конце собраны предупреждения о резервных копиях, приватности данных, правах доступа и сборе телеметрии.