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

在 Reasonix 中接入

用 Reasonix v1.19.3 Windows 桌面版的图形界面添加点签 MCP。凭据放在本机环境变量中,聊天和 JSON 都不出现真实 Secret。

本页目录

实测状态

Reasonix:已实测

远程连接、精确五工具、合同列表和合同详情只读查询均已验证。本轮没有创建、撤销、上传文件或发送通知。

本页截图由项目验收人员于 2026-08-03 在 Reasonix v1.19.3 Windows 桌面版中本机实测采集。 画面不是生成图,配置使用环境变量占位符,不包含 APP_SECRET、完整手机号、业务编号或签署链接。

1. 先把企业凭据存在 Reasonix 本机

在 Windows 文件资源管理器地址栏输入 %APPDATA%\reasonix,用记事本打开.env。保留原有内容,另起两行追加下面两项;没有这个文件时再新建。填入企业自己的测试凭据:

%APPDATA%\reasonix\.env
DIANQIAN_MCP_APP_ID=<填写测试 APP_ID>
DIANQIAN_MCP_APP_SECRET=<填写测试 APP_SECRET>

保存后完全退出并重新打开 Reasonix,让客户端重新读取变量。不要把真实值发到聊天,也不要直接写进下面的 JSON。

2. 在设置里添加点签 MCP

打开 设置 → MCP 与工具 → 添加服务器,选择“快速安装”,粘贴完整 JSON, 然后点击“添加并连接”。

Reasonix MCP 配置
{
  "mcpServers": {
    "dianqian-contract": {
      "type": "http",
      "url": "https://mcp.fs-url.com/mcp",
      "headers": {
        "X-Dianqian-App-Id": "${DIANQIAN_MCP_APP_ID}",
        "X-Dianqian-App-Secret": "${DIANQIAN_MCP_APP_SECRET}",
        "X-Dianqian-Environment": "sandbox"
      },
      "auto_start": true
    }
  }
}
Reasonix v1.19.3 的 MCP 与工具页面使用环境变量占位符添加点签服务
图 1:Reasonix v1.19.3 真实“添加 MCP 服务器”界面,2026-08-03 本机采集。截图只显示变量名,不显示企业凭据。

3. 确认已经接通

回到 MCP 列表。正常时会看到 1 个服务器已连接、0 个异常、5 个工具、0 个不可用。 展开服务后再核对工具名称:

应当恰好出现这五个工具
dianqian_find_signers
dianqian_create_contract
dianqian_list_contracts
dianqian_get_contract
dianqian_revoke_contract
Reasonix v1.19.3 显示 dianqian-contract 已连接并发现五个工具
图 2:真实连接结果,Reasonix 显示服务已连接且五个工具均可用。截图于 2026-08-03 本机采集。

4. 用两句话做安全查询

先查列表。这个操作不会创建或撤销合同:

这样说就够了
列出最近 3 份点签合同,只告诉我标题和状态,别创建或撤销。

能返回合同列表,或者明确告诉你列表为空,都表示已经接通。空列表只说明当前企业还没有通过点签 MCP 记录的合同。

再选一份测试合同查详情,明确要求隐藏编号、手机号和链接:

这样说就够了
看看“劳动合同”的详情,只说签署状态和原文件是否可读,别输出编号、手机号或链接。
Reasonix v1.19.3 用一句短话查询劳动合同的状态和原文件可读性
图 3:真实只读查询。结果只保留签署状态和文件是否可读,不展示编号、手机号或链接。2026-08-03 本机采集。

发合同时,文件按这个顺序交

本轮 Reasonix 实测只覆盖连接和只读查询,还没有证明聊天里的 PDF 能直接交给远程 MCP。 后续发合同时可以先拖入测试 PDF;Agent 拿不到原文件,就让它返回一次性浏览器上传链接。 上传页不会再次询问 APP_ID 或 APP_SECRET。

以前用过的原 PDF,也可以不再上传

同企业、同环境的合格旧合同原 PDF 可以用于新合同,系统会复制成新合同自己的文件。 签署完成后的 PDF 和普通附件不能当作新的签署原件。详细规则见文件处理指南

点签开发验收时使用过的本地 Skill 或脚本,不是连接 MCP 后自动附带的功能,普通用户不需要下载安装。

连不上时按顺序检查

先完全退出 Reasonix,再按下面顺序检查,不要反复修改同一份配置。

  1. 确认 Reasonix 已完全退出并重开,环境变量才会重新加载。
  2. 确认 URL 是 https://mcp.fs-url.com/mcp,末尾没有斜杠。
  3. 确认两个环境变量都有值,JSON 中保留的是 $${变量名} 写法。
  4. 看到服务已连接后,再确认五个工具都出现;只有连接状态还不算验收完成。