AI工具WorkBuddy篇：5_ 连接器（连应用）功能使用指南

WorkBuddy

连接器（连应用）功能

从零配置到高级联动 5大内置连接器 + 自定义MCP + 10个实战场景

AI 不再是孤岛，它终于能直接读写你的腾讯文档、QQ邮箱、TAPD……

目录

目 录

第一章 认识连接器

1.1 什么是连接器

1.2 连接器解决了什么问题

1.3 连接器 vs 技能 vs 专家

1.4 两种连接器类型

第二章 支持的连接器全览

2.1 官方内置连接器

2.2 自定义MCP连接器

2.3 路线图展望

第三章 进入连接器管理

3.1 连接器入口位置

3.2 连接器状态说明

第四章 内置连接器配置详解

4.1 腾讯文档连接器

4.2 QQ邮箱连接器

4.3 腾讯乐享知识库连接器

4.4 TAPD项目管理连接器

4.5 微云连接器

第五章 自定义MCP连接器开发

5.1 什么是MCP协议

5.2 环境准备

5.3 Python FastMCP实现（推荐）

5.4 Node.js实现

5.5 远程SSE部署

5.6 mcp.json配置详解

第六章 10个实战场景

第七章 连接器 + 自动化联动

7.1 联动原理

7.2 配置方法

7.3 经典联动场景

第八章 连接器 + 技能 + 专家三剑合璧

8.1 三者关系图

8.2 搭配方案参考

8.3 完整工作流演示

第九章 安全最佳实践

9.1 权限最小化原则

9.2 密钥管理规范

9.3 Webhook安全

9.4 安装第三方连接器前安全检查

9.5 账号安全建议

第十章 故障排查指南

10.1 连接器配置后显示红色（连接失败）

10.2 AI没有自动调用连接器工具

10.3 内置连接器提示权限不足

10.4 腾讯文档授权后AI找不到文件

10.5 邮件连接后AI读取很慢

10.6 自动化任务没有如期执行

10.7 连接器频繁失效/断连

第十一章 进阶技巧与避坑指南

11.1 进阶技巧

11.2 避坑指南 – 五大必踩坑

11.3 Prompt质量自查清单

第十二章 常见问题FAQ

附录 速查表

A. 内置连接器速查表

B. 自定义MCP常见配置模板

C. 故障排查速查表

D. 连接器配置顺序建议

第一章 认识连接器

1.1 什么是连接器

连接器（Connector）是 WorkBuddy 与外部服务之间的桥梁。它基于标准化协议（MCP – Model Context Protocol），将外部服务的能力引入到 AI 工作流中，让 AI 助手可以直接访问和操作第三方服务。

用最简单的话说：以前 WorkBuddy 是一座孤岛，你得手动把文件复制进去；现在连上连接器，AI 可以直接读写你的腾讯文档、QQ邮箱、TAPD……彻底告别反复粘贴。

一句话理解 连接器 = WorkBuddy 和外部软件之间的数据线 + 无线网桥 连上之后，你说一句「帮我整理最近3天的邮件」，AI 自己去取、自己处理、自己给你结果。

1.2 连接器解决了什么问题

在连接器出现之前，用 WorkBuddy 处理文件有一个隐形成本——你得先把数据搬给 AI：

这个「搬数据」的环节，很多时候比 AI 处理本身还费时间。连接器解决的就是这件事。

效率对比 整理云文档内容：省去 4 步手动操作 处理邮件列表：减少 80% 时间 生成周报：接近 0 人工（配合自动化） 查找历史文档：从分钟级到秒级

1.3 连接器 vs 技能 vs 专家

很多新手打开 WorkBuddy，看着侧边栏一堆功能直接眼花缭乱，分不清三者区别。用大白话讲明白：

底层逻辑链条：

连接器调取云端文件数据     -> 技能执行数据处理规则         -> 专家把控输出格式与专业标准 三者环环相扣，缺一环都会出现功能断层。

关键认知 只装连接器，不搭配技能、专家 = 手机插好数据线却不装驱动，设备能识别但无法传输文件。 这是多数人觉得连接器不好用的核心原因。

1.4 两种连接器类型

WorkBuddy 支持两种接入方式：

建议：内置够用先用内置，不满足需求再上自定义 MCP。

第二章 支持的连接器全览

2.1 官方内置连接器

截至 2026 年 6 月，WorkBuddy 内置自家连接器列表如下（全部免费，仅需一次授权永久生效）：

2.2 自定义MCP连接器

当内置连接器不满足需求时，可以通过自定义 MCP 连接器接入任意外部服务。常见的自定义连接器包括：

2.3 路线图展望

第三章 进入连接器管理

3.1 连接器入口位置

在 WorkBuddy 客户端中，有两种方式进入连接器管理页面：

第1步：通过侧边栏进入（推荐）

在 WorkBuddy 左侧导航栏中，找到「连接器」图标（插头图标）

点击该图标，即可进入连接器管理页面

页面会展示所有可用的连接器卡片

第2步：通过消息框快捷管理

在对话消息框中，也可以快速管理连接器

点击消息框附近的连接器快捷入口

可直接跳转到连接器管理页面

版本要求：WorkBuddy >= v4.21 才支持完整的连接器功能。如果版本低于此要求，请先更新。

3.2 连接器状态说明

首次使用建议 按照日常使用频率排序，先打通刚需服务 普通人优先配置顺序：腾讯文档 -> QQ邮箱 -> 腾讯会议 三类覆盖 80% 日常办公需求 不要一次性安装全部连接器，避免底层数据拥堵

第四章 内置连接器配置详解

4.1 腾讯文档连接器

腾讯文档连接器支持读取、创建、编辑云端 Word/Excel/PPT，是最常用的连接器。

配置步骤：

第1步：打开连接器管理

WorkBuddy 左侧导航栏 -> 点击「连接器」图标（插头图标）

第2步：添加腾讯文档

找到「腾讯文档」卡片

点击右侧的「+」按钮发起连接

第3步：扫码授权

跳转授权页面 -> 用微信或QQ扫码登录

确认授权范围：读取文档内容 / 创建新文档 / 编辑已有文档（可选）

手机端点击「同意授权」

第4步：验证连接

回到 WorkBuddy，腾讯文档卡片旁出现绿色圆点 = 连接成功

右侧显示启用/禁用开关

最大坑：账号必须一致！ 腾讯文档和 WorkBuddy 必须用同一个微信账号登录！ 如果扫码成功但文档读不到，99% 是账号不一致导致的。 不需要共享的文档建议提前整理到独立账号。

测试指令：

请列出我腾讯文档里最近修改的5个文档， 显示：文档名称、最后修改时间、文档类型（表格/文档/幻灯片）

如果看到你的文档列表 = 连接完全正常！

使用示例：

帮我读取腾讯文档里最近修改的「2026项目跟进表」， 按优先级整理成待办清单，并保存为新文档「任务清单-06月」

4.2 QQ邮箱连接器

QQ邮箱连接器支持收发邮件、搜索、智能回复，用自然语言读取邮件内容、汇总邮件线程、管理文件夹。

配置步骤：

第1步：添加QQ邮箱

在连接器管理页面找到「QQ邮箱」卡片

点击右侧的「+」按钮发起连接

第2步：扫码授权

系统跳转到QQ邮箱授权页面，显示二维码

使用 QQ邮箱 App（版本 >= 7.1.5 / 鸿蒙 >= 0.2.9）扫码

第3步：确认权限

账号信息：获取邮箱账号基础信息

读取邮件：读取收件箱内近一个月的邮件

发送邮件：代为发送邮件

删除邮件（可选，谨慎授权）：已删除邮件移入「已删除」文件夹

确认后点击「同意授权」

第4步：连接完成

手机端显示「授权成功」

回到WorkBuddy，QQ邮箱卡片旁出现绿色圆点

权限说明：

撤销授权方式：QQ邮箱 App -> 设置 -> 账号 -> 安全管理 -> 登录设备和授权码 -> 应用授权

使用示例：

读取我QQ邮箱最近3天未读邮件，分类整理： – 需要我回复的（列出发件人、主题、建议回复要点） – 需要转发处理的（列出建议转发对象） – 可以直接归档的（无需处理的通知类） 按紧急程度排序输出

4.3 腾讯乐享知识库连接器

腾讯乐享连接器支持搜索、创建和管理乐享知识库中的文档，支持导入Markdown、按标签整理内容、追踪团队文档更新动态。

配置步骤：

第1步：添加腾讯乐享

在连接器管理页面找到「腾讯乐享」卡片

点击右侧的「+」按钮发起连接

第2步：登录乐享知识库

系统跳转到腾讯乐享登录页面

支持三种登录方式：微信登录 / 手机号登录 / 企业微信登录

第3步：确认授权

登录后进入授权确认页面，显示当前账号信息

WorkBuddy 将能够：按你拥有的权限访问知识库

搜索、查询知识库中的内容

协助创建与管理知识库中的内容

确认后点击「继续」

第4步：连接完成

页面显示「Authentication Successful」= 认证成功

回到 WorkBuddy，腾讯乐享卡片旁出现绿色圆点

使用示例：

在乐享知识库里搜索「研发规范」相关文档， 提炼出5条最重要的开发原则， 并附上对应文档链接

4.4 TAPD项目管理连接器

TAPD连接器支持任务管理、项目进度查看、缺陷追踪，适合项目管理/研发团队使用。

配置步骤：

第1步：添加TAPD

在连接器管理页面找到「TAPD」卡片

点击右侧的「+」按钮发起连接

第2步：授权

跳转 TAPD 企业微信账号授权页面

确认工作空间访问范围

第3步：连接完成

授权成功，绿色圆点出现

使用示例：

读取 TAPD 中本迭代未完成的需求， 按负责人汇总进度，生成每日站会报告

4.5 微云连接器

微云连接器支持云端文件读写、附件上传与管理。

配置步骤：

第1步：添加微云

在连接器管理页面找到「微云」卡片

点击右侧的「+」按钮发起连接

第2步：扫码授权

用微信或QQ扫码登录

确认授权范围

第3步：连接完成

回到 WorkBuddy，微云卡片旁出现绿色圆点

使用示例：

帮我查看微云里「项目资料」文件夹下的所有文件， 按修改时间排序，列出文件名和大小

第五章 自定义MCP连接器开发

5.1 什么是MCP协议

MCP 全称 Model Context Protocol，是 Anthropic 在 2024 年底推出的一个开放协议。简单理解，它就是 AI 和各种软件之间的「通用接口」。

以前你要让 AI 操作某个软件，得专门写代码对接。MCP 出现之后，只要这个软件有对应的 MCP 服务端，你填个配置就能用。WorkBuddy 原生支持 MCP，配置文件放在 ~/.workbuddy/mcp.json，改完保存就能生效。

两种配置方式 用户级配置：~/.workbuddy/mcp.json（全局生效，所有项目可用） 项目级配置：<项目目录>/.workbuddy/mcp.json（仅当前项目生效）

5.2 环境准备

自定义连接器需要以下运行时环境（仅自定义连接器必须，内置连接器不需要）：

# 安装 FastMCP 框架（推荐）
pip install fastmcp

# 或安装官方 MCP SDK
pip install mcp

# 安装 uvx（Python MCP Server 快速运行工具）
pip install uv

# 验证安装
python -c "from fastmcp import FastMCP; print('FastMCP OK')"
uvx –version

5.3 Python FastMCP实现（推荐）

以「接入企业内部知识库查询API」为例，展示完整的自定义 MCP Server 开发流程。

Step 1：创建 MCP Server（knowledge_server.py）

from fastmcp import FastMCP
import httpx

mcp = FastMCP("enterprise-knowledge")

@mcp.tool()
def search_docs(query: str, limit: int = 5) -> str:
"""
搜索企业内部知识库文档。
参数: query – 搜索关键词, limit – 返回数量
返回: 匹配的文档标题和摘要列表
"""
response = httpx.get(
"https://internal-api.company.com/knowledge/search",
params={"q": query, "limit": limit},
headers={"Authorization": f"Bearer {API_TOKEN}"},
timeout=10
)
data = response.json()
results = data.get("items", [])
if not results:
return f"未找到与「{query}」相关的内容"
output = []
for item in results:
output.append(f"{item['title']}\\n {item['summary'][:150]}")
return "\\n\\n".join(output)

@mcp.tool()
def get_doc_content(doc_id: str) -> str:
"""根据文档ID获取完整文档内容。"""
response = httpx.get(
f"https://internal-api.company.com/knowledge/docs/{doc_id}",
headers={"Authorization": f"Bearer {API_TOKEN}"}
)
return response.json().get("content", "文档内容为空")

@mcp.tool()
def create_doc(title: str, content: str, tags: list = []) -> str:
"""在知识库中创建新文档。"""
response = httpx.post(
"https://internal-api.company.com/knowledge/docs",
json={"title": title, "content": content, "tags": tags},
headers={"Authorization": f"Bearer {API_TOKEN}"}
)
data = response.json()
return f"文档创建成功 ID:{data['id']} 链接:{data['url']}"

if __name__ == "__main__":
import os
API_TOKEN = os.environ.get("KNOWLEDGE_API_TOKEN", "")
mcp.run()

Step 2：在 WorkBuddy 中配置连接器

编辑 ~/.workbuddy/mcp.json（用户级配置）：

{
"mcpServers": {
"enterprise-knowledge": {
"command": "python",
"args": ["C:/path/to/knowledge_server.py"],
"env": {
"KNOWLEDGE_API_TOKEN": "your-api-token-here"
},
"description": "企业内部知识库查询系统"
}
}
}

Step 3：验证连接

在 WorkBuddy 侧边栏 -> 插件 -> MCP 服务器，查看 enterprise-knowledge 状态：

状态判断 绿色 = 连接成功 红色 = 配置异常（检查 Python 路径和 Token）

重要：写好docstring！ AI 依赖 docstring 理解工具用途。如果函数没有描述，AI 不会自动调用。 每个 @mcp.tool() 函数必须有清晰的 docstring 和类型注解。 错误写法：def search(query, limit): pass  # 缺少类型注解 正确写法：def search(query: str, limit: int = 5) -> str:  # 明确类型

5.4 Node.js实现

// knowledge_server.js
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({
name: "enterprise-knowledge",
version: "1.0.0",
});

server.tool(
"search_docs",
"搜索企业知识库，返回匹配文档列表",
{ query: z.string(), limit: z.number().optional().default(5) },
async ({ query, limit }) => {
// … 搜索逻辑
return { content: [{ type: "text", text: results }] };
}
);

const transport = new StdioServerTransport();
await server.connect(transport);

对应 mcp.json 配置：

{
  "mcpServers": {
    "enterprise-knowledge-node": {
      "command": "node",
      "args": ["./knowledge_server.js"],
      "env": {
        "KNOWLEDGE_API_URL": "https://internal-api.company.com",
        "KNOWLEDGE_API_TOKEN": "your-token"
      }
    }
  }
}

5.5 远程SSE部署

适用于团队共享的 MCP Server，部署到云服务器后，所有成员可通过 SSE 方式接入，无需本地安装。

# knowledge_server_remote.py
from fastmcp import FastMCP

mcp = FastMCP("enterprise-knowledge-remote")

@mcp.tool()
def search_docs(query: str) -> str:
    """搜索知识库文档"""
    pass

if __name__ == "__main__":
    # SSE 模式，监听 8080 端口
    mcp.run(transport="sse", port=8080, host="0.0.0.0")

WorkBuddy 中配置 SSE 连接：

{
  "mcpServers": {
    "enterprise-knowledge-remote": {
      "type": "sse",
      "url": "https://mcp.your-company.com:8080/sse",
      "headers": {
        "Authorization": "Bearer your-shared-token"
      },
      "description": "远程共享知识库 MCP Server"
    }
  }
}

5.6 mcp.json配置详解

常见自定义MCP配置模板 企业微信机器人：command=uvx, args=[wecom-bot-mcp-server], env={WECOM_WEBHOOK_URL} GitHub：command=npx, args=[@modelcontextprotocol/server-github], env={GITHUB_TOKEN} Notion：command=npx, args=[@modelcontextprotocol/server-notion], env={NOTION_TOKEN}

第六章 10个实战场景

以下每个场景都配有完整的提示词，你可以直接复制到 WorkBuddy 中使用，只需修改文件名和参数。

场景1：腾讯文档 + AI 自动整理工作计划

背景：你在腾讯文档里存了一份项目跟踪表，但格式乱、信息杂，每次汇报前要花1小时整理。

【输入提示词】

读取我腾讯文档中的「2026年项目跟踪表」， 按以下格式重新整理： 1. 当前进行中的项目（附进度百分比） 2. 本周待完成事项（按优先级排序） 3. 已逾期未完成的事项（标红提醒） 输出为新的腾讯文档，标题「项目状态周报-07月」

效果：原来需要1小时的整理工作，3分钟完成，还自动生成了一份新文档。

场景2：QQ邮箱 + AI 批量处理邮件

背景：每天收几十封邮件，光是阅读、分类、回复就占据大量时间。

【输入提示词】

读取我QQ邮箱最近3天未读邮件，分类整理： – 需要我回复的（列出发件人、主题、建议回复要点） – 需要转发处理的（列出建议转发对象） – 可以直接归档的（无需处理的通知类） 按紧急程度排序输出

效果：一句话批量分类，减少 80% 时间。

场景3：邮件起草回复

背景：需要回复一封重要邮件，但不知道怎么措辞。

【输入提示词】

针对「XX项目进度确认」这封邮件， 帮我起草一份回复， 内容包括：确认收到、说明当前进度、给出下次同步时间 语气正式但友好

效果：AI直接起草回复邮件，你只需审核后发送。

场景4：腾讯文档数据分析

背景：你在腾讯文档里有一份销售数据表，需要AI直接分析。

【输入提示词】

读取腾讯文档「Q2销售数据表」， 这是一份销售数据表，请帮我： 1. 统计各产品线的销售总额和占比 2. 找出销售额最高的TOP5客户 3. 对比上月同期，分析环比变化 4. 生成一份200字的销售简报 分析完成后，将简报内容追加写入同一文档的「分析结果」Sheet页

效果：AI直接读取云端Excel，分析后把结果写回原文档。

场景5：会议纪要自动整理并存回文档

背景：刚开完一个1小时的会议，会议速记很乱。

【输入提示词】

我刚开完一个1小时的会议，以下是我的会议速记（乱的）： [粘贴你凌乱的会议笔记] 请帮我： 1. 整理成标准会议纪要格式：背景/讨论结论/行动项（含负责人和截止日期） 2. 将整理后的会议纪要，新建一个腾讯文档，    命名为「[今日日期] [会议主题] 会议纪要」    保存到我的「会议记录」文件夹下 完成后告诉我文档链接

效果：从凌乱速记到标准纪要，自动创建文档并保存。

场景6：AI产出一键回存腾讯文档

背景：做完任何任务后，想把结果直接保存到腾讯文档。

【输入提示词】

将以上分析报告上传到我的腾讯文档， 保存在「工作输出/AI分析报告」文件夹， 文件名：[任务主题]_[今日日期].docx

效果：以前要手动下载再上传，现在一句话搞定！

场景7：TAPD + 每日站会报告

背景：每天早上需要准备站会发言内容。

【输入提示词】

读取 TAPD 中本迭代未完成的需求， 按负责人汇总进度，生成每日站会报告， 格式： – 昨日完成：[任务列表] – 今日计划：[任务列表] – 阻塞问题：[如有] 保存为腾讯文档「站会报告-[今日日期]」

效果：每天早上打开WorkBuddy，站会报告已经准备好了。

场景8：知识库搜索 + 提炼总结

背景：公司知识库内容很多，找起来费时间。

【输入提示词】

在乐享知识库里搜索「研发规范」相关文档， 提炼出5条最重要的开发原则， 并附上对应文档链接， 整理成一份简洁的参考文档保存到桌面

效果：从海量知识库中秒级定位核心内容。

场景9：腾讯文档 + 自动化定期汇总（周报自动化）

背景：每周五都要写周报，手忙脚乱翻工作记录。

【输入提示词】

每周五下午5点， 读取腾讯文档中「工作日志」文件夹里本周新增的内容， 自动生成一份周报， 保存为腾讯文档「周报-[日期]」

效果：设置一次，之后每周自动生成，再也不用手动写周报。

场景10：多连接器联动 – AI全自动周报系统

背景：周报需要汇总多个来源的数据，手动整理耗时巨大。

【输入提示词】

你是我的周报助手，请按以下步骤生成本周工作周报： 第一步：数据收集 1. 从 TAPD 读取本周已完成和进行中的任务 2. 读取腾讯文档「工作日志」文件夹中本周新增的内容 3. 读取 QQ 邮箱中本周标记了「重要」的邮件 第二步：生成周报 按格式输出：本周完成 / 进行中 / 关键沟通 / 下周计划 第三步：保存与分发 1. 将周报保存到腾讯文档，命名为「周报-{日期}」 2. 通过企业微信机器人发送周报摘要到项目群 3. 起草一封发给直属上级的邮件，附上完整周报链接

效果：多个连接器串联，实现端到端自动化，接近0人工。

第七章 连接器 + 自动化联动

连接器最大的价值不只是单独使用，而是和自动化功能结合，实现无人值守的工作流。

7.1 联动原理

连接器提供数据通道，自动化提供定时触发，两者结合就能实现「定时自动拉取数据 -> AI处理 -> 自动保存/推送」的完整闭环。

定时触发（自动化）     -> 连接器拉取数据（腾讯文档/QQ邮箱/TAPD）         -> AI处理分析             -> 连接器保存结果（写入腾讯文档）                 -> 连接器推送通知（企微/邮件）

7.2 配置方法

第1步：先配置好需要的连接器

确保腾讯文档、QQ邮箱等连接器已连接成功（绿色圆点）

第2步：创建自动化任务

WorkBuddy 左侧 -> 「自动化」-> 「新建自动化」

设置任务名称、工作目录、执行时间

第3步：编写联动Prompt

在自动化任务的Prompt中，直接引用连接器能力

例如：「读取腾讯文档中XXX，生成周报，保存为腾讯文档」

第4步：设置定时规则

使用RRULE规则设置执行频率

如：每周五17:30 = FREQ=WEEKLY;BYDAY=FR;BYHOUR=17;BYMINUTE=30

第5步：测试并激活

点击「立即测试一次」验证

检查结果是否正确

测试通过后开启「激活」

7.3 经典联动场景

自动化 + 连接器的注意事项 自动化任务需要 WorkBuddy 客户端保持运行状态 建议在公司电脑上设置「开机自启」 把定时任务安排在工作时间内 每周检查一次连接器状态，绿色圆点是活的才行

第八章 连接器 + 技能 + 专家三剑合璧

单独用一个连接器已经很好用了，但真正的效率提升来自三者组合。

8.1 三者关系图

┌─────────────┐ │   连接器     │  <- 数据来源（调取云端文件/邮件/任务） │ (数据通道)   │ └──────┬──────┘        │        v ┌─────────────┐ │    技能      │  <- 操作方法（总结/分类/统计/排版） │ (操作模板)   │ └──────┬──────┘        │        v ┌─────────────┐ │    专家      │  <- 输出标准（专业格式/话术/质量把控） │ (角色模型)   │ └─────────────┘

8.2 搭配方案参考

8.3 完整工作流演示

早上打开 WorkBuddy，发送一条指令：

调取本周所有项目会议文档、客户沟通邮件， 整合全部信息，生成本周工作周报， 保存至腾讯文档，并发送草稿到我的QQ邮箱

底层自动完成：

连接器调取多渠道数据 -> 技能分类整理信息 -> 项目专家规范排版输出

全程零人工干预，十分钟才能做完的工作，一分钟完成。

第九章 安全最佳实践

9.1 权限最小化原则

连接器授权时区分读取、编辑、创建、删除四类权限。遵循最小权限原则：

绝对不要开放永久删除权限！ 避免AI误操作丢失重要资料 平台安全机制会频繁限制过度权限的连接器通道 出现间歇性断连

9.2 密钥管理规范

自定义MCP连接器的API Key/Token管理：

# 错误做法：明文写在配置文件中
{
  "env": {
    "API_TOKEN": "sk-1234567890abcdef"  # 危险！
  }
}

# 正确做法：使用环境变量
# 1. 将Token存入系统环境变量
export KNOWLEDGE_API_TOKEN="sk-1234567890abcdef"

# 2. 在mcp.json中引用环境变量
{
  "env": {
    "KNOWLEDGE_API_TOKEN": "${KNOWLEDGE_API_TOKEN}"
  }
}

9.3 Webhook安全

企微/钉钉机器人Webhook安全 Webhook URL 相当于群聊的公开入口，谁拿到都能往群里发消息 不要泄露或写到公开的地方 建议存在环境变量里，不写在明文配置中 定期更换Webhook地址

9.4 安装第三方连接器前安全检查

安装第三方自定义连接器前，建议执行安全审计：

使用 skills-security-check 技能，对以下 MCP Server 进行安全审计： [MCP Server 名称或配置路径] 重点检查： 1. 是否有危险的文件删除/覆盖命令 2. 是否有向外部URL发送数据的行为 3. 是否有隐藏的系统权限申请

9.5 账号安全建议

安全建议清单 腾讯文档和WorkBuddy必须用同一个微信账号登录 个人微信接入建议用备用号，主号绑了太多东西 不需要共享的文档建议提前整理到独立账号 授权后可随时通过开关禁用或断开连接器 定期检查连接器状态，确保服务正常运行 撤销授权：QQ邮箱App -> 设置 -> 账号 -> 安全管理 -> 应用授权

第十章 故障排查指南

10.1 连接器配置后显示红色（连接失败）

排查步骤：

1. 确认 command 路径正确（使用绝对路径更可靠）    Windows: C:/Users/xxx/.workbuddy/binaries/python/…    macOS/Linux: /usr/local/bin/python3 2. 验证 Token/API Key 是否有效    curl -H "Authorization: Bearer YOUR_TOKEN" https://your-api.com/test 3. 检查网络连接（远程SSE服务是否可达）    curl https://mcp.your-company.com:8080/health 4. 查看 MCP Server 日志（STDIO模式）    在终端直接运行服务，观察报错    python knowledge_server.py

10.2 AI没有自动调用连接器工具

10.3 内置连接器提示权限不足

解决方案：

1. 断开当前连接器 2. 重新进行OAuth授权 3. 授权时确认勾选所需权限（如「写入」权限默认可能未勾选） 4. 撤销旧授权：    – QQ邮箱：QQ邮箱App -> 设置 -> 账号 -> 安全管理 -> 应用授权    – 腾讯文档：docs.qq.com -> 账号设置 -> 第三方授权管理

10.4 腾讯文档授权后AI找不到文件

原因与解决 原因：腾讯文档权限问题，AI只能访问你有权限的文件 解决：确认目标文件在你的个人空间或有明确共享权限 不在别人的私有空间里

10.5 邮件连接后AI读取很慢

原因与解决 原因：邮件数量太多，AI在全量扫描 解决：描述需求时加上时间范围和关键词限定

优化示例：

读取最近3天来自「@163.com」的邮件中， 标题包含「合同」或「审批」的邮件列表

10.6 自动化任务没有如期执行

原因与解决 原因：WorkBuddy客户端被关闭了 解决：自动化任务需要客户端保持运行 建议在公司电脑上设置「开机自启」 或者把定时任务安排在工作时间内

10.7 连接器频繁失效/断连

第十一章 进阶技巧与避坑指南

11.1 进阶技巧

技巧1：先测试后定时（最重要）

不要直接创建自动化任务。先在对话中手动执行一次Prompt，确认效果满意后再设为定时任务。

技巧2：大文档分章节读取

超大文档注意 内容超过5万字的文档，建议先让AI读取指定Sheet/章节 不要一次性读全文，否则容易超Token上限导致请求失败 复杂嵌套公式的Excel，AI解读时可能出偏差 建议先让AI输出它的理解再执行操作

技巧3：精准描述提升命中率

描述需求时加上时间范围和关键词限定：

不推荐：读取我的邮件 推荐：读取最近3天来自@163.com的邮件中，标题包含「合同」的邮件 不推荐：读取我的文档 推荐：读取腾讯文档「2026项目跟踪表」的Sheet1，统计B列数据

技巧4：连接器 + 自动化 = 无人值守

最省心的玩法——把连接器和自动化任务结合起来，让AI自动定期处理。设置一次，永久受益。

技巧5：多连接器组合使用

早报自动化链路示例： Tavily搜索热点 -> AI整理成简报格式     -> 写入腾讯文档 -> 通过飞书推送链接到工作群     -> 微信推送摘要到个人号 整个过程不需要你参与，每天早上自动跑。

技巧6：定期检查连接状态

养成习惯 每周检查一次连接器状态 绿色圆点是活的才行 如果发现断连，及时重新扫码授权

11.2 避坑指南 – 五大必踩坑

11.3 Prompt质量自查清单

[ ] 是否指定了具体的服务名称？（如「读取腾讯文档中的XXX」而非「读取我的文档」）

[ ] 是否限定了时间范围？（如「最近3天」而非「最近」）

[ ] 是否指定了关键词筛选？（如「标题包含合同」）

[ ] 是否说明了输出格式？（如「按优先级排序」「输出为表格」）

[ ] 是否指定了保存位置？（如「保存为腾讯文档，标题XXX」）

[ ] 是否说明了处理后的操作？（如「追加写入同一文档的Sheet页」）

[ ] 大文件是否指定了读取范围？（如「读取Sheet1的A1:D100」）

第十二章 常见问题FAQ

Q1：连接器是免费的吗？

是的，WorkBuddy 内置连接器全部免费开放，仅需一次授权永久生效。自定义MCP连接器取决于你接入的外部服务是否收费。

Q2：连接器会消耗额外积分吗？

连接器本身不额外消耗积分，但AI处理连接器拉取的数据时会正常消耗Token。大文件读取会消耗更多Token，建议精准描述需求以控制Token用量。

Q3：连接器支持手机端使用吗？

WorkBuddy 网页端、电脑客户端、微信小程序必须登录同一账号，连接器授权信息才会全局同步。手机端可以使用已配置的连接器。

Q4：连接器和技能有什么区别？

连接器负责打通数据通道（从哪里取数据），技能定义拿到数据后做什么（如何处理）。连接器是数据线，技能是驱动程序。

Q5：自定义MCP连接器难吗？

如果你有Python基础，使用FastMCP框架开发一个MCP Server通常只需要几十行代码。关键是写好docstring和类型注解，让AI能理解工具用途。

Q6：连接器断连了怎么办？

检查四点：1.账号是否统一 2.权限是否开放 3.软件版本是否>=4.21 4.网络是否正常。大部分断连问题都是这四个原因导致的。

Q7：可以同时使用多个连接器吗？

可以。建议同时保留3-5个高频使用的连接器。多个连接器可以串联使用，实现端到端自动化工作流。

Q8：连接器数据安全吗？

连接器基于OAuth授权，你随时可以撤销授权。建议遵循最小权限原则，不开放删除权限，定期检查连接器状态。自定义MCP的Token建议使用环境变量管理。

Q9：连接器支持哪些文件格式？

腾讯文档支持Word/Excel/PPT格式的读写；QQ邮箱支持邮件的收发搜索；微云支持云端文件的读写。具体格式取决于连接器类型。

Q10：如何撤销连接器授权？

在WorkBuddy连接器管理页面，点击已连接连接器的启用/禁用开关即可断开。如需彻底撤销授权：QQ邮箱App->设置->账号->安全管理->应用授权；腾讯文档：docs.qq.com->账号设置->第三方授权管理。

附录 速查表

A. 内置连接器速查表

B. 自定义MCP常见配置模板

C. 故障排查速查表

D. 连接器配置顺序建议

普通人优先配置顺序（覆盖80%日常办公需求）：

1. 腾讯文档（最常用，读写云端文档） 2. QQ邮箱（邮件处理） 3. 腾讯会议（纪要提取） 进阶配置（按需添加）： 4. TAPD（项目管理） 5. 腾讯乐享（知识库） 6. 微云（文件存储） 7. 自定义MCP（企业微信/GitHub/Notion等）