腾讯官方 MCP 连接器配置指南

你要解决什么问题

WorkBuddy 要真正干活，得先连上你常用的外部服务。腾讯开放了两个官方 MCP：ima-mcp（知识库）和 agent-mail（智能体邮箱）。本技能把“去哪个页面拿凭证、JSON 里填什么、授权点哪里”整理成一份可照做的清单，省去翻文档和试错的时间。

技能如何工作

ima 知识库 MCP（ima-mcp）

• 能力范围：让 WorkBuddy 搜索、读取、上传 文件到你的 ima 知识库，覆盖个人库 / 共享库 / 订阅库
• 凭证获取：打开 https://ima.qq.com/agent-interface 复制 Client ID 与 API Key
• 配置路径：WorkBuddy → 连接器 → 自定义连接器 → 配置 MCP → 粘贴 JSON，把凭证填入对应字段（或由平台引导授权）

智能体邮箱 MCP（agent-mail）

• 能力范围：代收 / 代发邮件、检索历史邮件
• 配置路径：WorkBuddy → 连接器 → 找到 Agent Mail / 智能体邮箱 → 点击授权登录，平台托管 OAuth，无需手动填 token

验证连接

配置后在连接器状态页查看是否显示 connected。未连接时优先排查：① ima 的 Client ID / Key 是否完整（API Key 末尾有 ==）；② agent-mail 是否完成授权登录；③ 网络是否通畅。

适用边界与注意点

• ima OpenAPI 仅开放增 / 读 / 搜，不支持删除、移动、改名、退订
• 本技能 不存储任何密钥，所有凭证由 WorkBuddy 平台加密管理
• 配置 JSON 里的 endpoint 是腾讯官方公开地址，可放心展示；但 切勿 把 client_id / api_key / token 写进技能文件或聊天
• 用户在各自 WorkBuddy 账号下配置即可，互不干扰