workbuddy 通过统一 mcp 协议抽象跨平台连接器，预置腾讯文档、飞书等已审计连接器，支持微信扫码一键启用；同时允许通过 mcp.json 手动配置或 skillhub 一键导入自定义 mcp server，实现自然语言驱动的多平台协同调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 处理跨平台连接器的核心逻辑是统一抽象为 MCP（Model Context Protocol）标准协议，不区分平台类型，只按能力接口契约调用——腾讯文档、飞书、QQ邮箱、乐享知识库甚至自建 HTTP 或 stdio 模式 MCP Server，在 WorkBuddy 内部都表现为同一套「工具发现→授权→调用→返回」流程。
平台预置连接器：开箱即用，无需配置
WorkBuddy 已内置适配国内主流办公平台的 MCP 连接器，全部预编译、预验证、预授权绑定路径。
在设置界面点击「连接器」→「启用服务」，列表中显示的腾讯文档、QQ邮箱、乐享知识库、TAPD、飞书等图标，均为已通过腾讯云安全审计的 MCP 客户端封装体。
启用时只需微信扫码完成 OAuth 2.0 授权，WorkBuddy 会自动协商 MCP 版本（当前默认 v1.3）、选择最优传输模式（HTTP 优先，失败降级为 stdio），并缓存会话凭证至本地加密存储区。
【必须完成微信扫码授权，否则连接器无法获取长期访问令牌】
启用后，你在对话中说“把这份周报同步到腾讯文档”，AI 会直接调用腾讯文档连接器的 mcp://write 接口；说“读取飞书群最新5条未读消息”，则自动路由至飞书连接器的 mcp://read 接口——你不需要知道背后是哪个平台，WorkBuddy 自动匹配最合适的连接器。
自定义 MCP Server：支持任意平台接入
如果你有私有部署的飞书机器人 API、内部 OA 系统的 REST 接口、或 SkillHub MCP 广场下载的 GitHub 仓库分析器，都可以作为 MCP Server 接入 WorkBuddy。
方法一：通过 mcp.json 手动配置
打开 ~/.workbuddy/mcp.json 文件，在 "mcpServers" 对象下新增一项：
```json
{"my-oa-server": {"command": "python3", "args": ["./oa_mcp_server.py"], "env": {"TOKEN": "xxx", "BASE_URL": "https://oa.example.com/api/v1"}}
```
腾讯云代码助手CodeBuddy旗下WorkBuddy 4.24.8版本正式发布。本版本重点修复了上下文压缩异常、冷加载时偶现历史消息丢失、任务停止卡死等问题，并深度优化了Windows沙箱(lightSandbox)的日志写入与误弹窗逻辑，提供更安全稳定的AI协作体验。
注意：env 中的环境变量必须与你的 MCP Server 启动脚本实际读取的键名完全一致，大小写敏感。
方法二：从 SkillHub MCP 广场一键导入
访问 skillhub.workbuddy.cn/mcp → 搜索目标服务（如“钉钉审批”）→ 点击「复制配置」→ 粘贴进 mcp.json → 保存文件 → 重启 WorkBuddy。
这一步操作起来很简单，直接把配置块粘贴进去就行，不用改任何字段名。
WorkBuddy 启动时会扫描 mcp.json 中所有 server 配置，依次尝试建立连接。只要 command 可执行、args 路径存在、env 变量合法，就会注册为可用连接器，并出现在「连接器」列表底部「自定义服务」分组中。
跨平台调用时的实际执行路径
第一步：用户输入自然语言指令，例如“把乐享知识库里《Q2产品路线图》的更新摘要发到飞书项目群”
第二步：WorkBuddy 的 Planner 模块自动拆解为两个子任务：
① 调用乐享连接器的 mcp://read 接口读取文档内容
② 调用飞书连接器的 mcp://post 接口发送消息
第三步：两个连接器并行发起 MCP 请求，各自处理鉴权、数据格式转换、错误重试逻辑
第四步：结果合并后生成最终响应，同时将执行日志写入本地 ~/.workbuddy/logs/mcp_trace_20260727.log
整个过程对用户完全透明，你不需要指定用哪个平台的 API、也不需要手动构造请求体——WorkBuddy 根据语义理解自动选择并协调多个跨平台连接器协同工作。
