✨ Power BI Modellezési MCP Szerver

A Power BI Modellezési MCP Szerver az MCP specifikációt valósítja meg, hogy zökkenőmentes kapcsolatot teremtsen az AI ügynökök és a Power BI szemantikus modellek között. Ez a projekt Nyilvános Előnézet státuszban van, és az implementáció az Általános Elérhetőség előtt jelentősen változhat.

A Power BI Modellezési MCP Szerver egy helyi MCP szerveren keresztül hozza el a Power BI szemantikus modellezési képességeket az AI ügynökeidhez. Ez lehetővé teszi a fejlesztők és az AI alkalmazások számára, hogy teljesen új módokon lépjenek kapcsolatba a Power BI modellekkel – a természetes nyelvű modellezési változtatásoktól kezdve az autonóm AI ügynökalapú fejlesztési munkafolyamatokig.

💡 Mire használható?

• 🔄 Szemantikus modellek létrehozása és módosítása természetes nyelven – Mondd el az AI asszisztensnek, mire van szükséged, és ez az MCP szerver segítségével létrehozza, frissíti és kezeli a táblákat, oszlopokat, mértékeket, kapcsolatokat és egyebeket… Power BI Desktopban és Fabric szemantikus modellekben egyaránt.
• ⚡ Tömeges műveletek nagy léptékben – Az AI alkalmazások egyszerre százas nagyságrendű objektumon végezhetnek tömeges modellezési műveleteket – tömeges átnevezés, tömeges refaktorálás, modellfordítások vagy modell biztonsági szabályok – tranzakció-támogatással és hibakezeléssel, az órákon át tartó ismétlődő munkát másodpercekre csökkentve.
• ✅ Modellezési legjobb gyakorlatok alkalmazása – Könnyedén értékeld és valósítsd meg a modellezési legjobb gyakorlatokat a modelledben.
• 🤖 Ügynökalapú fejlesztési munkafolyamatok – Támogatja a TMDL és Power BI Projektfájlok használatát, lehetővé téve az AI ügynökök számára, hogy autonóm módon tervezzék, hozzák létre és hajtsák végre az összetett modellezési feladatokat a szemantikus modell kódbázisában.
• 🔍 DAX lekérdezések futtatása és érvényesítése – Az AI asszisztensek DAX lekérdezéseket hajthatnak végre és érvényesíthetnek a modelledre vonatkozóan, segítve a mértékek tesztelését, a számítások hibaelhárítását és az adatok feltárását.

📹 Nézd meg a videót a teljes körű bemutatóért.

[!WARNING]

• Légy óvatos, amikor AI ügynököt csatlakoztatasz egy szemantikus modellhez. Az alapul szolgáló LLM váratlan vagy pontatlan eredményeket produkálhat, ami nem szándékos változásokhoz vezethet. Minden művelet elvégzése előtt mindig készíts biztonsági mentést a modelledről.
• Az LLM-ek véletlenül érzékeny információkat fedhetnek fel a szemantikus modellből, beleértve az adatokat vagy metaadatokat, naplókban vagy válaszokban. Légy óvatos a csevegési munkamenetek megosztásakor. Lásd: Adatvédelem és LLM-szolgáltatók.
• A Power BI Modellezési MCP szerver kizárólag modellezési műveleteket tud végrehajtani. Nem tudja módosítani más típusú Power BI metaadatokat, például jelentésoldalakat vagy szemantikus modell elemeket, mint például diagramelrendezések.
• A kiválasztott AI modell közvetlenül befolyásolja a kapott válaszok minőségét és relevanciáját. A legjobb eredmények érdekében válassz mély gondolkodású modellt, például GPT-5-öt vagy Claude Sonnet 4.5-öt. A rendelkezésre álló modellekről további részleteket a GitHub Copilot AI modell-összehasonlításban találsz.

📦 Telepítés

Az MCP Szerver legegyszerűbb telepítési módja a Visual Studio Code bővítmény és a GitHub Copilot együttes használata. Ugyanakkor bármely más MCP kliensbe is manuálisan telepíthető.

Visual Studio Code (Ajánlott)

1. Telepítsd a Visual Studio Code-ot.
2. Telepítsd a GitHub Copilot és a GitHub Copilot Chat bővítményeket.
3. Telepítsd a Power BI Modeling MCP Visual Studio Code bővítményt.

Ezután nyisd meg a GitHub Copilot csevegést, és ellenőrizd, hogy a powerbi-modeling-mcp elérhető és kiválasztott.

Manuális telepítés (Claude)

Ez az MCP Szerver más IDE-kbe, CLI-kbe és MCP kliensekbe is konfigurálható, pl. a Claude-ban:

1. Töltsd le a kívánt verzió VSIX csomagját az alábbi URL segítségével:
   • Sablon: https://marketplace.visualstudio.com/_apis/public/gallery/publishers/analysis-services/vsextensions/powerbi-modeling-mcp/[verzió]/vspackage?targetPlatform=[platform]
   • Példa (0.1.9 verzió, win32-x64 platform): https://marketplace.visualstudio.com/_apis/public/gallery/publishers/analysis-services/vsextensions/powerbi-modeling-mcp/0.1.9/vspackage?targetPlatform=win32-x64
2. Nevezd át a letöltött .visx fájlt .zip-re.
3. Csomagold ki a tartalmát egy tetszőleges mappába, például: C:\MCPServers\PowerBIModelingMCP
4. Futtasd a \extension\server\powerbi-modeling-mcp.exe fájlt.
5. Másold ki az MCP JSON regisztrációt a konzolból, és regisztráld a kívánt MCP kliens eszközben.

Példa konfiguráció, amely a legtöbb MCP kliensben működik. Ebből csak a fájl elérési útja kell nekünk!

{
"servers": {
		"powerbi-modeling-mcp": {
			"type": "stdio",
			"command": "C:\\MCPServers\\PowerBIModelingMCP\\extension\\server\\powerbi-modeling-mcp.exe",
			"args": [
				"--start"
			],
			"env": {}
		}
	}
}

Nagyon fontos! Ez a kódot kell bemásolni az MCP .exe fájlba, és az elérési utat kell csak cserélni benne:

{
  "mcpServers": {
    "powerbi-mcp-server": {
      "command": "[ELÉRÉSI ÚT AZ ELŐZŐ LÉPÉSBŐL, EZT CSERÉLD CSAK! AZ IDÉZŐJEL KELL!]",
      "args": ["--start"],
      "type": "stdio"
    }
  }
}

🚀 Első lépések

Először csatlakoznod kell egy Power BI szemantikus modellhez, amely lehet Power BI Desktopban, Fabric munkaterületen vagy Power BI Projektfájlokban (PBIP).

• Power BI Desktop esetén: Connect to '[Fájlnév]' in Power BI Desktop
• Fabric munkaterületen lévő szemantikus modell esetén: Connect to semantic model '[Szemantikus modell neve]' in Fabric Workspace '[Munkaterület neve]'
• Power BI Projektfájlok esetén: Open semantic model from PBIP folder '[Elérési út a definition/ TMDL mappához a PBIP-ben]'

A kapcsolat létrehozása után természetes nyelven kérheted az AI ügynököt, hogy végezzen modellezési változtatásokat. Kezdésképpen próbáld ki az alábbi példaforgatókönyvek egyikét.

Példaforgatókönyvek

[!TIP] A fenti forgatókönyvek csupán példák. Ez az MCP szerver modellezési eszközökkel látja el az ügynökeidet bármilyen típusú modellváltoztatáshoz, és a megfelelő prompttal és kontextussal szinte bármilyen modellezési feladatot automatizálhatsz.

Megerősítési promptok

Ez az MCP Szerver támogatja az Elicitation MCP protokollt, amely felhasználói jóváhagyást kér az alábbi műveletekhez:

• Egy szemantikus modellen végrehajtott első módosítás előtt.
• Egy szemantikus modellre futtatott első lekérdezés előtt.

[!TIP] Az MCP konfigurálható úgy, hogy kihagyja ezeket a megerősítéseket a --skipconfirmation opció használatával.

🛠️ Elérhető eszközök

[!NOTE]

• Ez a projekt Nyilvános Előnézet státuszban van, és az eszközök az Általános Elérhetőség előtt jelentősen változhatnak.
• Megkérheted az AI-t, hogy magyarázza el, milyen eszközök állnak rendelkezésre, és mutasson példákat azok használatára. Például: Tell me with some examples what I can do with powerbi-modeling-mcp

▶️ Elérhető promptok

Ez az MCP szerver beépített promptokat tartalmaz a könnyebb kezdéshez. A Visual Studio Codeben az elérhető MCP promptokat a / parancs begépelésével érheted el a csevegőben.

[!NOTE] Egyes promptok olyan erőforrásokat is csatolnak, amelyek fontos kontextust biztosítanak az LLM számára.

⚙️ Beállítások

Az MCP szerver több parancssori opciót és környezeti változót támogat:

Visual Studio Code esetén a parancssori opciókat és környezeti változókat a Felhasználói beállításokban adhatod meg:

Nyisd meg a Visual Studio Code felhasználói beállításait, és keress rá a @ext:Microsoft.powerbi-modeling-mcp kifejezésre.

Manuális telepítés esetén a parancssori opciókat az args tulajdonsággal, a környezeti változókat az env tulajdonsággal konfigurálhatod az MCP Szerver regisztrációs JSON-jában:

{
"servers": {
		"powerbi-modeling-mcp": {
			"command": "[MCP Szerver mappa elérési útja]\\powerbi-modeling-mcp.exe",
			"args": [
				"--start"
                , "--skipconfirmation"
			],
			"env": {
				"PBI_MODELING_MCP_ACCESS_TOKEN": "[ACCESS_TOKEN]"
			},
			"type": "stdio"
		}
	}
}

💬 Visszajelzés és támogatás

• Tekintsd meg a Hibaelhárítási útmutatót a gyakori problémák azonosításához és megoldásához.
• Ezt nyíltan fejlesztjük. A visszajelzésedet nagyra értékeljük, és segít formálni a Power BI Modellezési MCP szerver jövőjét.
  • 👉 Nyiss egy issue-t a nyilvános GitHub tárolóban – szívesen halljuk a véleményedet!

Szempontok és korlátozások

• Ez az MCP szerver ugyanazokat a szabályokat és viselkedéseket követi, mint a Külső Eszközök által végzett modellezési műveletek. A részletes információkért tekintsd meg a dokumentációt.

Adatvédelem és LLM-szolgáltatók

Az MCP szerver helyben fut, és a meglévő hitelesítő adataid és engedélyeid segítségével csatlakozik a szemantikus modellhez – nem kerüli meg a Power BI biztonsági vezérlőit. Azonban az MCP szerver által lekért adatokat (metaadatok, sémák vagy lekérdezési eredmények) elküldi az MCP kliensnek (pl. VS Code-nak), amelyek ezután a csevegési kontextus részeként továbbítódhatnak a konfigurált LLM-szolgáltatónak.

Röviden: az AI-segítség nem bővíti az adathozzáférést, de a hozzáfért adatokat továbbíthatja az LLM-szolgáltatónak. A irányítási erőfeszítéseknek a szervezet AI adatkezelési szabályzataira és az LLM-szolgáltató felhasználási feltételeire kell összpontosítaniuk, nem csupán a Power BI biztonsági vezérlőire.

Ha GitHub Copilotot használsz, tekintsd meg a GitHub Copilot modell-tárhelyek dokumentációját a külső AI-modellszolgáltatókkal való adatmegosztás részleteiért.

Biztonság

A hitelesítő adataidat minden esetben biztonságosan kezeli a hivatalos Azure Identity SDK – tokeneket soha nem tárolunk vagy kezelünk közvetlenül.

Az MCP mint jelenség nagyon újszerű és élvonalbeli technológia. Mint minden új technológiai szabványnál, érdemes biztonsági felülvizsgálatot végezni annak érdekében, hogy az MCP szerverekkel integráló rendszerek megfeleljenek az összes vonatkozó szabályozásnak és standardnak. Ez nemcsak a Power BI Modellezési MCP Szerverre vonatkozik, hanem minden általad implementált MCP kliensre/ügynökre egészen a modellszolgáltatóig.

Kövesd a Microsoft biztonsági útmutatásait az MCP szerverekre vonatkozóan, beleértve az Entra ID hitelesítés engedélyezését, a biztonságos token-kezelést és a hálózati izolálatot. Részletekért tekintsd meg a Microsoft Biztonsági Dokumentációt.

Engedélyek és kockázatok

Az MCP kliensek a felhasználó Fabric RBAC engedélyei alapján hajthatnak végre műveleteket. Az autonóm vagy helytelenül konfigurált kliensek romboló műveleteket is végezhetnek. Az üzembe helyezés előtt tekintsd át és alkalmazd a minimális jogosultság elvén alapuló RBAC szerepköröket, és vezess be biztosítékokat. Egyes biztosítékok, mint például a romboló műveletek megakadályozására szolgáló jelzők, nem szabványosítottak az MCP specifikációban, és nem biztos, hogy minden kliens támogatja azokat.

Adatgyűjtés

A szoftver információkat gyűjthet rólad és a szoftver használatáról, és elküldheti azokat a Microsoftnak. A Microsoft ezeket az információkat szolgáltatások nyújtására és termékeink és szolgáltatásaink fejlesztésére használhatja fel. A szoftverben vannak olyan funkciók is, amelyek lehetővé tehetik számodra és a Microsoft számára, hogy adatokat gyűjtsetek az alkalmazásaid felhasználóitól. Ha ezeket a funkciókat használod, meg kell felelned az alkalmazandó jogszabályoknak, beleértve a megfelelő értesítések biztosítását az alkalmazásaid felhasználói számára a Microsoft adatvédelmi nyilatkozatának másolatával együtt. Az adatgyűjtésről és -felhasználásról a súgódokumentációban és az adatvédelmi nyilatkozatunkban tájékozódhatsz. A szoftver használata az említett gyakorlatokhoz való hozzájárulásnak minősül.

Megfelelőségi felelősség

Ez az MCP szerver telepíthető, használható, és adatokat oszthat meg harmadik fél kliensekkel és szolgáltatásokkal, például olyan harmadik fél LLM-ekkel, amelyek a Microsoft megfelelőségi határain kívül működnek. Te vagy felelős azért, hogy minden integráció megfeleljen az alkalmazandó szervezeti, szabályozási és szerződéses követelményeknek.

Harmadik féltől származó összetevők

Ez az MCP szerver harmadik féltől származó összetevőket használhat vagy függhet tőlük. Te vagy felelős a harmadik féltől származó összetevők licenceinek és biztonsági helyzetének áttekintéséért és betartásáért.

Exportellenőrzés

A szoftver használatának meg kell felelnie az összes alkalmazandó exporttörvénynek és -szabályozásnak, beleértve az Egyesült Államok Export Adminisztrációs Szabályozásait és a helyi joghatósági követelményeket.

Garancia kizárása / Felelősségkorlátozás

Ez a szoftver „ahogy van” alapon, mindenféle kifejezett vagy vélelmezett garancia vagy feltétel nélkül kerül biztosításra. A Microsoft nem vállal felelősséget a szoftver használatából, visszaélésből vagy helytelen konfigurálásából eredő károkért.

Magatartási kódex

Ez a projekt elfogadta a Microsoft Nyílt Forráskódú Magatartási Kódexét. További információkért tekintsd meg a Magatartási Kódex GYIK-et, vagy lépj kapcsolatba az open@microsoft.com címen, ha további kérdéseid vagy megjegyzéseid vannak.

Forrás: https://github.com/microsoft/powerbi-modeling-mcp