AI Agent 实战手册

外观

连接器接入实操 ​

连接器是 WorkBuddy 连接外部工具与数据源的"插头"。本章先用一个比喻讲清底层协议 MCP，再演示如何加载、使用连接器，以及如何自建一个。

一、MCP 是什么：AI 世界的 USB-C ​

**MCP（Model Context Protocol，模型上下文协议）**由 Anthropic 于 2024 年底推出并开源，现已成为 AI 领域最热门的基础设施之一。通俗比喻：MCP 就是 AI 世界的"USB-C 接口"。

为什么需要 MCP ​

过去让一个 Agent 连接外部工具（GitHub、本地文件系统、PostgreSQL、Slack 等），开发者必须为"每个 AI 应用 × 每个工具"写专门的对接代码——10 个应用 × 10 个工具 = 100 个接口（N × M 的集成噩梦）。

有了 MCP，工具开发者只需按标准开发一个"MCP Server"（相当于 USB-C 设备），任何支持 MCP 的 AI 应用只需内置"MCP Client"（相当于 USB-C 接口），就能即插即用。N × M 的复杂工作被简化成 N + M。

三大核心能力 ​

MCP 标准化了三种核心原语：

  • Tools（工具）：允许 AI 执行操作，如运行代码、在 Jira 创建任务、向数据库写入数据。
  • Resources（资源/上下文）：允许 AI 读取外部数据，如获取 Git 文件列表、查询向量库片段，作为回答的上下文。
  • Prompts（提示词模板）：提供预定义的交互模板，让用户或 AI 以标准化方式触发复杂工作流。

架构与安全性 ​

MCP 采用客户端-服务端（C/S）架构：

  • MCP Host：你使用的 AI 宿主应用（IDE、Agent 平台）。
  • MCP Client：Host 内部负责与 Server 保持 1:1 连接的组件。
  • MCP Server：轻量级独立程序，专门暴露特定工具或数据能力。

这种解耦意味着你可以随时替换底层大模型，或随时增加新数据源，而无需重构整个 Agent 系统。MCP 支持通过本地 stdio 或本地 HTTP 通信，敏感数据（本地代码、私有数据库、电商后台）无需上传云端第三方，隐私友好。

二、加载一个连接器 ​

当前已支持 QQ 邮箱、腾讯文档、腾讯乐享、腾讯会议、TAPD 等连接器：

连接器列表

以加载腾讯会议连接器为例：

选择腾讯会议授权配置

三、用一个连接器创建任务 ​

加载后直接用自然语言下指令，例如："帮我创建一个明天下午 3 点的会议，主题'项目讨论'，时长 1h"：

发起会议创建补充参数

创建成功：

创建结果

四、新建自定义连接器 ​

在连接器管理页右上角点"自定义连接器"，按引导配置 MCP（含服务地址、鉴权方式）。注意：自定义连接器的访问范围由用户配置决定，请按需限定最小权限。

自定义连接器入口

本文整理自 AlephAITech/WorkBuddyGuide，遵循 MIT License。转载请保留出处与许可证声明。