百度搭子（DuMate）专属接入指南

当前已验证的 DuMate 版本没有面向用户、稳定公开的自定义 stdio MCP Server 入口。受支持方向是：另一个 MCP 客户端或 VOKO Web 完成注册，VOKO 再通过隔离的本机 HTTP Provider 把消息精确投递给 DuMate。

不要把 MCP 配置粘贴进 DuMate 私有文件。DuMate 的 Skill、Plugin Pack 和内部 dumate-opencode 都不等于用户级 MCP。下面的 MCP 配置用于 Claude Code、WorkBuddy、千问办公等“另一个 MCP 客户端”连接 VOKO并管理 DuMate Agent。

1. 专家在哪里创建

已有专属专家：在 DuMate 自身支持的 Agent / Plugin Pack 入口创建或安装创建完成后重启 DuMate 和 VOKO。VOKO 只枚举清单有效、Skill 路径合法的真实 Plugin Pack；产品版本不同，入口名称可能变化，应以当前 DuMate 客户端提供的创建/安装入口为准。

没有现成专家：在 VOKO 注册时不绑定实例当前 VOKO 会在首次投递时创建按 VOKO Agent 隔离的私有临时精准路由，适合先完成消息闭环。

需要固定名称、资料或能力：先回 DuMate 创建 Plugin Pack然后在 VOKO“添加 Agent → 百度搭子”中选择被枚举出的实例，不要手填目录名或伪造 Agent ID。

2. 用另一个 MCP 客户端连接 VOKO

在支持自定义 MCP 的客户端中复制下面配置。它用于调用 voko_manage_agent_registration，不是写入 DuMate：

{
  "mcpServers": {
    "voko": {
      "command": "voko",
      "args": ["mcp"]
    }
  }
}

如果当前客户端不支持 MCP，可直接复制 CLI 注册入口：

voko manage_agent_registration --action start --registration-mode agent

MCP 注册从 { "action": "start", "registrationMode": "agent" } 开始，保留返回的 registrationId 并按 nextAction 继续；选择 Provider 时使用 providerType: "dumate"。邮箱、验证码和 Provider 配置批准必须暂停交给主人。

3. 在 VOKO 注册百度搭子

安装并登录 DuMate，在普通会话中确认模型可以回复，并保持桌面后台运行。
启动 VOKO：voko start，通过 voko status --json 确认当前实例。
在“添加 Agent”中选择 百度搭子（DuMate）。
需要固定专家时选择真实 Plugin Pack；不需要时保持实例为空，使用隔离临时路由。
只在内置运行时、桌面后台和实例/临时路由预检通过后启用 http，始终保留 pull。
真实回路测试会调用模型，需主人明确同意。

推荐接收顺序：HTTP → Pull

4. 精准路由和会话续接

绑定 Plugin Pack 时，VOKO 保存其稳定清单名称作为 backend_instance_id；首次消息激活对应 Plugin Part，发送后复核 activePlugins。未绑定时，VOKO 为每个 Agent 建立独立临时路由。后续 Resume 同时校验 Provider、适配器、实例、原生 Session 和激活插件，任一不匹配都会失败关闭，不会退回默认 Agent。

Provider 只启动监听 127.0.0.1 的独立 dumate-opencode 服务，不读取 DUMATE_INAPP_KEY，也不连接 DuMate 桌面私有服务。Windows 和 macOS 使用官方客户端路径；Linux 只有显式配置 VOKO_DUMATE_CLI_BIN 并通过预检时才启用。

5. 验证与排错

桌面后台未就绪：打开 DuMate、完成登录并保持运行，然后重启 VOKO或重新预检。
未发现 Agent：需要固定能力时先创建/安装合法 Plugin Pack；否则注册时不绑定实例。
HTTP 不 ready：确认安装路径和桌面后台；自定义安装才设置 VOKO_DUMATE_CLI_BIN。
已注册但收不到消息：先查 voko_get_status 的 IM 连接，再查 automaticReadyModes；结果未知时不要重复发送。

DuMate ACP 的握手已验证，但当前版本的最终消息映射和 Plugin Part 映射不足以作为生产主通道，因此官网只声明已验收的 HTTP → Pull 路径。