本项目采用「小河狸工作室非转售许可 1.0」—— 个人使用与企业内部使用免费（含内部办公、财务与会计处理、内部系统集成）； 对外销售、集成进收费产品或服务、托管 / SaaS / 代运营、以及向第三方交付成果或提供服务，须事先取得书面授权。 许可全文见 LICENSE。商业授权：https://littlebeaver.top

金蝶云社区问答 Skill

把金蝶云社区（vip.kingdee.com）的官方 MCP 接进你的 AI 客户端。 之后遇到金蝶的问题，不用再开浏览器翻论坛 —— 直接在对话里问，AI 去社区里找原文并给出处。

一句话：AI 能查社区了，但你的令牌不会出现在任何配置文件里。

它到底解决什么问题

用金蝶的人都有这个循环：报错弹窗 → 看不懂 → 百度/搜社区 → 翻十几页帖子 → 找到一条 2021 年的回答 → 还不知道适不适用于自己的版本。

社区其实有官方 MCP（AI 可以直接检索社区内容），但官方接法要求把个人令牌明文写进 mcp.json：

"headers": { "Authorization": "Bearer eyJhbGciOi..." }

这个文件会被截图发群、被网盘同步、被误提交、被发同事排障。令牌 = 你身份的凭证，泄一次就得去重置。

本技能把这两件事拆开：配置文件里只有「用哪个 Python 跑哪个脚本」，令牌用 Windows DPAPI 加密存在 ~/.workbuddy/kingdee/club_token.bin，运行时才读进内存。

Related MCP server: kb-agent-platform

能问什么

它不做什么：不碰你的账套、不读你的 Excel、不在社区发帖评论。只检索公开内容。 要查自己账套的数据，用 金蝶云星空数据导出。

能取到「摘要 + 链接」还是「整篇正文」，取决于服务端开放了哪些工具 —— 用 python club_cli.py --tools 看实时清单，以它为准。

🚀 怎么用：用户只回一句话，剩下的 AI 干

1. 拿到令牌（窗口里就能拿）

令牌窗口里直接给了社区网址和三步路径：

社区网址  https://vip.kingdee.com   [复制] [打开]
          ① 打开个人主页 → ② 编辑个人资料 → ③ 新建令牌

点「打开」直接跳浏览器，点「复制」把网址拿走。

2. 告诉 AI「令牌准备好了」

AI 收到这句就会自己跑：

python club_cli.py --setup

这一条命令做两件事，用户不用再敲任何命令：

1. 弹窗录令牌 —— 屏幕上弹出一个窗口：社区网址 → 三步路径 → 一个令牌输入框， 底部只有「保存 / 取消」。粘贴令牌后点「保存」——保存时会自动验证， 令牌不对会弹窗告诉你（也可以选择先存着，回头再换）。

2. 连接自检 —— 真实握手一次（initialize + tools/list），打印协议版本与可用工具。

到此就结束了 —— 不用去任何设置页点按钮，也不用重启客户端。

3. 之后直接问

「金蝶云星空结账提示未记账凭证怎么办？」—— 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

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 会明确告警「该配置里有明文令牌」。

📋 命令表

退出码：0 成功 ｜ 2 缺令牌 ｜ 3 令牌被拒 ｜ 4 网络 ｜ 5 服务端/协议 ｜ 6 工具错误 ｜ 7 需在客户端里手动配置 ｜ 10 用户取消（什么都没改）。

🔒 安全边界

❓ 常见问题

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