本项目采用「小河狸工作室非转售许可 1.0」—— 个人使用与企业内部使用免费（含内部办公、财务与会计处理、内部系统集成）； 对外销售、集成进收费产品或服务、托管 / SaaS / 代运营、以及向第三方交付成果或提供服务，须事先取得书面授权。 许可全文见 LICENSE。商业授权：https://littlebeaver.top
把金蝶云社区（vip.kingdee.com）的官方 MCP 接进你的 AI 客户端。 之后遇到金蝶的问题，不用再开浏览器翻论坛 —— 直接在对话里问，AI 去社区里找原文并给出处。
一句话：AI 能查社区了，但你的令牌不会出现在任何配置文件里。
用金蝶的人都有这个循环：报错弹窗 → 看不懂 → 百度/搜社区 → 翻十几页帖子 → 找到一条 2021 年的回答 → 还不知道适不适用于自己的版本。
社区其实有官方 MCP（AI 可以直接检索社区内容），但官方接法要求把个人令牌明文写进
mcp.json：
"headers": { "Authorization": "Bearer eyJhbGciOi..." }这个文件会被截图发群、被网盘同步、被误提交、被发同事排障。令牌 = 你身份的凭证，泄一次就得去重置。
本技能把这两件事拆开：配置文件里只有「用哪个 Python 跑哪个脚本」，令牌用
Windows DPAPI 加密存在 ~/.workbuddy/kingdee/club_token.bin，运行时才读进内存。
| 你说 | AI 做什么 |
|---|---|
| 「金蝶云星空结账提示『本期存在未记账凭证』怎么办？」 | 搜社区 → 给出处理步骤 + 原文链接 |
| 「单据转换规则在哪配？步骤说下」 | 找官方操作文档，按原文复述，不凭记忆编 |
| 「这个字段是什么意思？」 | 查字段说明与相关帖子，带出处 |
| 「升级到 V9 有没有已知问题？」 | 搜发版说明、补丁公告、踩坑帖 |
| 「社区里有人遇到过吗？」 | 返回帖子标题 + 摘要 + 链接，你自己决定点哪个 |
它不做什么：不碰你的账套、不读你的 Excel、不在社区发帖评论。只检索公开内容。 要查自己账套的数据，用 金蝶云星空数据导出。
能取到「摘要 + 链接」还是「整篇正文」，取决于服务端开放了哪些工具 —— 用
python club_cli.py --tools看实时清单，以它为准。
令牌窗口里直接给了社区网址和三步路径：
社区网址 https://vip.kingdee.com [复制] [打开]
① 打开个人主页 → ② 编辑个人资料 → ③ 新建令牌
点「打开」直接跳浏览器，点「复制」把网址拿走。
AI 收到这句就会自己跑：
python club_cli.py --setup这一条命令做两件事，用户不用再敲任何命令：
- 弹窗录令牌 —— 屏幕上弹出一个窗口：社区网址 → 三步路径 → 一个令牌输入框， 底部只有「保存 / 取消」。粘贴令牌后点「保存」——保存时会自动验证， 令牌不对会弹窗告诉你（也可以选择先存着，回头再换）。
- 连接自检 —— 真实握手一次（
initialize+tools/list），打印协议版本与可用工具。
到此就结束了 —— 不用去任何设置页点按钮，也不用重启客户端。
「金蝶云星空结账提示未记账凭证怎么办？」—— AI 会自己去社区检索并给出处
（内部走 club_cli.py --search "关键词"，自动挑服务端提供的搜索类工具，服务端改名也不怕）。
可选：想让工具原生出现在客户端的工具列表里
python club_cli.py --setup --with-mcp然后：连接器管理页（左侧栏「连接器」或输入框右侧的连接器入口）→ 右上角「自定义连接器」
→ 找到 kingdee-club → 确认启用。也可直接编辑 ~/.workbuddy/mcp.json。
- 配置保存后即时生效，一般不用重启（老版本需重启一次）；
- 在对话里展开「正在连接 MCP 服务」能看到「已连接数 / 服务总数」；
- 若弹出授权确认，点一下即可 —— 客户端对「要启动本地进程」的安全确认，只有人能做。
不做这一步也完全能用：注册成 MCP 只是让工具在列表里露脸，检索能力完全一样。
令牌用 Windows 系统加密（DPAPI） 保存在 ~/.workbuddy/kingdee/club_token.bin：
绑当前 Windows 用户，同机其它用户读不出，拷到别的机器解不开；
不写明文、不进对话、不落日志，只显示尾 4 位。
mcp.json → 只有「哪个 Python 跑哪个脚本」，没有任何机密
club_token.bin → DPAPI 密文（绑当前 Windows 用户）
运行期 → club_bridge.py 在内存里拼 Authorization 头
对客户端：它就是个标准 stdio MCP 服务（initialize / tools/list / tools/call 一个不少）。
对社区：它是一次标准 HTTP MCP 会话（Streamable HTTP + SSE，会话 ID 自动维护）。
行为完全一样，只是令牌不落盘。
官方 HTTP 直连写法仍然支持（如果你真要用），--check 会明确告警「该配置里有明文令牌」。
| 命令 | 作用 |
|---|---|
python club_cli.py --setup |
一步接入：弹窗录令牌 → 自检（AI 用这个，默认不写 MCP 配置） |
python club_cli.py --setup --with-mcp |
再把 MCP 配置写进客户端（可选，需在连接器页确认一次） |
python club_cli.py --search "关键词" |
一句话检索社区（自动挑搜索工具，日常主力命令） |
python setup_token.py |
令牌录入窗口（DPAPI 加密） |
python setup_token.py --check / --delete / --console |
查状态 / 删除 / 文字向导 |
python club_cli.py --check |
本地状态（令牌、有效期、MCP 配置），不联网 |
python club_cli.py --verify |
真实握手自检 |
python club_cli.py --tools [--json] |
列出工具与参数 |
python club_cli.py --call <工具> --args '{...}' |
精确调用某个工具 |
python club_cli.py --mcp-config [--client X] |
生成配置片段 |
python club_cli.py --install-mcp [--dry-run] |
合并写入配置（自动备份） |
python club_cli.py --doctor |
六步体检 |
退出码：0 成功 ｜ 2 缺令牌 ｜ 3 令牌被拒 ｜ 4 网络 ｜ 5 服务端/协议 ｜ 6 工具错误
｜ 7 需在客户端里手动配置 ｜ 10 用户取消（什么都没改）。
| 项目 | 说明 |
|---|---|
| 网络 | 只连 vip.kingdee.com/api/mcp（或你指定的 --base-url）；不查更新、不报遥测 |
| 写文件 | 只写 club_token.bin 和（--install-mcp 时的）MCP 配置；改配置前自动备份 |
| 读文件 | 不读账套、Excel、发票；不碰 credentials.bin |
| 浏览器 | 令牌窗口的「打开」按钮调起默认浏览器访问社区首页（仅用户点击时）；「复制」写入剪贴板 |
| 日志 | 只写 stderr，且不含令牌；stdout 留给 MCP 协议 |
| 子进程 | 仅在当前 Python 缺 tkinter 时，查找本机已装的另一个 Python 开窗（不装任何东西） |
Q：提示 401 Malformed token？
令牌粘错或已过期。重跑 setup_token.py，粘完点「保存」——保存时会自动验证，不通会直接弹窗告诉你。
Q：一定要去点「信任」吗？
不用。 默认流程只录令牌 + 自检，agent 用 --search 直接查社区，不碰任何设置页。
只有你想让工具出现在客户端工具列表里，才需要到「连接器管理页 → 右上角自定义连接器」确认一次。
Q：换过 Python 之后 MCP 起不来了？
配置里记的是旧解释器路径。重跑 python club_cli.py --install-mcp。
Q：公司网络要走代理？
设 HTTPS_PROXY；本机调试 mock 时把 127.0.0.1 加进 NO_PROXY。
Q：支持 macOS / Linux 吗？
桥和 CLI 是纯标准库、跨平台；但加密存储只支持 Windows（DPAPI）。
其它平台用环境变量 KINGDEE_CLUB_TOKEN（不落盘，但会进进程环境）。
更多报错对照见 references/error-playbook.md。
requirements.txt 里只有注释 —— 零第三方包。
MCP 官方 SDK 会拖进 pydantic / anyio / httpx 一串依赖，在很多财务同事的电脑上（受控内网、装过别家 Python、
pip 源不通）根本装不上。而本技能真正需要的只有「发 JSON、读 JSON/SSE」，
标准库的 urllib + json + ctypes（DPAPI）就够了。
小河狸工作室 LittleBeaverStudio · https://littlebeaver.top