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

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

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

ตารางต่อไปนี้แสดงสองเซิร์ฟเวอร์ที่โฮสต์และจุดสิ้นสุดของพวกเขา:

เซิร์ฟเวอร์ ปลายทาง
Power BI เขียนเซิร์ฟเวอร์ MCP https://api.fabric.microsoft.com/v1/mcp/powerbi/authoring
เซิร์ฟเวอร์ MCP ของปริมาณการใช้ Power BI https://api.fabric.microsoft.com/v1/mcp/powerbi

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

  • สร้างและกําหนดค่าการลงทะเบียนแอป Microsoft Entra สําหรับไคลเอ็นต์ MCP ภายนอก
  • ลงทะเบียนเซิร์ฟเวอร์ Power BI MCP ที่โฮสต์ในไคลเอ็นต์ภายนอกโดยใช้ ID แอป Microsoft 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. เลือก บันทึก

สำคัญ

ใช้ URI เปลี่ยนเส้นทางที่แน่นอนที่เอกสารไคลเอ็นต์ MCP ของคุณเสมอ การลงชื่อเข้าใช้ OAuth ไม่ตรงกันทําให้การลงชื่อเข้าใช้ OAuth ล้มเหลว

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

เซิร์ฟเวอร์ MCP Power BI ที่โฮสต์เรียกใช้ Power BI REST API ในนามของผู้ใช้ที่ลงชื่อเข้าใช้ ให้สิทธิ์ที่ได้รับมอบหมายแก่สถานการณ์ที่คุณต้องการใน Power BI Service API

  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 อ่านพื้นที่ทํางานที่คุณสามารถเข้าถึงได้ เซิร์ฟเวอร์การเขียนและปริมาณการใช้
    SemanticModel.ReadWrite.All อ่านและเขียนแบบจําลองความหมายทั้งหมดที่คุณสามารถเข้าถึงได้ เซิร์ฟเวอร์การเขียนแก้
  4. เลือก เพิ่มสิทธิ์

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

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

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

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

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

ลงทะเบียนเซิร์ฟเวอร์ Power BI MCP ใน Claude Desktop

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

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

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

ลงทะเบียนเซิร์ฟเวอร์ Power BI MCP ใน ChatGPT

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

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

    • ชื่อ: Power BI
    • URL ของเซิร์ฟเวอร์ MCP: จุดสิ้นสุดสําหรับเซิร์ฟเวอร์ที่คุณต้องการลงทะเบียน
    • การตรวจสอบสิทธิ์: เลือก OAuth
  3. ขยาย การตั้งค่าขั้นสูง เพื่อตรวจสอบการตั้งค่า OAuth ที่ค้นพบ แล้วกําหนดค่าต่อไปนี้

    • วิธีการลงทะเบียน: เลือกไคลเอ็นต์ OAuthUser-Defined
    • รหัสไคลเอ็นต์ OAuth: ป้อน รหัสแอปพลิเคชัน (ไคลเอ็นต์) จากขั้นตอนที่ 1
  4. เลือก สร้าง ChatGPT แจ้งให้คุณลงชื่อเข้าใช้ด้วยบัญชี Microsoft Entra ของคุณและยินยอมให้สิทธิ์ Power BI ที่ร้องขอ

ลงทะเบียนเซิร์ฟเวอร์ Power BI MCP ในไคลเอนต์ MCP อื่น ๆ

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

ทดสอบการเชื่อมต่อเซิร์ฟเวอร์ Power BI MCP

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

  1. เริ่มการสนทนาใหม่ในไคลเอ็นต์ MCP ของคุณ
  2. ถามคําถามที่จําเป็นต้องใช้เซิร์ฟเวอร์ สําหรับเซิร์ฟเวอร์ปริมาณการใช้ ให้ลองWhat tables are in semantic model [ID of the semantic model]? สําหรับเซิร์ฟเวอร์การเขียน ลองConnect to semantic model '[Semantic Model Name]' in Fabric Workspace '[Workspace Name]'
  3. ยืนยันว่าไคลเอ็นต์ส่งกลับผลลัพธ์จาก Power BI