ลงทะเบียนเซิร์ฟเวอร์ Power BI MCP ระยะไกลกับไคลเอ็นต์ MCP ภายนอก (พรีวิว)

เซิร์ฟเวอร์ Power BI MCP ระยะไกลทํางานทันทีกับไคลเอ็นต์ MCP ที่มาพร้อมกับแอปพลิเคชัน Microsoft Entra ที่ลงทะเบียนไว้ล่วงหน้า เช่น Visual Studio Code และ GitHub Copilot CLI ไคลเอ็นต์ MCP อื่นๆ เช่น Claude Desktop และ ChatGPT ต้องลงทะเบียน ID ไคลเอ็นต์ OAuth ขณะนี้ Microsoft Entra ID ไม่สนับสนุนการลงทะเบียนไคลเอ็นต์ ดังนั้นไคลเอ็นต์เหล่านี้จึงไม่สามารถรับรหัสไคลเอ็นต์สําหรับเซิร์ฟเวอร์ Power BI MCP ได้โดยอัตโนมัติ

เมื่อต้องการแก้ไขปัญหานี้ คุณลงทะเบียนแอป Microsoft Entra ด้วยตัวคุณเอง และระบุรหัสแอปพลิเคชัน (ไคลเอ็นต์) ให้กับไคลเอ็นต์ MCP เป็นรหัสไคลเอ็นต์ OAuth

บทความนี้แสดงให้คุณรู้จักวิธี:

• สร้างและกําหนดค่าการลงทะเบียนแอป Microsoft Entra สําหรับไคลเอ็นต์ MCP ภายนอก
• ลงทะเบียนเซิร์ฟเวอร์ Power BI MCP ระยะไกลในไคลเอ็นต์ภายนอกโดยใช้รหัสแอป Entra

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

ก่อนที่คุณจะเริ่มต้น ให้แน่ใจว่าคุณมี:

• การอนุมัติของผู้ดูแลระบบ - ผู้ดูแลระบบ Power BI ของคุณต้องเปิดใช้งานการตั้งค่าผู้เช่า: ผู้ใช้สามารถใช้ตําแหน่งข้อมูลเซิร์ฟเวอร์โพรโทคอลบริบทแบบจําลอง Power BI (พรีวิว)
• สิทธิ์ในการลงทะเบียนแอป - คุณสามารถลงทะเบียนแอปในผู้เช่า Microsoft Entra ของคุณ หรือทํางานร่วมกับผู้ดูแลระบบผู้เช่าที่สามารถลงทะเบียนแอปให้คุณได้

ขั้นตอนที่ 1: สร้างการลงทะเบียนแอป Microsoft Entra

สร้างการลงทะเบียนแอปใหม่ในผู้เช่า Microsoft Entra เดียวกันกับที่โฮสต์สภาพแวดล้อม Power BI ของคุณ

1. ลงชื่อเข้าใช้ ศูนย์การจัดการ Microsoft Entra ในฐานะผู้ใช้ที่สามารถลงทะเบียนแอปพลิเคชันได้
2. ไปที่ App registrations แล้วเลือก การลงทะเบียนใหม่
3. ป้อนชื่อที่มีความหมาย เช่น Power BI MCP - Claude Desktop
4. ภายใต้ ชนิดบัญชีที่รองรับ ให้เลือก บัญชีในไดเรกทอรีขององค์กรนี้เท่านั้น (ผู้เช่ารายเดียว)
5. ปล่อยให้ URI การเปลี่ยนเส้นทาง ว่างเปล่าในตอนนี้ คุณกําหนดค่าในขั้นตอนถัดไป
6. เลือก การลงทะเบียน
7. ในหน้าภาพรวมของแอป ให้คัดลอกรหัสแอปพลิเคชัน (ไคลเอ็นต์) คุณใช้ในภายหลังเมื่อคุณกําหนดค่าไคลเอ็นต์ MCP

ขั้นตอนที่ 2: กําหนดค่า URI การเปลี่ยนเส้นทาง

ไคลเอ็นต์ MCP ภายนอกทําหน้าที่เป็นไคลเอ็นต์สาธารณะ ดังนั้นคุณต้องเพิ่ม URI การเปลี่ยนเส้นทางประเภท ไคลเอ็นต์สาธารณะ/เนทีฟ (มือถือและเดสก์ท็อป)

1. ในการลงทะเบียนแอปของคุณ ให้เลือก การรับรองความถูกต้อง>เพิ่ม URI> การเปลี่ยนเส้นทางแอปพลิเคชันมือถือและเดสก์ท็อป

2. เพิ่ม URI การเปลี่ยนเส้นทางที่ไคลเอ็นต์ MCP ให้มา เช่น:

   ไคลเอนต์ MCP	เปลี่ยนเส้นทาง URI
   เดสก์ท็อป Claude	https://claude.ai/api/mcp/auth_callback
   ChatGPT	https://chatgpt.com/connector/oauth/<random_chars>
   ลูกค้ารายอื่น	ใช้ URL การเรียกกลับ OAuth ที่บันทึกโดยไคลเอ็นต์

3. เลือก กําหนดค่า เพื่อบันทึกการกําหนดค่าแพลตฟอร์ม

4. บนหน้า การรับรองความถูกต้อง ภายใต้ การตั้งค่าขั้นสูง ให้ยืนยันว่า อนุญาตโฟลว์ไคลเอ็นต์สาธารณะ ถูกตั้งค่าเป็น ไม่ เว้นแต่เอกสารไคลเอ็นต์ของคุณจะกําหนดไว้อย่างชัดเจน

5. เลือก บันทึก

ขั้นตอนที่ 3: เพิ่มสิทธิ์ API ของ Power BI ที่ได้รับมอบหมาย

เซิร์ฟเวอร์ Power BI MCP ระยะไกลจะเรียก Power BI REST API ในนามของผู้ใช้ที่ลงชื่อเข้าใช้ ให้สิทธิ์ที่ได้รับมอบหมายต่อไปนี้บน API Power BI Service

1. ในการลงทะเบียนแอปของคุณ เลือกสิทธิ์> APIเพิ่มสิทธิ์

2. เลือก Power BI Service ใน Microsoft APIs

3. เลือก สิทธิ์ที่ได้รับมอบสิทธิ์ แล้วเพิ่มสิทธิ์ต่อไปนี้:

   URI ทรัพยากร: https://analysis.windows.net/powerbi/api

   ขอบเขต	คำอธิบาย
   Dataset.Read.All	อ่านโมเดลความหมายทั้งหมดที่ผู้ใช้สามารถเข้าถึงได้
   MLModel.Execute.All	อนุญาตให้เรียกใช้โมเดล ML
   Workspace.Read.All	อ่านพื้นที่ทํางานที่ผู้ใช้สามารถเข้าถึงได้

4. เลือก เพิ่มสิทธิ์

5. (ไม่บังคับ) หากผู้เช่าของคุณต้องการความยินยอมของผู้ดูแลระบบสําหรับสิทธิ์เหล่านี้ ให้เลือก ให้ความยินยอมของผู้ดูแลระบบ มิฉะนั้น ระบบจะแจ้งให้ผู้ใช้ยินยอมในครั้งแรกที่ลงชื่อเข้าใช้จากไคลเอ็นต์ MCP

ขั้นตอนที่ 4: ลงทะเบียนเซิร์ฟเวอร์ Power BI MCP ระยะไกลในไคลเอ็นต์ MCP

ใช้ รหัสแอปพลิเคชัน (ไคลเอ็นต์) จากขั้นตอนที่ 1 เป็นรหัสไคลเอ็นต์ OAuth เมื่อคุณเพิ่มเซิร์ฟเวอร์ MCP Power BI ระยะไกลลงในไคลเอ็นต์ ขั้นตอนการกําหนดค่าที่แน่นอนขึ้นอยู่กับไคลเอ็นต์

หากการลงชื่อเข้าใช้ล้มเหลว ให้ตรวจสอบว่า:

• URI การเปลี่ยนเส้นทางในแอป Entra ของคุณตรงกับที่ลูกค้าคาดหวังทุกประการ
• สิทธิ์ Power BI ที่ได้รับมอบหมายที่จําเป็นจะได้รับ (และได้รับความยินยอมจากผู้ดูแลระบบหากผู้เช่าของคุณต้องการ)
• การตั้งค่าผู้เช่า "ผู้ใช้สามารถใช้จุดสิ้นสุดของเซิร์ฟเวอร์โพรโทคอลบริบทแบบจําลอง Power BI (พรีวิว)" ถูกเปิดใช้งาน

เดสก์ท็อป Claude

1. เปิด Claude Desktop แล้วไปที่ ตัวเชื่อมต่อ>การตั้งค่า>เพิ่มตัวเชื่อมต่อแบบกําหนดเอง

2. ป้อนค่าต่อไปนี้:

   • ชื่อ: Power BI
   • URL ของเซิร์ฟเวอร์ MCP ระยะไกล: https://api.fabric.microsoft.com/v1/mcp/powerbi
   • รหัสไคลเอ็นต์ OAuth: รหัสแอปพลิเคชัน (ไคลเอ็นต์) จากขั้นตอนที่ 1

3. บันทึกตัวเชื่อมต่อ Claude Desktop จะเปิดหน้าต่างเบราว์เซอร์เพื่อให้คุณสามารถลงชื่อเข้าใช้ด้วยบัญชี Microsoft Entra ของคุณและยินยอมให้สิทธิ์ Power BI ที่ร้องขอ

ChatGPT

1. ใน ChatGPT ไปที่การตั้งค่า>แอป>สร้างแอป

2. กรอกข้อมูลในกล่องโต้ตอบ แอปใหม่ :

   • ชื่อ: Power BI
   • URL ของเซิร์ฟเวอร์ MCP: https://api.fabric.microsoft.com/v1/mcp/powerbi
   • การตรวจสอบสิทธิ์: เลือก OAuth

3. ขยาย การตั้งค่าขั้นสูง เพื่อตรวจสอบการตั้งค่า OAuth ที่ค้นพบ แล้วกําหนดค่าต่อไปนี้

   • วิธีการลงทะเบียน: เลือกไคลเอ็นต์ OAuthUser-Defined
   • รหัสไคลเอ็นต์ OAuth: ป้อน รหัสแอปพลิเคชัน (ไคลเอ็นต์) จากขั้นตอนที่ 1

4. เลือก สร้าง ChatGPT แจ้งให้คุณลงชื่อเข้าใช้ด้วยบัญชี Microsoft Entra ของคุณและยินยอมให้สิทธิ์ Power BI ที่ร้องขอ

ไคลเอนต์ MCP อื่นๆ

สําหรับไคลเอ็นต์ MCP อื่นๆ ให้ทําตามเอกสารประกอบของไคลเอ็นต์เพื่อเพิ่มเซิร์ฟเวอร์ MCP ระยะไกล

ทดสอบการเชื่อมต่อของคุณ

หลังจากที่คุณลงทะเบียนเซิร์ฟเวอร์ในไคลเอ็นต์ ให้ตรวจสอบการตั้งค่า:

1. เริ่มการสนทนาใหม่ในไคลเอ็นต์ MCP ของคุณ
2. ถามคําถามที่ต้องใช้เซิร์ฟเวอร์ Power BI MCP ตัวอย่างเช่น: "ตารางใดอยู่ในแบบจําลองความหมาย [รหัสของแบบจําลองความหมาย]"
3. ยืนยันว่าไคลเอ็นต์ส่งกลับผลลัพธ์จากแบบจําลองความหมาย Power BI ของคุณ

เนื้อหาที่เกี่ยวข้อง

• เริ่มต้นใช้งานเซิร์ฟเวอร์ Power BI MCP ระยะไกล
• ลงทะเบียนใบสมัครด้วย แพลตฟอร์มข้อมูลประจำตัวของ Microsoft
• ข้อมูลจําเพาะของโปรโตคอลกำหนดบริบทของโมเดล