文档目录
点签 MCP/在 QoderWork 中接入
VERIFIED CLIENT · WINDOWS当前文档:测试环境

在 QoderWork 中接入

基于 QoderWork 0.9.12 Windows 客户端真实界面整理。通过自定义连接器导入 JSON,启用后先核对五个工具,再查一次合同列表。

本页目录

实测状态

QoderWork:已实测

远程连接、五工具发现、合同列表与签前 / 签后 PDF 正文只读流程均已验证。

以下截图来自真实 QoderWork 界面,配置示例仅使用占位符,不包含企业凭据。

1. 打开自定义连接器入口

在左侧依次进入:扩展 → 连接器 → 添加 → 粘贴 JSON 配置

QoderWork 连接器页面打开添加菜单并选择粘贴 JSON 配置
图 1:QoderWork 自定义 MCP 连接器入口。

2. 导入点签配置

复制完整 JSON,只替换两个尖括号中的测试凭据占位符。

QoderWork 连接器配置
{
  "mcpServers": {
    "dianqian-contract": {
      "type": "streamable-http",
      "url": "https://mcp.fs-url.com/mcp",
      "headers": {
        "X-Dianqian-App-Id": "<填写测试 APP_ID>",
        "X-Dianqian-App-Secret": "<填写测试 APP_SECRET>",
        "X-Dianqian-Environment": "sandbox"
      }
    }
  }
}
QoderWork JSON 导入窗口中填写点签 MCP 配置
图 2:粘贴 JSON 后点击导入。截图中的敏感值为占位符。
  • type 必须是 streamable-http
  • URL 末尾不要加 /
  • 三个 Header 缺一不可。
  • 不需要 Node.js、NPX 或本地点签程序。

3. 确认连接已启用

导入后切换到“已安装”,确认 dianqian-contract状态点为绿色、开关已启用。

QoderWork 中 dianqian-contract 连接器已安装并启用
图 3:连接器已安装并启用。

展开连接器详情,人工核对工具名称和数量恰好为 5 个:

五个点签工具
dianqian_find_signers
dianqian_create_contract
dianqian_list_contracts
dianqian_get_contract
dianqian_revoke_contract
QoderWork 展开点签连接器后显示五个工具
图 4:请在连接器详情中直接核对,不要只听 Agent 复述工具名称。

4. 确认已经接通

确认上面的 5 个工具都出现后,新建 QoderWork 任务并发送:

这样说就够了
看看最近 5 份合同。只查,不要修改。

返回合同列表,或者明确告诉你当前列表为空,都表示已经接通。空列表只说明当前企业还没有 通过点签 MCP 记录的合同。只有绿色状态但查不了列表时,先检查连接开关、URL 和三个 Header, 再新建任务重试。

创建并发起测试合同

连接通过后可使用下面的模板。真正发起前要再次核对合同标题、PDF 和签署人。

这样说就够了
用这个 PDF 发一份测试合同。发起前先给我确认。
先拖文件,传不出去再打开链接

先把 PDF 直接拖进对话。QoderWork 传不出原文件时,Agent 应改用一次性浏览器上传链接,上传页不再输入 APP 凭据。 同企业、同环境的合格旧合同原 PDF 也可复用;签后 PDF 和附件不可以。 真正发起前,请再次核对标题、签署文件、普通附件和签署人。 签署 PDF 和普通附件的一次性上传都已在测试环境上线;直接拖入聊天是否可用仍取决于 QoderWork。