Power BI Desktop Bridge és Authoring MCP: az ágenshurok működése

„A Power BI bridge MCP”: ez a kifejezés újra meg újra előkerül, amikor ágens által épített riportokról van szó, pedig olyasmit nevez meg, ami nem létezik. Van Power BI Authoring MCP-szerver, és van Power BI Desktop Bridge. Ez két külön eszköz, más protokollt beszélnek, a riport más-más rétegéhez nyúlnak, és az adminisztrátor is máshol kapcsolja ki őket.

A különbség a 2026. szeptemberi Power BI-kiadással lett gyakorlati kérdés: a Microsoft ekkor tette általánosan elérhetővé az ágensalapú fejlesztési élményt, és ekkor jelent meg az MCP-szerver hosztolt változata. Ha a csapatod arra készül, hogy ágenst enged egy szemantikus modell közelébe, érdemes tudni, melyik darab mit csinál.

Három eszköz, három réteg

Az MCP-szerver az ágens keze a modellen. A skill utasítások és fájlszerkesztések együttese a riportréteghez. A Bridge a szeme: ezzel tölti újra, amit megváltoztatott, és ezzel nézi meg a kirajzolt oldalt. A Microsoft dokumentációja ugyanígy osztja fel a dolgot, és hozzátesz egy mondatot, amelyet érdemes elismételni mindenkinek, aki egy szerver telepítésétől csodát vár: az eszközök adják a „mit”, a skillek a „hogyant”.

Az Authoring MCP-szerver: lokálisan vagy hosztolva

Az Authoring MCP-szerver eszközöket ad az ágensnek a szemantikus modell objektumainak létrehozásához és módosításához: táblák, oszlopok, measure-ök, kapcsolatok, hierarchiák, calculation groupok, perspektívák, partíciók és biztonsági szerepkörök. DAX-lekérdezést is tud futtatni, hogy tesztelje, amit írt. Kizárólag modellezési műveleteket végez, a riportoldalakhoz tehát szándékosan nem fér hozzá.

Egy szerver, kétféle telepítés. A lokális változat 2025 novembere óta általánosan elérhető, és stdio-n keresztül fut a gépeden. A hosztolt változat a szeptemberi kiadással érkezett previewként, a Microsoft végpontján, telepítés nélkül.

A regisztráció néhány sor az MCP-kliens konfigurációjában, a dokumentáció mintáját követve:

{
  "servers": {
    "powerbi-authoring-local": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@microsoft/powerbi-modeling-mcp@latest", "--start"]
    }
  }
}

A hosztolt változatnál ennek a helyére egy HTTP-bejegyzés kerül, amely a https://api.fabric.microsoft.com/v1/mcp/powerbi/authoring címre mutat. A Microsoft a hosztolt szervert ajánlja, ha kizárólag Fabric workspace-ben lévő modelleken dolgozol, a lokálisat pedig akkor, ha Power BI Desktop vagy projektfájlok is érintettek. Arra is figyelmeztet, hogy ne regisztráld egyszerre mindkettőt, mert az ágens ilyenkor két, egymást átfedő eszközkészletet lát, bizonytalanul választ közöttük, és minden kérésnél fölösleges tokent éget.

A Bridge egy cső a saját gépeden

A Desktop Bridge egy kis szerver, amely a Power BI Desktop folyamatán belül fut, és egy pbi-desktop-bridge-{processId} nevű named pipe-on figyel. JSON-RPC 2.0-t beszél, távoli elérést nem támogat, és minden megnyitott Desktop-ablak saját pipe-ot kap. Több kliens is csatlakozhat, de egyszerre csak egy művelet futhat.

A felülete szándékosan parányi. Négy dokumentált metódusa van: az egyik az elérhető metódusok jegyzékét adja vissza, a másik megmondja, melyik fájl van nyitva és van-e benne mentetlen változás, a harmadik PNG-képernyőképet készít egy riportoldalról, a negyedik pedig újratölti a megnyitott projektet a lemezről (a modelldefiníció újraalkalmazásával vagy anélkül). A listában semmi nincs, ami adatot olvasna, measure-t módosítana vagy publikálna.

A legtöbben a CLI-n keresztül találkoznak majd a Bridge-dzsel, amely ezeket a metódusokat az ágens által hívható parancsokba csomagolja:

# Mely Desktop-példányok futnak, mi van megnyitva, van-e mentetlen változás?
powerbi-desktop status

# Az ágens PBIR-fájlokat szerkesztett a lemezen; töltsük be őket a futó Desktopba.
powerbi-desktop reload

# Egy oldal mentése PNG-be, hogy az ágens lássa, mi rajzolódott ki valójában.
powerbi-desktop screenshot <page-id>

Létezik még open, manifest és screenshot-all parancs is. Ennyi a teljes eszközkészlet, és éppen a szűkössége miatt könnyű átlátni.

Egy hurok, öt lépés

Összerakva a dokumentált folyamat így fut. Az ágens az MCP-szerverrel gondoskodik róla, hogy a modellben meglegyenek a riporthoz szükséges táblák és measure-ök. PBIR-fájlokat szerkeszt az oldalakhoz és a vizuálokhoz. Validációs lépést futtat, amely kiszűri a szerkezeti hibákat. A Bridge-en keresztül újratölti a Desktopot, és képernyőképeket készít. Végül átnézi az eredményt, és addig ismétel, amíg a validáció és a vizuális ellenőrzés is rendben nincs.

A negyedik lépés változtatta meg az ágens által épített riportok minőségét, mert előtte az ágens vakon írta a JSON-t. Egy nem létező mezőre kötött vizuál érvényes JSON és hibás riport egyszerre. Ha a hurokban ott a képernyőkép, az ágens meglátja a hibaikont, és kijavítja a kötést. A távoli riportszerkesztéshez a szeptemberi kiadás böngészőalapú validációt is hozott headless böngészővel, ami megszünteti a Desktop-függőséget, és Mac-felhasználók előtt is megnyitja a hurkot.

Egy korábbi megfigyelés ugyanakkor most is érvényes. A képernyőkép azt bizonyítja, hogy az oldal kirajzolódott. Azt nem bizonyítja, hogy a kártyán helyes szám áll, márpedig egy pénzügyi riportot a szám alapján ítélnek meg.

Mit tud kikapcsolni egy adminisztrátor

Minden darabnak saját kapcsolója van, és nem ott, ahol elsőre keresnéd.

• Hosztolt MCP-szerver. Egy Fabric tenant-beállítást („Users can use the Power BI Model Context Protocol server endpoint”) kell engedélyezni, mielőtt bárki be tudna jelentkezni.
• Lokális MCP-szerver. Ezt semmilyen tenant-beállítás nem tiltja. Az XMLA endpointon keresztül csatlakozik, így csak az XMLA letiltásával állítható meg, az pedig minden más, erre épülő eszközt is megállít. A gyakorlatban a jogosultsági modell a kontroll: Build joggal az ágens csak lekérdezni tud, a módosításhoz Write kell.
• Desktop Bridge. A Power BI Desktop beállításaiban, az Options, Security alatt található, és alapból be van kapcsolva. Menedzselt gépekre registry policy is van: a HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Power BI Desktop kulcs alatti DesktopNamedPipeBridge érték, amely 0-val tilt, 1-gyel engedélyez.
• AI-hozzáférés egy adott modellhez. Egy új, modellenkénti beállítással a szerkesztők elzárhatják a szemantikus modellt a csak olvasási joggal rendelkező felhasználók elől a Copiloton és a Microsoft távoli MCP-eszközein keresztül. Bekapcsolt állapotban érkezik, vagyis megőrzi a jelenlegi működést.

A második pontnál érdemes megállni. Az a fejlesztő, akinek Write joga van egy éles modellen és fut nála a lokális MCP-szerver, már ma is rábízhatja egy ágensre a modell módosítását, és ezt semmilyen tenant-kapcsoló nem akadályozza meg. A védőkorlát az, hogy kinél van Write jog, ahogy eddig is ez volt; a különbség az a sebesség, amellyel most több száz objektumon lehet egyszerre hibázni.

Amiben el lehet botlani

Néhány dokumentált viselkedést jó ismerni az első munkamenet előtt. Az általános elérhetőség az ágensalapú élmény egészére vonatkozik, a Report Authoring skill saját dokumentációs oldala viszont még previewként jelöli, ezért minden darabnál külön nézd meg az állapotát. A PBIR-fájlok jelentik az igazság forrását, ezért ha mentetlen változásaid vannak a Desktopban, és megkéred az ágenst, hogy iteráljon, ő a lemezen lévő fájlokból dolgozik, a mentetlen szerkesztéseid pedig kimaradnak. A status parancs éppen ezért jelzi a mentetlen változásokat. A szerveren keresztül futtatott DAX-lekérdezések 100 000 sornál megállnak. A hosztolt szerver munkamenetben tartja a modellkapcsolatot, és az a kliens, amely nem küldi vissza a munkamenet-fejlécet, minden művelet előtt újracsatlakozik. Egyes MCP-kliensek dinamikus OAuth-kliensregisztrációra építenek, amelyet az Entra ID nem támogat, így kézzel regisztrált alkalmazás nélkül nem tudják használni a hosztolt szervert.

Van még egy pont, amely adatvédelmi beszélgetésbe való, nem technikaiba: a modell metaadatai és a lekérdezések eredményei bekerülnek a beszélgetésbe, vagyis eljutnak ahhoz az LLM-szolgáltatóhoz, amelyet az MCP-kliens használ.

Bevezetés, amely tiszteletben tartja a modellt

A Microsoft saját biztonsági tanácsa rövid: készíts mentést a modellről, dolgozz Git alatt tartott PBIP-fájlokban, és figyelj arra, mi jut el az LLM-szolgáltatóhoz. A Power BI Projects ugyanebben a kiadásban lett általánosan elérhető, a PBIR pedig mostantól az alapértelmezett riportformátum, így kevés ok maradt arra, hogy mindezt bináris PBIX-en futtasd.

A mostani munkám nagy része Fabricen zajlik, BI-eszközökre épített CI/CD-vel, a Claude Code és az MCP pedig a napi eszköztáram része, ezért az unalmas mintát tudom jó szívvel védeni. Commitolj egy kiinduló állapotot, mielőtt az ágens nekilát. Dolgozzon branchen, fejlesztői workspace ellen. A TMDL diffjét úgy olvasd, ahogy bármelyik pull requestet olvasnád, a measure-öknél és a biztonsági szerepköröknél különös gyanakvással. Merge előtt egyeztess néhány számot egy ismert végösszeggel. Az éles modellekre szóló Write jogot pedig egy pipeline-identitás kapja, ne az egyes laptopok.

A kiadást a Microsoft Power BI September 2026 Feature Summary posztja foglalja össze, a metódusreferencia és a korlátok teljes listája pedig a Microsoft Learn Desktop Bridge és Authoring MCP-szerver oldalain található.