聚水潭个人连接器

一个聚水潭连接器，默认使用 ERP，按需兼容分销。为 AI 和业务系统提供本人登录、页面探索、查询和业务操作；不以预置 Q/W 清单限定业务范围。支持 Windows 本机和 Linux 多员工远程部署，对接方只需配置一套 MCP、一个服务地址和本人的调用授权。

统一入口：GitHub 仓库；安装包入口：最新 Release。

把本仓库链接交给 AI，并告诉它：

请读取 https://github.com/ditingchenming-sys/jst-personal-connector 中的《AI接入说明.md》，在当前环境安装聚水潭个人连接器并配置 MCP，保留我的其他配置，再引导我本人登录。

AI 客户端通过 MCP stdio 使用工具。本机模式调用本机组件；远程模式通过 stdio 适配器连接 HTTPS 员工服务，不在员工电脑保存聚水潭 Cookie。仅接受远程 MCP URL 的客户端仍需单独适配；HTTPS 员工服务地址不是 Streamable HTTP MCP 地址。

当前能力

当前版本 0.7.0，提供 18 个 MCP 工具。

通用写入已提供单对象单请求的契约执行路径，支持 JSON、表单和已解码的固定回调请求；它不证明聚水潭跨单据、多步骤事务。复杂批次须先核实提交边界，不能伪造整批原子性。预置 W 快捷方式未适配时应使用通用探索，不能据此判断该业务被禁止。具体接口仍需来源、当前真实数据、业务校验及回查依据；复杂隐藏状态和未适配风控按实际协议补齐。

登录页只负责本人登录授权、验证码、连接状态和退出，完成后即可关闭。后续查询和条件交互在 AI 或业务系统中完成。

工作台已经通过钉钉等方式登录时，由工作台可信后端接入平台身份授权协议，员工继续平台授权后直接连接本人聚水潭。平台登录与聚水潭登录仍分别验证；不能只传员工ID、复用其他员工令牌或把钉钉Cookie当聚水潭Cookie。未配置平台身份接入的独立部署继续使用原有员工密码方式。升级包不会自动取得任意工作台的登录身份，对接方须配置可信后端及授权入口。

ERP 和分销是同一个连接器里的两个业务板块。业务人员平时只连接本人ERP；确有分销任务时，同一套工具指定 area="drp"，连接器自动通过已验证的本人ERP接续分销，成功后直接执行业务请求并复用有效会话。无需业务人员再切登录板块、点接续或输入分销密码。普通ERP使用不会加载分销。内部仍分别保存会话、契约和执行账本，不把ERP Cookie直接发送到分销域；一个远程进程和一个HTTPS域名即可承载两者。

工作台、市场和 AI 配置只显示一个“聚水潭个人连接器”；分销作为兼容能力，不新增第二张卡片或第二组 MCP 工具。旧版独立分销部署的数据和绑定保留，迁移时不得按重名员工自动合并；见统一接入与旧版本兼容。

页面有多个域名或嵌套应用由连接器在后台处理，业务人员不需要更换网址或连接器。页面来源、实际请求、当前账号和保存的契约共同核验；常用快捷查询不构成功能清单上限。工程验证涵盖多域浏览器与持久复用闭环，具体平台角色、未识别的认证流程和完整官方前端启动仍按真实协议核实，不以“已连接”替代数据读取成功。

分销页面探索与真实接口认证分开：页面脚本不接触主会话凭据，实际请求由连接器后台使用本人已核身份认证。需要额外认证协议时由连接器核对适配，无需业务人员复制登录态。

独立操作确认页只确认当前预览；已有可信系统确认无需重复打开。AI 持有的调用令牌不能自行批准写入。本版工程验证使用隔离数据与受控服务，不代表全部真实业务接口已验收，也不会为发布而创建真实单据。

Related MCP server: MCP PJe Pernambuco

安装与使用

• AI 接入说明：给 AI 的安装、配置和使用流程。

• 安装说明：Windows、Linux、MCP 配置及更新。

• 通用探索与接口复用：未预置页面与查询的对接方式。

本项目是独立实现，不代表聚水潭官方认证或平台上架。GitHub 仅分发代码、说明和安装包，不接收使用者的密码、Cookie、业务数据或加密运行目录。

维护与更新

更新仓库说明后，AI 再次读取链接即可获取新说明。本地已安装的程序不会随仓库修改自动升级；发布新版本后按 安装说明 更新并重启相关 MCP。保留本机运行目录和原有密钥，更新不需要把登录资料交给维护者。

开发环境：Python 3.11+。使用 uv sync --extra dev 安装依赖，uv run pytest -q 执行离线和受控回环测试，uv build --wheel 构建 wheel。测试不使用真实 ERP 账号。

本项目采用 MIT 许可证。源码、wheel 和完整分发包均附许可证全文；复制或分发时请保留版权及许可声明。