คู่มือติดตั้ง Power BI Modeling MCP บน Claude Desktop

INSTALLATION GUIDE · POWER BI MODELING MCP

เลือกหัวข้ออ่าน

ติดตั้ง Power BI Modeling MCP
เชื่อม Claude Desktop เข้ากับ Power BI Desktop

คู่มือติดตั้งแบบทีละขั้นตอน ให้ Claude อ่านโครงสร้างโมเดล Power BI ที่เปิดอยู่ เขียน/ตรวจ DAX สร้าง Measure และวิเคราะห์ความสัมพันธ์ของตารางได้โดยตรงผ่าน MCP Server ของ Microsoft

ขั้นตอน

โปรแกรมที่ต้องมี

Win

รองรับเต็มรูปแบบ

~15

นาที

ก่อนเริ่ม

ข้อกำหนดเบื้องต้น

ต้องติดตั้งโปรแกรมทั้งหมดนี้บนเครื่องเดียวกัน และล็อกอินด้วย user profile เดียวกัน

✅ เช็คก่อนเสมอ: เครื่องมี Node.js แล้วหรือยัง?

เปิด Command Prompt แล้วพิมพ์ node -v — ถ้าขึ้นเลขเวอร์ชัน (เช่น v20.x.x) แปลว่ามีแล้ว ข้ามไปขั้นตอนถัดไปได้เลย แต่ถ้าขึ้น error ว่า "node ไม่รู้จัก" ให้ไปดาวน์โหลด Node.js เวอร์ชัน LTS ที่ nodejs.org ติดตั้งแล้วรีสตาร์ทเครื่องก่อน จึงค่อยเริ่มขั้นตอนติดตั้งด้านล่าง

🪟
Windows
การเชื่อมต่อกับโมเดลที่เปิดใน Power BI Desktop ใช้ local XMLA endpoint ซึ่งรองรับเต็มรูปแบบเฉพาะ Windows เท่านั้น (macOS/Linux ใช้ได้เฉพาะกับ Fabric หรือไฟล์ TMDL)
🟢
Node.js (npx)
Config ใช้คำสั่ง npx เพื่อดึงแพ็กเกจเซิร์ฟเวอร์มารันเอง จึงต้องติดตั้ง Node.js ไว้ล่วงหน้า (เช็คด้วย node -v ด้านบน)
📊
Power BI Desktop
ต้องเปิดค้างไว้พร้อมโหลดโมเดล/ไฟล์ .pbix ระหว่างใช้งาน Claude เชื่อมต่อผ่าน instance ที่กำลังเปิดอยู่
💬
Claude Desktop
แอปเวอร์ชันล่าสุด — จะเป็นตัวที่เราชี้ config ไปหาไฟล์เซิร์ฟเวอร์ MCP ในขั้นตอนถัดไป

Overview

ภาพรวมการเชื่อมต่อ

Claude Desktop รันไฟล์เซิร์ฟเวอร์ MCP เป็น local process (stdio) เพื่อคุยกับ Power BI Desktop ผ่าน XMLA endpoint

Power BI Desktop

เปิดโมเดล .pbix

←→

Claude Desktop

claude_desktop_config.json

Step by Step

ขั้นตอนติดตั้ง

ทำตามลำดับ 1 → 4 ห้ามข้ามขั้นตอน โดยเฉพาะการรีสตาร์ท Claude Desktop หลังบันทึกไฟล์ config

เปิดหน้า Edit Config ใน Claude Desktop

เปิดแอป Claude Desktop แล้วไปที่:

Settings → Developer → Edit Config

Claude จะเปิดไฟล์ claude_desktop_config.json ให้แก้ไขโดยอัตโนมัติ ไม่ต้องไล่หา path เอง

วางโค้ด Config แล้ว Save

ใส่คีย์นี้ไว้ภายในอ็อบเจ็กต์ "mcpServers" ของไฟล์ (หากมีเซิร์ฟเวอร์อื่นอยู่แล้ว ให้เพิ่มเป็นคีย์ใหม่ต่อจากของเดิม แทนที่จะเขียนทับ):

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

💡 ต้องมี Node.js (npx) ในเครื่อง

วิธีนี้ใช้ npx ดึงแพ็กเกจ @microsoft/powerbi-modeling-mcp มารันโดยตรง ไม่ต้องหา path ของไฟล์ .exe เอง แต่ต้องติดตั้ง Node.js ไว้ก่อน และเชื่อมต่ออินเทอร์เน็ตในการรันครั้งแรกเพื่อดาวน์โหลดแพ็กเกจ จากนั้นกด Save

รีสตาร์ท Claude Desktop

ปิด Claude Desktop ให้สนิท (รวมถึง process ใน system tray) แล้วเปิดใหม่ เพื่อให้โหลด config ที่บันทึกไป

เปิด Power BI Desktop และทดสอบ

เปิดไฟล์ .pbix ที่ต้องการทำงานด้วยไว้ล่วงหน้า จากนั้นเปิด Claude Desktop — ควรเห็นไอคอนปลั๊ก 🔌 หรือสัญลักษณ์บอกว่า MCP เชื่อมต่อสำเร็จ

พิมพ์ถามใน Claude เช่น "ตรวจหาไฟล์ Power BI Desktop ที่เปิดอยู่ตอนนี้"
Claude จะตอบกลับพร้อมชื่อไฟล์และจำนวนตารางที่พบ

ทดสอบการทำงาน

คำสั่งทดสอบตามหมวดงาน

คลิกเพื่อดูตัวอย่างคำถามที่ใช้ทดสอบแต่ละกลุ่มการทำงานของ MCP Server

🔗

GROUP 1 · CONNECTION

ตรวจจับและเชื่อมต่อโมเดล

database_operations · connection_operations

＋

ใช้ยืนยันว่า Claude มองเห็น Power BI Desktop instance ที่เปิดอยู่

ตรวจหา Power BI Desktop instance ที่เปิดอยู่ตอนนี้ เชื่อมต่อกับโมเดลที่เปิดอยู่

📋

GROUP 2 · STRUCTURE

สำรวจโครงสร้างโมเดล

table_operations · column_operations · relationship_operations

＋

ให้ Claude อ่านตาราง คอลัมน์ และความสัมพันธ์ทั้งหมดในโมเดล

แสดงตารางทั้งหมดพร้อมชื่อคอลัมน์ วิเคราะห์ความสัมพันธ์ระหว่างตารางในโมเดลนี้

🧮

GROUP 3 · DAX

เขียนและตรวจสอบ DAX

measure_operations · dax_query_operations

＋

สร้าง Measure ใหม่ หรือให้ Claude ช่วยตรวจ/ปรับปรุงสูตร DAX ที่มีอยู่

สร้าง Measure ยอดขายรวม (Total Sales) ตรวจสอบและแนะนำการปรับปรุงสูตร DAX นี้

📄

GROUP 4 · DOCUMENTATION

จัดทำเอกสารโมเดล

model_operations · named_expression_operations

＋

ให้ Claude สรุปโครงสร้างโมเดลเป็นเอกสารอ่านง่าย โดยไม่ต้องพิมพ์เอง

จัดทำเอกสารสรุปโมเดลนี้ทั้งหมด ค้นหา Measure ที่มีคำว่า CALCULATE อยู่ในสูตร

Troubleshooting

ปัญหาที่พบบ่อย

🚫 Claude มองไม่เห็นเซิร์ฟเวอร์ / ไม่ขึ้นไอคอน 🔌

ตรวจสอบว่า JSON ในไฟล์ claude_desktop_config.json ถูกต้อง (ไม่มี comma เกิน/ขาด) แล้วรีสตาร์ท Claude Desktop ให้สนิท — ครั้งแรกที่รันอาจใช้เวลาสักครู่เพราะ npx ต้องดาวน์โหลดแพ็กเกจก่อน

⚠️ "npx" หรือ "node" ไม่รู้จัก (not recognised)

แปลว่ายังไม่ได้ติดตั้ง Node.js หรือยังไม่ได้เพิ่มเข้า PATH — ติดตั้ง Node.js เวอร์ชัน LTS จาก nodejs.org แล้วรีสตาร์ทเครื่องก่อนลองใหม่

🍎 ใช้ macOS หรือ Linux อยู่

MCP Server รันได้ แต่เชื่อมต่อกับโมเดลที่เปิดใน Power BI Desktop (local XMLA) ไม่ได้ — ใช้ได้เฉพาะกับโมเดลบน Fabric หรือไฟล์ TMDL เท่านั้น

🔁 เชื่อมต่อกับไฟล์ผิดตัว

Claude จะเชื่อมต่อกับ Power BI Desktop instance ที่ active ล่าสุดโดยอัตโนมัติ — ปิดไฟล์ .pbix อื่นที่ไม่เกี่ยวข้องก่อน เหลือไว้แค่ไฟล์ที่ต้องการทำงานด้วย

สรุป

ตารางสรุปขั้นตอนทั้งหมด

ขั้นตอน	ทำที่	ผลลัพธ์
1. เปิด Edit Config	Claude Desktop → Settings → Developer	ไฟล์ claude_desktop_config.json เปิดพร้อมแก้ไข
2. วาง Config + Save	claude_desktop_config.json	Claude รู้จักเซิร์ฟเวอร์ MCP
3. รีสตาร์ท	Claude Desktop	โหลดเซิร์ฟเวอร์ขึ้นมาใหม่
4. ทดสอบ	Power BI Desktop + Claude	เชื่อมต่อโมเดล พร้อมใช้งานจริง