Power BI MCP: агент правит модель, меры DAX и связи в Power BI

microsoft/powerbi-modeling-mcp· Проверено 12.11.2026· 1,3 тыс.на GitHub

Даёт агенту семантическую модель Power BI: таблицы, столбцы, меры DAX, связи и роли RLS. Агент правит модель в Power BI Desktop, в Fabric или в файлах PBIP и проверяет запросы DAX.

2 реализации:

Локальный сервер Microsoft для правки семантической модели с транзакциями и массовыми операциями.

Как подключить

Что сделать до подключения

Node.js

Принять лицензионное соглашение: попросите агента вызвать accept_eula или добавьте флаг --accepteula

Право Write на семантическую модель

AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET

нужны только с флагом --authmode=serviceprincipal: это сервисный принципал Microsoft Entra; по умолчанию сервер просит войти в окне браузера

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio power-bi \
  -- npx -y @microsoft/powerbi-modeling-mcp@latest --start

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.power-bi]
command = "npx"
args = ["-y", "@microsoft/powerbi-modeling-mcp@latest", "--start"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "power-bi": {
      "command": "npx",
      "args": ["-y", "@microsoft/powerbi-modeling-mcp@latest", "--start"]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "power-bi": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@microsoft/powerbi-modeling-mcp@latest", "--start"]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "power-bi": {
      "command": "npx",
      "args": ["-y", "@microsoft/powerbi-modeling-mcp@latest", "--start"]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "power-bi": {
      "command": "npx",
      "args": ["-y", "@microsoft/powerbi-modeling-mcp@latest", "--start"]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "power-bi": {
        "type": "local",
        "command": ["npx", "-y", "@microsoft/powerbi-modeling-mcp@latest", "--start"]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "power-bi": {
      "command": "npx",
      "args": ["-y", "@microsoft/powerbi-modeling-mcp@latest", "--start"]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "power-bi": {
      "command": "npx",
      "args": ["-y", "@microsoft/powerbi-modeling-mcp@latest", "--start"]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

connection_operationsподключается к Desktop или Fabric

database_operationsуправляет моделями и папками TMDL

transaction_operationsоткрывает и откатывает транзакции

model_operationsобновляет и переименовывает модель

table_operationsсоздаёт и правит таблицы

column_operationsсоздаёт и правит столбцы

measure_operationsсоздаёт и переносит меры DAX

relationship_operationsнастраивает связи таблиц

dax_query_operationsвыполняет и проверяет запросы DAX

trace_operationsснимает трассировку Analysis Services

partition_operationsуправляет секциями таблиц

user_hierarchy_operationsправит иерархии

calculation_group_operationsведёт группы вычислений

security_role_operationsнастраивает роли и RLS

perspective_operationsуправляет перспективами

named_expression_operationsправит параметры Power Query

function_operationsведёт пользовательские функции DAX

culture_operationsдобавляет языки модели

object_translation_operationsпереводит названия объектов

calendar_operationsнастраивает календари

Показано 20 из 21.

94 инструмента: кроме модели собирает отчёт из JSON-спецификации, проверяет модель по 33 правилам и снимает скриншоты в Desktop.

Как подключить

Что сделать до подключения

Python 3.10 или новее

git clone https://github.com/sulaiman013/powerbi-mcp.git и pip install -r requirements.txt; на macOS и Linux — requirements-core.txt, там только офлайн-инструменты

Для живого подключения: Windows 10/11, Power BI Desktop и ADOMD.NET (ставится с SSMS или из пакетов NuGet, путь в ADOMD_DLL_PATH)

TENANT_ID, CLIENT_ID, CLIENT_SECRET

нужны только для Power BI Service: сервисный принципал Azure AD, значения впишите в файл .env

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'PYTHONPATH=<путь к powerbi-mcp>/src' --transport stdio powerbi-mcp \
  -- python '<путь к powerbi-mcp>/src/server.py'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.powerbi-mcp]
command = "python"
args = ["<путь к powerbi-mcp>/src/server.py"]

[mcp_servers.powerbi-mcp.env]
PYTHONPATH = "<путь к powerbi-mcp>/src"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "powerbi-mcp": {
      "command": "python",
      "args": ["<путь к powerbi-mcp>/src/server.py"],
      "env": {
        "PYTHONPATH": "<путь к powerbi-mcp>/src"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "powerbi-mcp": {
      "type": "stdio",
      "command": "python",
      "args": ["<путь к powerbi-mcp>/src/server.py"],
      "env": {
        "PYTHONPATH": "<путь к powerbi-mcp>/src"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "powerbi-mcp": {
      "command": "python",
      "args": ["<путь к powerbi-mcp>/src/server.py"],
      "env": {
        "PYTHONPATH": "<путь к powerbi-mcp>/src"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "powerbi-mcp": {
      "command": "python",
      "args": ["<путь к powerbi-mcp>/src/server.py"],
      "env": {
        "PYTHONPATH": "<путь к powerbi-mcp>/src"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "powerbi-mcp": {
        "type": "local",
        "command": ["python", "<путь к powerbi-mcp>/src/server.py"],
        "environment": {
          "PYTHONPATH": "<путь к powerbi-mcp>/src"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "powerbi-mcp": {
      "command": "python",
      "args": ["<путь к powerbi-mcp>/src/server.py"],
      "env": {
        "PYTHONPATH": "<путь к powerbi-mcp>/src"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "powerbi-mcp": {
      "command": "python",
      "args": ["<путь к powerbi-mcp>/src/server.py"],
      "env": {
        "PYTHONPATH": "<путь к powerbi-mcp>/src"
      }
    }
  }
}

Инструменты сервера

desktop_connectподключается к открытому Desktop

desktop_execute_daxвыполняет DAX в Desktop

desktop_get_model_infoописывает модель

list_workspacesпоказывает рабочие области

execute_daxвыполняет DAX в сервисе

validate_daxпроверяет DAX до сохранения

create_measureсоздаёт меру

tom_begin_transactionоткрывает транзакцию

create_relationshipсоздаёт связь

pbip_rename_columnsпереименовывает столбцы вместе с визуалами

pbip_create_date_tableсоздаёт таблицу дат

generate_measure_suiteгенерирует набор мер

pbir_apply_specсобирает отчёт по спецификации

run_bpaпроверяет модель по правилам

dax_lintищет ошибки в мерах

audit_star_schemaпроверяет схему звезда

build_custom_visualсобирает свой визуал

bridge_screenshotснимает скриншот страницы

refresh_doctorразбирает сбой обновления

model_diffсравнивает модель со снимком

Показано 20 из 94.

Что попросить агента

«Подключись к файлу <имя файла> в Power BI Desktop»Агент найдёт открытый Desktop и подключится через connection_operations

«Проверь, как названы объекты в модели, и предложи переименования для единообразия»Агент прочитает таблицы, столбцы и меры через table_operations, column_operations и measure_operations и переименует их в транзакции transaction_operations

«Добавь описания ко всем мерам, столбцам и таблицам и объясни логику DAX простыми словами»Агент пройдёт по объектам через measure_operations, column_operations и table_operations и запишет описания

«Сделай перевод модели на французский: таблицы, столбцы и меры»Агент добавит язык через culture_operations и заполнит переводы через object_translation_operations

«Перенеси меры <мера 1> и <мера 2> в группу вычислений и добавь варианты <варианты>»Агент создаст группу через calculation_group_operations и уберёт старые меры через measure_operations

Для каких задач

Переименовать таблицы, столбцы и меры по единому правилу во всей модели

Добавить описания ко всем мерам, столбцам и таблицам

Перевести модель на другой язык

Свернуть похожие меры в группу вычислений

Выполнить запрос DAX и сравнить его на двух версиях модели

Собрать документацию модели в Markdown со схемой связей

Ограничения

Сервер Microsoft меняет только семантическую модель: страницы отчёта и раскладку диаграммы он не трогает

Агент может внести неожиданные правки: перед работой сделайте копию модели. Метаданные и результаты запросов попадают в контекст и уходят провайдеру LLM

Отдельной настройки тенанта, которая запрещает сервер, нет: закрыть доступ можно только отключением точки XMLA, а с ней отключатся и другие инструменты

powerbi-mcp — проект одного автора на 127 звёзд; живое подключение к Desktop у него работает только на Windows, облачным инструментам нужна ёмкость Premium, PPU или Fabric

Если не работает

Агент не может вызвать ни один инструмент сервера Microsoft

Сервер блокирует вызовы, пока не принято лицензионное соглашение: разрешите агенту вызвать accept_eula или добавьте --accepteula в args.

powerbi-modeling-mcp нет в списке инструментов GitHub Copilot

Включите параметр MCP servers in Copilot в настройках Copilot на GitHub.com; в корпоративных аккаунтах его включает администратор.

Установка новой версии в VS Code зависает

Перезапустите сервер: MCP: List Servers → powerbi-modeling-mcp → Restart Server. Если не помогло, перезапустите VS Code.

Нужно войти в Fabric под другим аккаунтом, а сервер не спрашивает вход

Вход держится до конца сессии: перезапустите сервер, и при следующем подключении он попросит авторизацию заново.

На macOS arm64 сервер запускается и сразу останавливается без ошибок

Бинарник для macOS приходит без подписи, и система его закрывает. Подпишите скачанный файл командой codesign -s - <путь к бинарнику>.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Power BI Authoring MCPразработчик сервиса	Microsoft	1,3 тыс.	локально	не нужен	21	6 ноября 2026
powerbi-mcp	Sulaiman Ahmed	127	локально	не нужен	94	11 ноября 2026

Частые вопросы

Нужна ли подписка Power BI Premium?

Для модели в Power BI Desktop и файлов PBIP — нет. Модели в сервисе сервер достаёт через точку XMLA, а ей нужна ёмкость Premium, PPU или Fabric.

Как запретить агенту менять модель?

У сервера Microsoft добавьте флаг --readonly; по умолчанию он спрашивает подтверждение перед первой правкой каждой базы. У powerbi-mcp задайте POWERBI_MCP_READONLY=true.

Агент умеет делать страницы отчёта и визуалы?

Сервер Microsoft — нет, он работает только с моделью. powerbi-mcp собирает отчёт из JSON-спецификации через pbir_apply_spec и делает свои визуалы через build_custom_visual.

Есть ли у Microsoft удалённый сервер для Power BI?

Есть: для моделей в рабочей области Fabric Microsoft советует удалённый Power BI Authoring MCP, его не нужно ставить и обновлять. Локальный сервер работает с Desktop, Fabric и файлами PBIP.

Можно ли работать с Analysis Services?

Да: запустите сервер Microsoft с флагом --compatibility=Full и впишите адрес сервера в PBI_MODELING_MCP_ALLOWED_CONNECTION_HOSTS.

Где скачать Power BI MCP?

Сервер Microsoft ставится из npm командой npx -y @microsoft/powerbi-modeling-mcp@latest --start, как расширение VS Code или вручную из пакета VSIX с запуском powerbi-modeling-mcp.exe. Готовые конфиги — в блоке «Как подключить».

Что такое Power BI Modeling MCP?

Это сервер Microsoft: пакет npm и расширение VS Code называются powerbi-modeling-mcp, сам сервер — Power BI Authoring MCP Server. Он правит семантическую модель и выполняет запросы DAX.

Как подключить Power BI MCP к Claude Code?

Откройте вкладку Claude Code в блоке «Как подключить»: там команда с пакетом @microsoft/powerbi-modeling-mcp@latest и флагом --start. Затем попросите агента подключиться к файлу в Power BI Desktop.

Работает ли сервер из России?

Серверы работают на вашем компьютере; для моделей в Fabric и Power BI Service нужен рабочий вход Microsoft Entra.

Power BI MCP: агент правит модель, меры DAX и связи в Power BI

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы