文档
通过 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)。该检查演示了工作流交接、修订版控制和证据读取；但并未确立条码读取率、与真实相机的兼容性或生产稳定性。