su-planning-office/mcp

MCP 连接器（本包附带的配置与说明）

本目录只放配置模板与使用说明，不含任何凭据。

文件	用途
mcp.servers.example.json	推荐的 MCP 服务器定义（地址、超时、${VAR} 占位符），供迁移或参考
connectors-recommended.md	推荐清单：优先级、用途、启用方式、暂不建议项

在 WorkBuddy 中启用（推荐路径）

这些连接器已经内置在 WorkBuddy 里——connectors/default/mcp.json 中存在对应的 connector:* 条目，默认 disabled: true。正确做法：

1. 打开【连接器】面板，搜索连接器名称（如"腾讯文档"）；
2. 点击启用，按提示在浏览器完成 OAuth 授权；
3. 授权后回到会话即可调用其工具。

⚠️ 不要手改 ~/.workbuddy/mcp.json 里的令牌字段。OAuth 类连接器的凭据由宿主下发， 手写常导致 no_token / 假 502。排错见 Skill tencent-docs-mcp。

在 DSH（DeepSeek Harness）中启用

DSH 不读取 WorkBuddy 的连接器面板。若要迁移，把 mcp.servers.example.json 中需要条目的 mcpServers 合并进 DSH 的 MCP 配置，并按需去掉 disabled 字段；带 ${VAR} 的项先设置环境变量。

凭据与环境变量

• 不放令牌：本目录任何文件都不得写入 access token、API key、Cookie。
• tencent-map 需要 TENCENT_MAP_KEY（腾讯位置服务控制台申请）。
• 其余 OAuth 连接器由面板授权，无需手工填写。

与 Skill 的配合

• 腾讯文档 → Skill skills/tencent-docs-mcp
• 腾讯问卷 → Skill skills/tencent-survey
• 主体工作流（策划书、预算、通知、纪要、新闻稿、总结、PPT 大纲）→ Skill skills/su-planning-office