Kết nối với Dataverse bằng Câu hỏi thường gặp về giao thức ngữ cảnh mô hình

Bài viết này cung cấp câu trả lời cho các câu hỏi thường gặp về việc sử dụng Microsoft Dataverse với máy chủ giao thức ngữ cảnh mô hình (MCP).

Tôi không thể xác thực. Vấn đề là gì?

Xác minh rằng URL môi trường Dataverse trong cấu hình máy khách MCP của bạn là chính xác. Truy cập Power Apps, chọn môi trường chính xác, sau đó chọn Cài đặt (biểu tượng bánh răng) >Chi tiết phiên để xác nhận URL phiên bản của bạn.

Ngoài ra, hãy xác minh rằng máy khách MCP bạn đang sử dụng đã được bật trong trung tâm quản trị Power Platform. Thông tin thêm: Đặt cấu hình và quản lý máy chủ Dataverse MCP cho môi trường

Những công cụ MCP nào có sẵn và chúng làm gì?

Máy chủ Dataverse MCP cung cấp các công cụ cho các hoạt động dữ liệu phổ biến như truy vấn bản ghi, tạo và cập nhật hàng cũng như mô tả lược đồ bảng. Để biết danh sách đầy đủ các công cụ và mô tả, hãy truy cập Kết nối với Dataverse bằng Giao thức ngữ cảnh mô hình.

Tôi có thể hạn chế bảng hoặc bản ghi nào có thể truy cập được thông qua máy chủ MCP không?

Có. Máy chủ MCP Dataverse tôn trọng vai trò bảo mật Dataverse và bảo mật cấp hàng. Người dùng chỉ có thể truy cập vào các bảng và bản ghi mà vai trò bảo mật của họ cho phép. Không cần kiểm soát truy cập cụ thể MCP bổ sung ngoài cấu hình bảo mật Dataverse tiêu chuẩn.

Có chi phí liên quan đến việc sử dụng máy chủ MCP Dataverse không?

Bắt đầu từ ngày 15 tháng 12 năm 2025, các công cụ Dataverse MCP bị tính phí khi được truy cập bởi các tác nhân AI được tạo bên ngoài Microsoft Copilot Studio. Nếu bạn có giấy phép Dynamics 365 Premium đủ điều kiện hoặc Giấy phép đăng ký người dùng Microsoft 365 Copilot (USL), bạn sẽ không bị tính phí khi truy cập dữ liệu Dynamics 365. Để biết thông tin về phí thanh toán, hãy truy cập Kết nối với Dataverse bằng Giao thức ngữ cảnh mô hình.

Tôi có thể sử dụng máy chủ MCP Dataverse với nhiều môi trường không?

Có. Mỗi môi trường Dataverse có thể có cấu hình máy chủ MCP riêng. Bạn có thể kết nối với nhiều môi trường bằng cách định cấu hình các mục nhập máy chủ MCP riêng biệt trong máy khách của mình, mỗi mục trỏ đến một URL môi trường khác nhau.

Mẹo

Nếu bạn sử dụng Microsoft Copilot Studio, bạn có thể sử dụng trình hướng dẫn tích hợp MCP để kết nối tác nhân của mình với máy chủ Dataverse MCP trên nhiều môi trường. Trình hướng dẫn hướng dẫn bạn cách cấu hình máy chủ và thiết lập xác thực. Thông tin thêm: Kết nối tác nhân của bạn với máy chủ MCP hiện có

Tôi nên làm gì nếu công cụ MCP Dataverse trả về lỗi?

Nếu một công cụ trả về lỗi, hãy thử diễn đạt lại lời nhắc của bạn và gửi lại. Sử dụng ngôn ngữ cụ thể hơn để mô tả những gì bạn muốn hoàn thành. Nếu lỗi vẫn tiếp diễn, hãy xác minh rằng bạn có quyền Dataverse thích hợp cho thao tác bạn đang cố gắng.

Điều gì đã xảy ra với describe_table, list_tablesvà fetch các công cụ?

Bề mặt công cụ máy chủ Dataverse MCP được cập nhật. Các công cụ trước describe_tablevà list_tablesfetch bị xóa và chức năng của chúng được cung cấp bởi các công cụ khác:

Đã xóa công cụ Thay thế
describe_table describe
list_tables describe
fetch describe

Công cụ trước đó search tìm kiếm dữ liệu Dataverse đã được đổi tên thành search_data. Công cụ hiện tại search tìm kiếm siêu dữ liệu Dataverse để giúp tổng đài viên tìm thấy các bảng và ứng dụng có liên quan.

Nếu ứng dụng MCP của bạn duy trì danh sách cho phép hoặc từ chối theo tên công cụ, hãy xem lại và cập nhật cấu hình của bạn để tên công cụ mới phản ánh các quyền dự định của bạn.

Để biết danh sách đầy đủ các công cụ, hãy truy cập Kết nối với Dataverse bằng Giao thức ngữ cảnh mô hình.

Tại sao tôi không thấy công cụ này search_data trong máy chủ MCP Dataverse?

Công cụ này search_data chỉ khả dụng khi tìm kiếm Dataverse được bật cho môi trường của bạn. Nếu tìm kiếm Dataverse không được bật, công cụ sẽ search_data không xuất hiện trong danh sách các công cụ MCP có sẵn. Để bật tìm kiếm Dataverse, hãy chuyển đến Đặt cấu hình tìm kiếm Dataverse cho môi trường của bạn.

Tại sao tôi thấy các công cụ khác nhau trên các điểm cuối /api/mcp và /api/mcp_preview?

Điểm /api/mcp cuối cung cấp bộ công cụ MCP Dataverse có sẵn rộng rãi. Điểm /api/mcp_preview cuối bao gồm các công cụ xem trước bổ sung được đánh giá trước khi được cung cấp rộng rãi. Các công cụ xem trước có thể thay đổi hoặc bị xóa mà không cần thông báo. Để truy cập các công cụ xem trước, quản trị viên phải bật cài đặt tính năng xem trước trong trung tâm quản trị Power Platform. Thông tin thêm: Sử dụng các công cụ xem trước và các tính năng sắp tới trong máy chủ Dataverse MCP

Làm cách nào để bật tính năng ghi nhật ký gỡ lỗi cho proxy cục bộ?

Nếu gặp sự cố với proxy cục bộ (@microsoft/dataverse), bạn có thể bật tính năng ghi nhật ký gỡ lỗi để ghi lại kết quả chi tiết để khắc phục sự cố. Thêm đối --log-level số và --log-file vào lệnh proxy:

npx @microsoft/dataverse mcp https://yourorg.crm.dynamics.com --log-level Debug --log-file

Tệp nhật ký được ghi vào thư mục tạm thời của hệ thống. Vị trí mặc định phụ thuộc vào hệ điều hành của bạn:

Hệ điều hành Vị trí tệp nhật ký
Windows C:\Users\<username>\AppData\Local\Temp\
Linux /tmp/
macOS Thư mục được chỉ định bởi $TMPDIR biến môi trường, thường /var/folders/.../T/là . Chạy echo $TMPDIR trong một thiết bị đầu cuối để tìm đường dẫn chính xác.

Bạn có thể chia sẻ tệp nhật ký đầu ra với Microsoft khi mở sự cố hỗ trợ để giúp chẩn đoán sự cố.