Tài liệu

Kết nối ứng dụng khách AI bằng MCP

Trong trang này

Kết nối ứng dụng khách AI với bàn làm việc thông qua MCP, rồi lặp lại quy trình làm việc từng thay đổi một mà không phải giao quyền điều khiển camera.

MCP bổ sung điều gì

MCP (Model Context Protocol) cho phép ứng dụng khách AI gọi các công cụ được hỗ trợ của bàn làm việc: kiểm tra một quy trình làm việc, đề xuất một ứng viên và đọc lại bằng chứng của thử nghiệm. Đây là cách thứ hai để điều khiển cùng một dịch vụ tác vụ. MCP không bổ sung trình điều khiển camera, bộ máy xử lý ảnh mới hay việc xác nhận đủ điều kiện cho sản xuất.

Câu hỏi	Trả lời trong bản xem trước đã được xem xét
Ứng dụng khách chạy ở đâu?	Trên máy trạm Windows. Ứng dụng khách tự khởi động dịch vụ tác vụ cục bộ và trao đổi với dịch vụ qua đầu vào/đầu ra tiêu chuẩn.
Nó có thay đổi camera không?	Bản thân MCP thì không. Đọc một quy trình làm việc, chạy thử nghiệm ngoại tuyến và ghi cài đặt camera là các thao tác riêng biệt. Việc tinh chỉnh phía camera vẫn cần quy trình thiết bị được hỗ trợ và các bước xác minh đi kèm.
Có cần internet không?	Không. Truy cập MCP từ xa là một cấu hình riêng, có xác thực; xem Quyền, bảo mật và dữ liệu.

Trước khi kết nối

Cài đặt và khởi động bàn làm việc Windows như mô tả trong Cài đặt và cấu hình, rồi chạy một quy trình làm việc ngoại tuyến để biết kết quả bình thường trông như thế nào.
Quyết định những gì được phép rời khỏi máy trạm. Ứng dụng khách chuyển tiếp các kết quả công cụ mà nó nhận được, kể cả mẫu hình ảnh, tới nhà cung cấp của chính nó.
Chuẩn bị một bộ mẫu có gán nhãn kèm đáp án mong đợi. Giữ hình ảnh phát triển tách biệt với bộ xác thực cố định.
Lên kế hoạch kết nối dịch vụ trình diễn (mô phỏng) trước.

Xuất cấu hình cho ứng dụng khách

Trong ứng dụng máy tính để bàn, mở cửa sổ tinh chỉnh và dùng chức năng xuất cấu hình MCP của cửa sổ đó.
Chọn định dạng cho ứng dụng khách: JSON cho Claude hoặc TOML cho Codex.
Chọn dịch vụ thông thường hoặc dịch vụ trình diễn (mô phỏng).
Sao chép văn bản hoặc lưu lại. Tên tệp gợi ý là deyivision-mcp.

Mục được xuất có tên deyivision. Mục này chứa đường dẫn đầy đủ của dịch vụ tác vụ đã cài đặt, đối số --mcp (cùng --simulation đối với dịch vụ trình diễn) và ba biến môi trường: DEYIVISION_TUNING_INSTANCE, DEYIVISION_TUNING_DESKTOP_INSTANCE và DEYIVISION_TUNING_DATA. Mục này không bao giờ chứa mã thông báo, thông tin xác thực camera hay bất kỳ biến môi trường nào khác. Mục của dịch vụ trình diễn bỏ thư mục dữ liệu vì dịch vụ đó tự giữ dữ liệu riêng.

Cài đặt vào ứng dụng khách

Gộp mục deyivision vào cấu hình MCP của ứng dụng khách: đối tượng mcpServers trong tệp JSON của Claude, hoặc tệp TOML của Codex. Vị trí của tệp này phụ thuộc vào ứng dụng khách và phiên bản của nó; hãy làm theo tài liệu của chính ứng dụng khách.
Khởi động lại ứng dụng khách để nó đọc mục này.
Yêu cầu ứng dụng khách liệt kê các công cụ DeYiVision. Nếu không có công cụ nào xuất hiện, hãy kiểm tra đường dẫn và nhật ký của ứng dụng khách trước khi thay đổi bất cứ điều gì trong bàn làm việc.
Hãy xuất lại sau khi bạn di chuyển hoặc cài đặt lại bàn làm việc, đổi instance hoặc đổi gốc dữ liệu. Mục này lưu đường dẫn tuyệt đối.

Kiểm tra kết nối đầu tiên

Bắt đầu với dịch vụ trình diễn. Một lần gọi công cụ thành công chứng minh rằng ứng dụng khách có thể khởi chạy dịch vụ và trao đổi với nó. Lần gọi đó không vận hành camera và cũng không kiểm tra hình ảnh thực, và dịch vụ trình diễn giữ dữ liệu của mình tách biệt với dữ liệu ở chế độ thiết bị. Đừng trỏ nó tới thư mục dữ liệu của chế độ thiết bị: hai dịch vụ sẽ tranh chấp cùng một sổ ghi tác vụ.

Chỉ chuyển sang dịch vụ thông thường sau khi lần gọi với dịch vụ trình diễn đã chạy được. Danh sách công cụ không phải là bằng chứng về kết nối camera; xem Kết nối camera và thu nhận ảnh.

Lặp từng thay đổi một

Cố định bộ mẫu và các đáp án mong đợi trước lần chạy đầu tiên.
Yêu cầu ứng dụng khách kiểm tra bản sửa đổi quy trình làm việc hiện tại và kết quả mới nhất của nó. Ghi lại bản sửa đổi, cài đặt của từng nút, danh tính đầu vào, đầu ra hoặc quyết định, thời gian đã trôi qua và mọi điểm không khớp.
Thay đổi một ứng viên: một nút hoặc một tham số được hỗ trợ. Gửi một ứng viên chỉ lưu một đề xuất; việc đó không chạy ứng viên.
Chạy ứng viên trên chính những hình ảnh cố định đó. Mỗi lần chạy tiêu tốn ngân sách dùng thử PC của tác vụ; đó không phải là một lần phơi sáng camera mới hay việc ghi tham số camera.
Tự xem xét bằng chứng: hình ảnh, đầu ra, phiên bản và các trường hợp lỗi. Một hình ảnh sạch hơn vẫn có thể cho ra quyết định sai.
Giữ hoặc loại bỏ ứng viên, rồi lặp lại. Nếu trong lúc đó một người hoặc ứng dụng khách khác đã thay đổi quy trình làm việc, hãy đọc bản sửa đổi mới nhất và phần rà soát của người phụ trách trước. Bản nháp cũ không được ghi đè bản sửa đổi hiện tại, và ứng viên gắn với bản sửa đổi rà soát đã lỗi thời sẽ bị từ chối.

Xem Tạo và chạy quy trình để biết các điều khiển bản sửa đổi, gửi và chạy.

Những gì vẫn do con người kiểm soát

Ghi vào camera. Ứng dụng khách MCP không vượt qua các cơ chế kiểm soát nêu trong Job và kết quả kiểm tra. Việc ghi vào camera vẫn cần đúng thiết bị và phiên, quyền, trạng thái đủ điều kiện, đường cơ sở đã ghi và một lần đọc lại.
Quyền. Quyền truy cập của mô hình không mặc nhiên là chỉ đọc: một mô hình đã xác thực có thể có các công cụ cho phép ghi. Hãy quyết định ứng dụng khách được truy cập những gì trước khi kết nối, và xem lại những gì nó đã làm sau đó.
Kết quả không xác định. Nếu một thao tác ghi có kết quả không chắc chắn, hãy đọc biên nhận yêu cầu gốc. Đừng lặp lại thao tác ghi dưới một ID yêu cầu mới.
Nghiệm thu. Một thử nghiệm ngoại tuyến trên các hình ảnh đã lưu không chứng minh một khung hình mới sẽ hoạt động ra sao trên dây chuyền của bạn. Hãy thống nhất mẫu và giới hạn nghiệm thu trước khi đưa ra bất kỳ tuyên bố nào về vận hành.

Dữ liệu và quyền riêng tư

Ứng dụng khách gửi những gì công cụ trả về, kể cả mẫu hình ảnh, tới nhà cung cấp bạn đã chọn. Hãy xem xét trước bên nhận, quyền đối với dữ liệu và chính sách của nhà cung cấp. Tùy chọn lưu trữ ở cấp yêu cầu không phải là bảo đảm về việc lưu giữ dữ liệu của mọi bên ở phía sau.

Cấu hình đã xuất chỉ chứa đường dẫn cục bộ và tên thư mục. Đầu ra khởi động có thể chứa mã thông báo truy cập cục bộ, vì vậy đừng dán nó vào tin nhắn hỗ trợ.

Khắc phục sự cố

Triệu chứng	Kiểm tra và bước tiếp theo
Ứng dụng khách không liệt kê công cụ DeYiVision nào	Xác nhận mục đã được gộp vào đúng tệp cấu hình thực của ứng dụng khách, khởi động lại ứng dụng khách và kiểm tra lệnh có trỏ tới tệp thực thi dịch vụ tác vụ đã cài đặt hay không. Xuất lại nếu bàn làm việc đã được di chuyển.
Dịch vụ khởi động rồi bị lỗi	So sánh các biến instance và dữ liệu với bàn làm việc đang chạy. Dùng đúng cặp tương ứng, và không bao giờ dùng chung một thư mục dữ liệu giữa dịch vụ trình diễn và dịch vụ thông thường.
Đã chạy được, rồi ngừng sau khi cài đặt lại hoặc di chuyển	Mục này lưu đường dẫn tuyệt đối. Hãy xuất lại cấu hình và thay mục cũ.
Ứng viên bị từ chối vì lỗi thời	Đọc bản sửa đổi quy trình làm việc mới nhất và phần rà soát của người phụ trách, rồi đề xuất lại thay đổi.
Thao tác ghi có kết quả không xác định	Đọc biên nhận yêu cầu gốc trước khi quyết định có nên thực hiện một thao tác mới hay không.

Giới hạn của hướng dẫn này

Danh sách công cụ và tên công cụ chính xác do dịch vụ đã kết nối cung cấp và có thể thay đổi giữa các bản dựng; hãy yêu cầu ứng dụng khách liệt kê chúng. Chức năng xuất hỗ trợ định dạng Claude (JSON) và Codex (TOML); hành vi với từng phiên bản của ứng dụng khách chưa được xác nhận đủ điều kiện trong tài liệu này.

Một lần kiểm tra kỹ thuật ngày 23 tháng 9 năm 2026 trên bản dựng Windows tách biệt đã lấy được một ảnh nguồn và một ảnh đã xử lý thông qua ứng dụng khách MCP từ xa. Cả hai lần chạy đều trả về NoRead (0/1). Lần kiểm tra đã cho thấy việc bàn giao quy trình làm việc, kiểm soát bản sửa đổi và truy xuất bằng chứng; nó không xác lập tỷ lệ đọc mã vạch, khả năng tương thích với camera thực tế hay độ ổn định trong sản xuất.