說明文件
透過 MCP 連接 AI 用戶端
本頁內容
透過 MCP 將 AI 用戶端連接到工作台，然後一次只做一項變更，逐步迭代工作流程，而不必把相機的控制權交給它。
MCP 帶來了什麼
MCP（Model Context Protocol）讓 AI 用戶端能夠呼叫工作台所支援的工具：檢視工作流程、提出候選方案，並讀回實驗證據。這是驅動同一個任務服務的第二種方式，並不會新增相機驅動程式、新的影像引擎，也不構成量產資格確認。
| 問題 | 已審閱預覽版中的答覆 |
|---|---|
| 用戶端在哪裡執行？ | 在 Windows 工作站上。用戶端會自行啟動本機的任務服務，並透過標準輸入／輸出與它通訊。 |
| 它會變更相機嗎？ | 它本身不會。讀取工作流程、執行離線實驗與寫入相機設定，是各自獨立的操作。相機端的調校仍須依照所支援的裝置操作流程及其驗證步驟進行。 |
| 需要網際網路嗎？ | 不需要。遠端 MCP 存取是另一組須經身分驗證的設定；請參閱權限、安全與資料。 |
連線之前
- 依照安裝與設定的說明，安裝並啟動 Windows 工作台，並先執行一個離線工作流程，讓您知道正常的結果是什麼樣子。
- 決定哪些資料可以離開這台工作站。用戶端會把收到的工具結果（包括影像樣本）轉送給它自己的供應商。
- 準備一組已標註的樣本集，並附上預期答案。請將開發用影像與已凍結的驗證集分開。
- 規劃先連接演示（模擬）服務。
匯出用戶端設定
- 在桌面程式中開啟調校視窗，使用其中的 MCP 設定匯出功能。
- 選擇用戶端格式：Claude 用 JSON，Codex 用 TOML。
- 選擇一般服務或演示（模擬）服務。
- 複製文字，或將它儲存為檔案。建議的檔名是
deyivision-mcp。
匯出的條目名稱為 deyivision。其中包含已安裝任務服務的完整路徑、--mcp 引數（演示服務另加 --simulation），以及三個環境變數：DEYIVISION_TUNING_INSTANCE、DEYIVISION_TUNING_DESKTOP_INSTANCE 與 DEYIVISION_TUNING_DATA。其中絕不會包含權杖、相機憑證或任何其他環境變數。演示用條目不含資料夾路徑，因為該服務自行保存其資料。
安裝到用戶端
- 將
deyivision項目合併到用戶端的 MCP 設定中：Claude 的 JSON 檔案裡的mcpServers物件，或 Codex 的 TOML 檔案。該檔案的位置取決於用戶端及其版本，請依照用戶端自己的文件操作。 - 重新啟動用戶端，讓它讀取該項目。
- 請用戶端列出 DeYiVision 工具。若一個也沒有出現，請先檢查路徑與用戶端的記錄檔，再變更工作台中的任何內容。
- 移動或重新安裝工作台、變更執行個體，或變更資料根目錄之後，請重新匯出。該項目儲存的是絕對路徑。
檢查首次連線
先從演示服務開始。一次工具呼叫成功，可以證明用戶端能夠啟動該服務並與它通訊；但這並不會用到相機，也不涉及實際的影像檢測，而且演示服務的資料與裝置模式的資料彼此分開。請不要讓它指向裝置模式的資料夾：兩個服務會爭用同一份任務帳本。
演示呼叫成功之後，再改用一般服務。看得到工具清單，並不是已連上相機的證據；請參閱相機連線與影像擷取。
一次只改一處，逐步迭代
- 在第一次執行之前，先固定樣本集與預期答案。
- 請用戶端檢視目前的工作流程修訂版及其最新結果。記錄修訂版、節點設定、輸入識別資訊、輸出或判定、耗時，以及任何不一致之處。
- 每次只做一個候選方案：變更一個受支援的節點或參數。提交候選方案只會儲存一份提案，不會執行它。
- 在同一組固定影像上執行該候選方案。執行會消耗該任務的 PC 試跑額度；這不是新的相機曝光，也不會寫入相機參數。
- 請親自檢視證據：影像、輸出、版本與失敗案例。影像看起來比較乾淨，仍可能得出錯誤的判定。
- 保留或捨棄該候選方案，然後重複上述步驟。如果在這段期間有人或其他用戶端變更了工作流程，請先讀取最新的修訂版及其人工審閱內容。舊草稿不得覆寫目前的修訂版；與過期審閱修訂版相關聯的候選方案會被拒絕。
關於修訂版、提交與執行的控制項，請參閱建立並執行工作流程。
仍由人工掌控的事項
- 寫入相機。MCP 用戶端無法繞過作業與檢測結果中的管控。寫入相機仍然需要正確的裝置與工作階段、足夠的權限、符合條件的狀態、已記錄的基準，以及一次讀回。
- 權限。模型存取本質上並非唯讀：通過驗證的模型可能擁有可寫入的工具。連接用戶端之前，先決定它可以觸及的範圍，事後再檢視它做了什麼。
- 結果不明。若寫入的結果不確定，請讀取原始請求回執。不要以新的請求 ID 重複寫入。
- 驗收。針對已儲存影像所做的離線實驗，並不能證明新的影格在您的產線上會有什麼表現。在提出任何有關實際運作的主張之前，請先約定樣本與驗收門檻。
資料與隱私
用戶端會把工具回傳的內容（包括影像樣本）傳送給您所選的供應商。請先確認接收方、資料權利與供應商的政策。請求層級的儲存偏好設定，並不能保證每一個下游單位的資料保存方式。
匯出的設定只包含本機路徑與資料夾名稱。啟動輸出可能含有本機存取權杖，因此不要把它貼到寄給技術支援的訊息中。
疑難排解
| 症狀 | 檢查項目與下一步 |
|---|---|
| 用戶端沒有列出任何 DeYiVision 工具 | 確認該項目已合併到用戶端實際使用的設定檔，重新啟動用戶端，並檢查指令是否指向已安裝的任務服務可執行檔。若工作台已移動，請重新匯出。 |
| 服務啟動後隨即失敗 | 將執行個體與資料變數，與執行中的工作台進行比對。請使用相符的一組，切勿讓演示服務與一般服務共用同一個資料夾。 |
| 原本可用，重新安裝或移動後就失效 | 該項目儲存的是絕對路徑。請重新匯出設定，並取代舊項目。 |
| 候選方案因已過期而被拒絕 | 讀取最新的工作流程修訂版及其人工審閱內容，然後重新提出該項變更。 |
| 寫入的結果不明 | 請先讀取原始請求回執，再決定是否適合進行新的操作。 |
本指南的限制
確切的工具清單與工具名稱，由所連接的服務提供，不同建置之間可能有所變動；請讓用戶端列出它們。匯出涵蓋 Claude（JSON）與 Codex（TOML）兩種格式；此處並未針對各用戶端版本下的行為做過資格確認。
2026 年 9 月 23 日，在一個隔離的 Windows 建置版本上做了一次工程檢查，透過遠端 MCP 用戶端取回一張來源影像與一張處理後的影像。兩次執行都回傳了 NoRead (0/1)。這次檢查展示了工作流程交接、修訂版控管與證據讀取，但並未確立條碼讀取率、與實體相機的相容性，或量產穩定性。