เชื่อมต่อกับ Dataverse ด้วยโพรโทคอลบริบทแบบจําลองในไคลเอ็นต์ที่ไม่ใช่ของ Microsoft

คุณสามารถเชื่อมต่อกับ Microsoft Dataverse โดยใช้ไคลเอ็นต์โพรโทคอลบริบท (MCP) ที่ไม่ใช่ของ Microsoft เช่น เดสก์ท็อป Claude หรือ Claude Code มีสองวิธีในการเชื่อมต่อไคลเอ็นต์ที่ไม่ใช่ Microsoft ไปยังเซิร์ฟเวอร์ MCP Dataverse:

• พร็อกซีภายในเครื่อง: ใช้ @microsoft/dataverse แพคเกจ npm เพื่อเรียกใช้พร็อกซีภายในเครื่องที่เชื่อมต่อกับเซิร์ฟเวอร์ MCP Dataverse ในนามของคุณ
• จุดสิ้นสุดระยะไกล: เชื่อมต่อโดยตรงไปยังจุดสิ้นสุดระยะไกลของเซิร์ฟเวอร์ Dataverse MCP (/api/mcp) โดยการลงทะเบียนแอป Microsoft Entra แบบกําหนดเอง

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

• เซิร์ฟเวอร์ MCP ของ Dataverse ต้องเปิดใช้งานสําหรับสภาพแวดล้อม ข้อมูลเพิ่มเติม: กําหนดค่าและจัดการเซิร์ฟเวอร์ MCP Dataverse สําหรับสภาพแวดล้อม
• สําหรับวิธีพร็อกซีภายในเครื่อง: Node.js (เวอร์ชัน 18 หรือใหม่กว่า) ที่ติดตั้งบนเครื่องของคุณ
• สําหรับวิธีปลายทางระยะไกล: การเข้าถึงเพื่อลงทะเบียนแอปพลิเคชันใน Microsoft Entra ID

เชื่อมต่อโดยใช้พร็อกซีภายในเครื่อง

@microsoft/dataverseแพคเกจ npm มีพร็อกซีภายในเครื่องที่จัดการการรับรองความถูกต้องและการสื่อสารกับเซิร์ฟเวอร์ Dataverse MCP ขอแนะนําให้ใช้วิธีการนี้สําหรับไคลเอ็นต์ที่ไม่ใช่ Microsoft MCP ส่วนใหญ่ที่สามารถเรียกใช้เซิร์ฟเวอร์ MCP ภายในเครื่องได้

ให้ความยินยอมของผู้ดูแลระบบผู้เช่า

ผู้ดูแลระบบผู้เช่าต้องให้ความยินยอมของผู้ดูแลระบบสําหรับแอป Dataverse CLI ก่อนที่ผู้ใช้จะสามารถรับรองความถูกต้องได้ นําทางไปยัง URL ต่อไปนี้ในเบราว์เซอร์ แทนที่ {your-tenant-id} ด้วย ID ผู้เช่า Microsoft Entra ของคุณ:

https://login.microsoftonline.com/{your-tenant-id}/adminconsent?client_id=0c412cc3-0dd6-449b-987f-05b053db9457

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

เปิดใช้งานไคลเอ็นต์ Dataverse CLI ในศูนย์การจัดการ Power Platform

ก่อนที่คุณสามารถเชื่อมต่อโดยใช้พร็อกซีภายในเครื่อง ไคลเอ็นต์ Dataverse CLI ต้องเปิดใช้งานเป็นไคลเอ็นต์ MCP ที่ได้รับอนุญาตในสภาพแวดล้อมของคุณ

1. ไปที่ ศูนย์การจัดการ Power Platform เลือกจัดการ>สภาพแวดล้อม
2. เลือกสภาพแวดล้อมที่คุณต้องการเปิดใช้งานไคลเอ็นต์ จากนั้นเลือก การตั้งค่า
3. ภายใต้ การตั้งค่า เลือกคุณลักษณะ> เลื่อนลงเพื่อค้นหา โพรโทคอลบริบทของแบบจําลองข้อมูล และเลือก การตั้งค่าขั้นสูง
4. ค้นหาไคลเอ็นต์ Dataverse CLI (ID 0c412cc3-0dd6-449b-987f-05b053db9457แอป ) และตั้งค่า เปิดใช้งานเป็นใช่
5. เลือก บันทึกและปิด

ติดตั้งพร็อกซีภายในเครื่อง

คุณสามารถติดตั้ง@microsoft/dataverseแพคเกจส่วนกลาง หรือเรียกใช้โดยตรงด้วยnpx

หากต้องการติดตั้งส่วนกลาง ให้เรียกใช้คําสั่งต่อไปนี้ในเทอร์มินัล:

npm install -g @microsoft/dataverse

อีกวิธีหนึ่งคือ คุณสามารถใช้ npx เพื่อเรียกใช้พร็อกซีโดยไม่ต้องติดตั้งส่วนกลาง:

npx @microsoft/dataverse mcp https://yourorg.crm.dynamics.com

กําหนดค่าพร็อกซีภายในเครื่องในเดสก์ท็อป Claude

ในส่วนนี้จะอธิบายวิธีกําหนดค่าพร็อกซีภายในเครื่องเซิร์ฟเวอร์ MCP Dataverse ในเดสก์ท็อป Claude ถ้าคุณยังไม่ได้ดําเนินการดังกล่าว ให้ดาวน์โหลดและติดตั้ง Claude desktop

1. เปิดเดสก์ท็อป Claude และไปที่การตั้งค่า>ไฟล์>สําหรับนักพัฒนา

2. เลือก แก้ไข Config เพื่อเปิด claude_desktop_config.json ไฟล์

3. เพิ่มส่วนย่อย JSON ต่อไปนี้ลงในไฟล์ แทนที่ <friendly name> ด้วยชื่อที่คุณสามารถจดจําได้อย่างง่ายดาย (ตัวอย่างเช่น MyDataverseMCServer) และแทนที่ <your org URL> ด้วย URL สภาพแวดล้อม Dataverse ของคุณ (ตัวอย่างเช่น https://contoso.crm.dynamics.com)

   {
     "mcpServers": {
       "<friendly name>": {
         "command": "npx",
         "args": [
           "-y",
           "@microsoft/dataverse",
           "mcp",
           "<your org URL>"
         ]
       }
     }
   }
   

4. บันทึกไฟล์

ตรวจสอบการเชื่อมต่อในเดสก์ท็อป Claude

1. ออกจากเดสก์ท็อป Claude โดยการเลือก แฟ้ม>ออก แล้วเปิดอีกครั้งเพื่อใช้การเปลี่ยนแปลง
2. ลงชื่อเข้าใช้ด้วยข้อมูลรับรองของคุณเมื่อมีการให้ยืนยันตัวตนในสภาพแวดล้อม Dataverse ของคุณ
3. เลือก ค้นหาและเครื่องมือ เพื่อตรวจสอบว่าเซิร์ฟเวอร์ Dataverse MCP และเครื่องมือพร้อมใช้งานหรือไม่ คุณควรเห็นชื่อที่เรียกง่ายที่คุณกําหนดค่า (ตัวอย่างเช่น MyDataverseMCPServer)
4. เลือกชื่อเซิร์ฟเวอร์ MCP เพื่อดูรายการเครื่องมือที่ได้รับการสนับสนุนโดยเซิร์ฟเวอร์

กําหนดค่าพร็อกซีภายในเครื่องในรหัส Claude

ในส่วนนี้จะอธิบายวิธีกําหนดค่าพร็อกซีภายในเครื่องเซิร์ฟเวอร์ MCP Dataverse ในโค้ด Claude ถ้าคุณยังไม่ได้ดําเนินการดังกล่าว ให้ดาวน์โหลดและติดตั้ง Claude Code

เรียกใช้คําสั่งต่อไปนี้เพื่อเพิ่มเซิร์ฟเวอร์ MCP Dataverse แทนที่ https://yourorg.crm.dynamics.com ด้วย URL สภาพแวดล้อม Dataverse ของคุณ

claude mcp add dataverse -t stdio -- npx -y @microsoft/dataverse mcp https://yourorg.crm.dynamics.com

ยืนยันและโต้ตอบกับการเชื่อมต่อใน Claude Code

1. รีสตาร์ทรหัส Claude เพื่อนําการเปลี่ยนแปลงไปใช้
2. ลงชื่อเข้าใช้ด้วยข้อมูลรับรองของคุณเมื่อมีการให้ยืนยันตัวตนในสภาพแวดล้อม Dataverse ของคุณ
3. ตรวจสอบว่าเซิร์ฟเวอร์ Dataverse MCP และเครื่องมือพร้อมใช้งาน คุณควรเห็นชื่อที่เรียกง่ายที่คุณกําหนดค่า (ตัวอย่างเช่น MyDataverseMCPServer)
4. เลือกชื่อเซิร์ฟเวอร์ MCP เพื่อดูรายการเครื่องมือที่ได้รับการสนับสนุนโดยเซิร์ฟเวอร์

ถ้าคุณมีข้อมูลในสภาพแวดล้อม Dataverse คุณสามารถทดสอบการตั้งค่าได้โดยขอให้แสดงตารางใน ข้อมูล ให้อธิบายตารางบัญชี หรือจํานวนบัญชีที่ฉันมี ข้อมูลเพิ่มเติม: เพิ่มและเอาข้อมูลตัวอย่างออก

เชื่อมต่อโดยใช้จุดสิ้นสุดระยะไกล

คุณสามารถเชื่อมต่อไคลเอ็นต์ MCP ที่ไม่ใช่ของ Microsoft ได้โดยตรงไปยังจุดสิ้นสุดระยะไกลของเซิร์ฟเวอร์ Dataverse MCP โดยไม่ต้องใช้พร็อกซีภายในเครื่อง วิธีการนี้ต้องการให้คุณลงทะเบียนแอปพลิเคชันแบบกําหนดเองใน Microsoft Entra ID และเพิ่ม ID ไคลเอ็นต์ลงในรายการไคลเอ็นต์ที่ได้รับอนุญาตในศูนย์การจัดการ Power Platform

ลงทะเบียนแอป Microsoft Entra แบบกําหนดเอง

ลงทะเบียนแอปพลิเคชันใน Microsoft Entra ID เพื่อใช้สําหรับการรับรองความถูกต้องเมื่อเชื่อมต่อกับเซิร์ฟเวอร์ Dataverse MCP สําหรับข้อมูลทั่วไปเกี่ยวกับการลงทะเบียนแอป ไปที่ลงทะเบียนแอปพลิเคชันด้วยแพลตฟอร์มข้อมูลประจําตัวของ Microsoft

ทําตามขั้นตอนเหล่านี้เพื่อลงทะเบียนแอปสําหรับการใช้งานกับเซิร์ฟเวอร์ Dataverse MCP:

1. ลงชื่อเข้าใช้ ศูนย์การจัดการ Microsoft Entra
2. ไปที่การลงทะเบียนแอป>> จากนั้นเลือก การลงทะเบียนใหม่
3. ใส่ชื่อสําหรับแอปพลิเคชันของคุณ (ตัวอย่างเช่น Dataverse MCP Client) กําหนดค่าชนิดบัญชีที่ได้รับการสนับสนุนสําหรับสถานการณ์สมมติของคุณ จากนั้นเลือกลงทะเบียน
4. บนหน้าภาพรวม ให้สังเกต ID แอปพลิเคชัน (ไคลเอนต์) คุณต้องใช้ค่านี้เพื่อกําหนดค่าไคลเอ็นต์ที่ได้รับอนุญาตในศูนย์การจัดการ Power Platform และกําหนดค่าไคลเอ็นต์ MCP ของคุณ

กําหนดค่าสิทธิ์ API สําหรับเซิร์ฟเวอร์ MCP ของ Dataverse

หลังจากที่คุณลงทะเบียนแอป คุณต้องให้สิทธิ์ในการเข้าถึงเซิร์ฟเวอร์ MCP Dataverse

1. ในการลงทะเบียนแอป เลือก สิทธิ์ API จากบานหน้าต่างนําทางด้านซ้าย
2. เลือก เพิ่มสิทธิ์
3. เลือก Microsoft API แล้วเลือก Dynamics CRM
4. เลือกสิทธิ์ mcp.tools จากนั้นเลือก เพิ่มสิทธิ์

เพิ่มแอปแบบกําหนดเองลงในรายการไคลเอ็นต์ที่ได้รับอนุญาต

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

1. ไปที่ ศูนย์การจัดการ Power Platform เลือกจัดการ>สภาพแวดล้อม
2. เลือกสภาพแวดล้อมที่คุณต้องการอนุญาตไคลเอ็นต์ จากนั้นเลือก การตั้งค่า
3. ภายใต้ การตั้งค่า เลือกคุณลักษณะ> เลื่อนลงเพื่อค้นหา โพรโทคอลบริบทของแบบจําลองข้อมูล และเลือก การตั้งค่าขั้นสูง
4. เพิ่มรายการไคลเอ็นต์ใหม่ ป้อนชื่อสําหรับไคลเอ็นต์และระบุ ID แอปพลิเคชัน (ไคลเอนต์) จากการลงทะเบียนแอป Entra ของคุณ
5. ตั้งค่าเปิดใช้งานเป็นใช่
6. เลือก บันทึกและปิด

เชื่อมต่อไปยังจุดสิ้นสุดระยะไกล

กําหนดค่าไคลเอ็นต์ MCP ของคุณเพื่อเชื่อมต่อกับเซิร์ฟเวอร์ Dataverse MCP ใน URL ต่อไปนี้:

https://<your org URL>/api/mcp

ตัวอย่างเช่น: https://contoso.crm.dynamics.com/api/mcp

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

บทความที่เกี่ยวข้อง

เชื่อมต่อกับ Dataverse ด้วยโพรโทคอลบริบทแบบจําลอง