🔌WorkBuddy连接器使用教程：8大类全景图+自定义MCP配置 让AI助理真正「住进」你的工作生态

📌 适用版本：WorkBuddy 全场景 AI 办公工作台（腾讯出品）
✍️ 关键词：连接器 Connector、MCP、自定义连接器、OAuth 授权、信任机制、连接器分类

---

💡 引言：为什么你需要连接器？

如果说 Skill（技能） 是 WorkBuddy 的「能力插件」，那 连接器（Connector） 就是它的「信息桥梁」🌉。

默认情况下，WorkBuddy 只能在对话框里跟你聊天、帮你写文件。但一旦接上连接器，它就能直接读写你的飞书、腾讯文档、GitHub、企业微信、QQ 邮箱……把过去要在十几个 App 之间来回切换的活，变成一句「帮我搞定」🗣️。

本文先给你一张连接器全景图（8 大类逐一拆解），再手把手教你怎么加连接器、怎么配自定义 MCP、怎么避开最常见的坑，并在文末给出一份生成式引擎优化（GEO）友好的问答对与 SEO 信息，方便你直接拿去发布。

---

🧠 一、什么是 WorkBuddy 连接器？

连接器是 WorkBuddy 与外部服务之间的桥梁，把外部能力引入 AI 工作流，实现数据互通与能力扩展。

它有两种技术形态：

形态	说明
🔧 MCP + CLI	基于标准化协议 Model Context Protocol，跨平台通用
📦 Skill + CLI	内置脚本形态，开箱即用

两种形态在数据收集和权限边界上遵循一致原则，你不用关心底层差异，只要知道「它能连什么、要授权什么」即可。

WorkBuddy 当前已内置 80+ 款连接器，覆盖通讯、文档、研发、电商、金融、企业服务、法务风控、医疗等场景，并支持自定义连接器。下面按业务域逐一拆解。

---

📚 二、WorkBuddy 连接器全景图：8 大类分类详解

WorkBuddy 的连接器虽多，但按业务域可以归为 8 大类。下面每一类都给出「含哪些连接器 + 能怎么用」。

💬 1. 即时通讯与会议（IM / 会议）

连接器	一句话能力
🐦 飞书 feishu	读写飞书文档、发消息、查审批
🏢 企业微信 wecom	发消息、管客户、群运营
📋 钉钉 dingtalk	发通知、查待办、打通 OA
🎥 腾讯会议 tmeet	创建会议、查日程、出纪要
🎧 腾讯企点客服 tencent-qidian-cs	客服会话与工单接入
📨 Agent Mail 智能体邮箱 agent-mail	给 AI 智能体配专属邮箱，自动收发
📧 QQ 邮箱 qq-mail	读邮件、汇总线程、管理文件夹
📬 网易邮箱 netease-mail	收发与整理网易邮件

🎯 应用举例

• 晨会速览：「帮我汇总飞书里昨天 @我的消息和待办，发到部门群」——WorkBuddy 自动拉取并推送。
• 邮件零管理：「把 QQ 邮箱里带『发票』的邮件归到『财务』文件夹，并回复寄件人『已收到』」——自然语言驱动分类与回复。
• 会议闭环：「下周三 10 点用腾讯会议拉个评审会，把纪要写进腾讯文档」——创建 + 记录一条龙。

📄 2. 文档与知识库（文档 / 知识管理）

连接器	一句话能力
📘 腾讯文档 tencent-docs	创建、编辑、搜索在线文档
🏛️ 腾讯文档企业版 tencent-docs-oa	企业级文档协作
📗 金山文档 kdocs	多人协作表格 / 文档
📙 WPS 知识库 wps-knowledgebase	WPS 文档检索与管理
📚 乐享知识库 lexlang	检索、创建、管理团队知识库
🧠 ima 知识库 ima-mcp	个人 / 团队知识检索
🌐 知识星球 zsxq	社群内容读取与整理
☁️ 微云 tencent-weiyun	腾讯网盘文件读写
💾 百度网盘 baidu-netdisk	网盘文件管理与转存
🔍 TextIn xParse 智能文档解析 textin-xparse	PDF / 扫描件转结构化文本

🎯 应用举例

• 纪要入库：「把这次会议录音整理成纪要，写进腾讯文档《周会归档》」——生成即落盘。
• 扫描件变数据：「用 xParse 解析这份 PDF 合同，提取甲乙方、金额、到期日做成表格」——非结构化转结构化。
• 知识检索：「在乐享知识库里找一下我们的《报销制度》，引用关键条款回答我」——AI 直接基于知识库作答。

🛠️ 3. 研发与项目管理（研发 / 项目）

连接器	一句话能力
🐙 GitHub github	查 Issues / PR / 仓库、生成 Release Notes
📊 TAPD tapd	需求、缺陷、迭代管理
🔧 CNB cnb-api	代码托管与 CI 协作
☁️ 腾讯云 CloudBase cloudbase	云开发部署与数据读写
🌐 EdgeOne Pages edgeone-pages	静态站点一键部署
🧩 轻流 qingflow	低代码表单 / 流程
🎨 MasterGo 莫高设计 mastergo-vibe-mcp	设计稿读取与组件协同

🎯 应用举例

• 自动化发布说明：「读 GitHub 上 v2.3.0 以来的 merged PR，生成中文 Release Notes 发到 TAPD 迭代」——研发运营自动化。
• 一键上线：「把 build 产物部署到 EdgeOne Pages，并把访问地址发我企业微信」——部署 + 通知闭环。
• 需求流转：「把 TAPD 里『待开发』的需求按优先级排个序，超期标红」——项目管理助手。

🛒 4. 电商与营销增长（电商 / 增长）

连接器	一句话能力
📢 腾讯营销投放 tencentads	广告投放数据拉取与复盘
📈 Tec-Do 2.0 广告与增长情报 tec-do	广告 / 增长情报分析
🖼️ 极睿电商生图 infimind-ecommerce-image	AI 批量生成商品图
🎬 极睿视频 infimind-video	AI 生成电商视频
🛍️ Picset AI 电商图片 picset-commerce-images	商品图智能生成
🎞️ Picset AI 视频生成 picset-video-generation	商品视频智能生成
🔎 Linkfox 选品 linkfox-product-selection	跨境选品分析
🎨 Canva 可画 canva	设计物料快速出图
🎓 小鹅通 xiaoe-cloud-cli	知识付费课程管理
🌏 出海匠 chuhaijiang	出海营销 / 选品辅助
🤝 福帮手 fbs-connector	电商客服 / 订单助手
👨‍🏫 SalesNail 讲师 salesnail-instructor	销售 / 讲师内容辅助
💬 微盛企微管家 SCRM weisheng-scrm	企业微信私域运营
📋 腾讯问卷 tencent-survey	问卷发放与回收分析
🎯 有数智客 To B 营销 youshu-bd-mate	对公（To B）营销助手

🎯 应用举例

• 素材工厂：「用极睿 / Picset 给这款连衣裙生成 6 张不同场景的商品图 + 1 条 15 秒短视频」——电商内容批量生产。
• 投放复盘：「拉腾讯广告上周消耗和转化，对比 Tec-Do 的情报，给我一份优化建议」——投放决策有据。
• 私域运营：「把新加的企业微信好友按标签分层，发不同欢迎语」——SCRM 自动化。

📈 5. 金融与投资数据（金融 / 财经）

连接器	一句话能力
📉 腾讯自选股 westock-mcp	A 股 / 基金行情与自选
💹 东方财富妙想 MCP mx-ds-mcp	财经数据与研究辅助
📊 Wind 金融数据 wind-finance	专业金融终端数据
🔎 同花顺快查企业数据 kuaicha-search	上市公司 / 企业快查
📐 通达信 tdx-connector	行情与技术分析
💰 盈米 MCP yingmi-mcp	基金投顾数据
📚 同舟金融研究 tongzhou-fin-research	金融研究报告检索

🎯 应用举例

• 行情看板：「拉腾讯自选股里我关注的 10 只票今日涨跌，做成表格发我」——盘中速览。
• 研报摘要：「在 Wind / 同舟里找半导体行业最新研报，给我 3 条核心结论」——研究提效。
• 投顾助手：「结合盈米数据，给稳健型客户出一版基金配置建议」——专业数据驱动。

🏢 6. 企业服务与 CRM（销售 / HR / 财务）

连接器	一句话能力
🤝 销售易 CRM neo-crm	客户、商机、跟进管理
🧮 用友智能服务 shanglv-mcp-gateway	用友 AI BaaS 业务接入
📝 金数据 jinshuju	表单收集与数据整理
👔 Moka HR 智能体 moka	招聘 / 简历筛选辅助
📑 中兴新云 AI 智报 zfs-fssc-ai	财务共享 / 智能报告
🧾 云帐房 AI 开票 yzf-invoice-mcp-server	自动开票
🌿 柠檬云 lemonclaw	代账 / 财税工具

🎯 应用举例

• 销售跟进：「读销售易里本周该跟进但没动的客户，提醒我并起草跟进话术」——CRM 活化。
• 财务自动化：「用云帐房给这 3 张订单开票，并把开票结果回写表格」——财税闭环。
• 招聘提效：「用 Moka 把这批简历按『3 年经验 + Python』筛一遍，排出优先级」——HR 减负。

⚖️ 7. 企业查询 · 法务 · 风控（工商 / 知识产权 / 法律）

连接器	一句话能力
🏛️ 企查查 qcc-company	工商信息 / 股权穿透
⚖️ 企查查·法律数据 qcc-legal	司法 / 法律数据
🔍 天眼查 tyc-mcp	企业尽调与风险
👁️ 启信慧眼 qixinhuiyan-mcp	企业风险监控
💳 水滴征信 cisp-mcp	征信数据查询
🛡️ 天创信用星图 xingtu-claw-risk	信用风控
™️ 摩知轮商标查询 mzl-trademark	商标检索与监测
📜 北大法宝 pkulaw	法律法规检索
📘 威科先行 wk-workbuddy	法律 / 税务实务库
⚖️ 华宇元典法律数据 yuandian-mcp	法律大数据分析
📄 智慧芽专利 patsnap-search	专利与文献融合检索

🎯 应用举例

• 投资尽调：「对这家目标公司做尽调，拉企查查股权结构 + 天眼查风险 + 摩知轮商标，出一份风险摘要」——多源交叉验证。
• 合同风控：「用北大法宝 / 威科核一下这份合同条款，标出和我方不利的条款」——AI 法律审查。
• 专利布局：「在智慧芽里查『固态电池』近一年公开专利，看主要申请人和空白点」——研发情报。

🏥 8. 医疗健康与其他垂直服务

连接器	一句话能力
🏥 腾讯健康全周期管理平台 archive-hospital-mcp	健康档案与全周期管理
🩺 腾讯健康 NGES tencent-health-nges	医药 / 健康专业服务
🗺️ 腾讯地图 tencent-map	地点 / 路径 / 周边检索
✈️ 携程问道 ctrip-wendao	出行 / 行程规划
🚄 同程程心 tc-chengxin	机票酒店预订辅助
🖥️ 向日葵远程控制 awesun	远程桌面控制
🔗 铱云 AI 供应链 77ircloud	供应链协同
🐝 AI-HIVE ai-hive	AI 能力聚合
🔑 AgentKey agentkey	密钥 / 凭证管理
📍 及刻智能·时空数据 opendata	时空位置数据
⚙️ 弹性 MapReduce emr-query	大数据计算
🐞 Bugly 质量概览 bugly-token	应用崩溃 / 质量监控
💻 Lovrabet CLI lovrabet-cli	命令行工具接入

🎯 应用举例

• 出行规划：「用携程问道帮我定下周一去上海的行程，酒店靠近客户公司，同步到日历」——差旅一条龙。
• 质量监控：「读 Bugly 昨天新出的崩溃 TOP3，给研发提修复优先级」——线上问题闭环。
• 供应链协同：「用铱云看本周库存预警，低于安全线的 SKU 提醒采购」——供应链告警。

💡 选连接器的小技巧：先想清楚「我要让 AI 碰哪类数据 / 做哪类操作」，再对照上面 8 类定位，一般 1–2 个连接器就能打通一条工作流。

---

🎯 三、连接器能做什么？（通用能力视角）

不管接哪一类连接器，底层都是这四类通用能力：

场景	说明	示例
🔍 数据查询	从外部数据源获取信息	查询数据库、检索文档
📡 服务调用	调用第三方 API 完成操作	发送邮件、创建日程
📁 文件管理	访问云端存储与文件系统	读取网盘文件、上传附件
💬 消息通知	与即时通讯工具集成	发送企业微信 / 飞书消息

核心价值就一句话：消灭信息孤岛——一个 WorkBuddy 对话，搞定跨平台操作。

---

🚀 四、如何使用连接器（分步教程）

📍 4.1 找到连接器入口

在 WorkBuddy 界面：

• 方式一：单击对话框左侧的 + 按钮 → 单击「连接器」
• 方式二：左侧导航栏 / 设置中点击「连接器」，进入连接器管理页面

页面按类别分组展示所有可用连接器卡片。

➕ 4.2 添加官方连接器（OAuth 授权）

1. 在连接器列表中找到目标卡片（如「飞书」）
2. 点击卡片右侧的 + 按钮发起连接
3. 按引导完成扫码或登录授权（OAuth）
4. 授权成功后，卡片名称旁出现绿色圆点，状态变为「已连接」，右侧显示启用 / 禁用开关 ✅

📧 4.3 实战案例：连接 QQ 邮箱

QQ 邮箱连接器支持收发、搜索、整理邮件，用自然语言就能读邮件、汇总线程、管理文件夹。

1. 点击添加：在连接器管理页找到 QQ 邮箱卡片，点右侧 +
2. 扫码授权：跳转到 QQ 邮箱授权页，用 QQ 邮箱 App（7.1.5 / 鸿蒙 0.2.9 及以上）扫码
3. 确认权限：手机端确认 WorkBuddy 申请的权限（账号信息、读取近一月邮件、发送邮件等）
4. 连接完成：回到 WorkBuddy，卡片出现绿色圆点 + 「连接器 QQ 邮箱 已连接」提示

✅ 验证方式：在对话里说「帮我查看我的 QQ 邮箱最新 5 封邮件」，能正常返回即成功。

🛠️ 4.4 自定义连接器（MCP）

当内置连接器覆盖不到你的系统（如自建 CRM、内部 API），可以走自定义连接器。配置方式和标准 MCP 一致。

配置文件路径（重要！）：

系统	路径
Windows	C:\Users\<用户名>\.workbuddy\mcp.json
macOS / Linux	~/.workbuddy/mcp.json

⚠️ 致命坑：WorkBuddy 读取的是不带点前缀的 mcp.json。同目录下可能存在一个 .mcp.json（带点），那是系统自动生成的代理文件，千万不要手动编辑它，改了也会被覆盖。

📝 4.5 mcp.json 配置详解

在 mcpServers 对象下新增一项，按服务商文档填写 command / args / env 或 url / headers：

stdio 模式（本地脚本）：

{
  "mcpServers": {
    "my-crm": {
      "command": "python",
      "args": ["./oa_mcp_server.py"],
      "env": {
        "TOKEN": "xxx",
        "BASE_URL": "https://oa.example.com/api/v1"
      }
    }
  }
}

HTTP / SSE 模式（远程服务）：

{
  "mcpServers": {
    "my-service": {
      "url": "https://internal.company.com/mcp",
      "headers": {
        "Authorization": "Bearer ${API_TOKEN}"
      }
    }
  }
}

💡 注意：若文件中已有其他服务配置，在 mcpServers 对象里追加即可，不要覆盖已有配置；env 键名大小写敏感，必须与启动脚本实际读取的一致。

🔐 4.6 信任并启用（安全机制）

自定义 MCP 写好后不会自动激活。WorkBuddy 出于安全考虑，要求你手动信任每个自定义服务器：

1. 打开 WorkBuddy → 连接器管理 → 右上角「自定义连接器」
2. 在列表中找到新出现的服务
3. 点击右侧的 「信任」 按钮
4. 等待几秒，状态变为「已连接」即启用成功

✅ 这一步必须在界面手动点击，无法通过代码绕过，是防自动加载未信任连接器的安全机制。

---

🔌 五、连接器管理：断开与禁用

• 临时禁用：在已连接卡片上点击右侧「启用 / 禁用」开关，连接器恢复未连接状态，可随时重新启用。
• 彻底解绑：在卡片上点击开关后，弹窗确认「解绑」，确认后连接器恢复为未连接；部分连接器（如 QQ 邮箱）也可在对应 App 的「应用授权」管理中撤销。

---

🌐 六、作用域：用户级 vs 项目级

自定义连接器支持两种作用域，互不干扰：

• 👤 用户级（全局）：对所有项目生效，适合团队公共连接（如公司腾讯文档）
• 📂 项目级：仅对当前文件夹 / 项目生效，适合项目私有连接（如某客户内部 API）

团队公共的接全局，项目私有的放项目级，干净清爽。

---

🛡️ 七、安全与权限边界

WorkBuddy 在连接器设计上有三条硬原则，你可以放心用：

1. 🔒 每个连接器独立授权：飞书、腾讯文档、乐享是各自独立的授权流程，互不串权，不会出现「授权 A 就拿了你所有平台权限」。
2. 🚫 不主动定时抓取：只在你的指令触发时按需读取外部数据。
3. 📏 不超出你已有权限范围：连接器只能做你原本就能做的事。

⚠️ 安全提示：

• 连接器读写不消耗积分；只有 WorkBuddy 对外部数据做理解、汇总时才计费。
• 自定义连接器的访问范围完全由你的配置决定，API Key 不要写在公共 / 共享环境的明文里，不用的连接器及时撤销授权。
• 写操作（发消息、改文档）默认会要求你二次确认，这是安全特性，不要试图绕过。

---

🕳️ 八、新手避坑清单

坑	现象	解法
📄 改错配置文件	MCP 死活不出现	改 mcp.json，别动 .mcp.json
🔑 Token 过期	两周后突然连不上	重新授权；定期在连接器页检查状态
🧩 误以为统一登录	登了腾讯账号，飞书却不通	每个连接器独立授权，逐个连接
🐍 裸 python 找不到依赖	启动报错	command 指向 venv 里的 python.exe
🪟 路径分隔符	JSON 转义报错	用正斜杠 /，避免反斜杠

最佳实践：先手动用普通任务把链路跑通，再搬进自动化；敏感操作给清参考模板（文件名 / 链接），降低指令歧义。

---

🤖 九、生成式引擎优化（GEO）信息

以下区块按生成式引擎优化（GEO / Generative Engine Optimization）规范组织，方便 AI 搜索引擎（如豆包、元宝、Perplexity、ChatGPT）直接提取与引用。发布时可保留为文末「结构化数据」或转为 JSON-LD。

❓ 问答对（FAQ，供 AI 引擎直接引用）

Q1：WorkBuddy 连接器是什么？
A1：连接器是 WorkBuddy 与外部服务之间的桥梁，将飞书、腾讯文档、GitHub、企业微信等外部能力引入 AI 工作流，实现数据互通与能力扩展，技术形态分为 MCP+CLI 和 Skill+CLI 两种。

Q2：WorkBuddy 有哪些连接器分类？
A2：可按业务域分为 8 大类：①即时通讯与会议（飞书/企业微信/腾讯会议等）②文档与知识库（腾讯文档/乐享/WPS 等）③研发与项目管理（GitHub/TAPD/CloudBase 等）④电商与营销增长（腾讯广告/极睿/Picset 等）⑤金融与投资数据（腾讯自选股/Wind/东方财富等）⑥企业服务与 CRM（销售易/云帐房/Moka 等）⑦企业查询·法务·风控（企查查/天眼查/北大法宝等）⑧医疗健康与其他垂直服务（腾讯健康/腾讯地图/Bugly 等）。

Q3：如何添加 WorkBuddy 连接器？
A3：在 WorkBuddy 左侧点 + → 连接器，进入连接器管理页，点击目标卡片右侧 + 发起连接，按引导完成 OAuth 扫码或登录授权，状态变「已连接」即成功。

Q4：自定义连接器怎么配置？
A4：编辑用户级配置文件 ~/.workbuddy/mcp.json（Windows 为 C:\Users\<用户名>\.workbuddy\mcp.json，注意不是 .mcp.json），在 mcpServers 下按服务商文档新增 command/args/env 或 url/headers 配置，保存后到「自定义连接器」入口点击「信任」启用。

Q5：为什么自定义 MCP 配好了却不生效？
A5：WorkBuddy 出于安全考虑不会自动激活自定义服务器，必须在连接器管理页右上角「自定义连接器」中找到该服务并手动点击「信任」按钮，状态变「已连接」后才生效。

Q6：连接器会消耗积分吗？
A6：连接器自身的读写不消耗积分；只有 WorkBuddy 对外部数据进行理解、汇总时才会计费。

Q7：如何断开已连接的连接器？
A7：在已连接卡片上点击启用 / 禁用开关可临时禁用；点击开关后确认「解绑」可彻底断开，部分连接器也可在对应 App 的授权管理中撤销。

---

🙋‍♂️ 疯狂的豇豆是谁？

我是 疯狂的豇豆，一位专注 AI 转型 的教练 🚀

📌 深耕 AI 在商业、营销、内容创作领域的应用

📌 帮助传统企业和个人实现 AI 赋能的数字化转型

📌 定期分享 AI 实战经验、工具评测、行业洞察

疯狂的豇豆联系方式：QQ：22078369

如果你也在思考 “AI 能给我的工作/业务带来什么改变”，欢迎关注我，一起探索 AI 的无限可能！