GUIDE · 连接器
连接器与 Skill 授权失败排查
Skill 或连接器装好了，任务执行时却提示未授权、连不上，怎么办？
展开本页目录
这篇攻略适合谁
- 任务执行中断，提示连接器未授权或缺少权限
- 飞书 / 腾讯会议 / 外部 API / MCP 数据源连接不上
开始前的准备
- 知道你要用的 Skill 名称，以及它依赖哪个连接器（见第 7 章连接器清单）
- 按官方要求准备凭据：飞书应用凭证、Token 等，密钥一律走环境变量，不写进对话
- 准备一个最小的验证任务，例如只读一个目录或查一条数据
排查顺序：先装没装，再授权，再凭据
- 确认 Skill 已安装在 Skill 管理里确认目标 Skill 存在且已启用；没有就先按第 5 章的方法安装。
- 确认连接器已授权打开连接管理器，找到对应连接器（如飞书、腾讯会议），确认处于已授权状态；未授权就按提示完成授权。
- 确认凭据与权限范围飞书类应用核对 App ID / Secret 与所需权限范围；Token 类凭据按官方要求放在环境变量，不写进对话。
- 用最小任务验证派一个只读的最小任务（读一个目录、查一条数据），确认链路通了再上真实任务。
- 记录错误信息保留连接器名称、错误文案和发生时间；授权类错误通常在重试前需要先补权限。
四类连接的检查点
| 连接类型 | 常见失败 | 先检查什么 |
|---|---|---|
| 飞书 | 未授权、权限范围不足、应用未发布 | App 凭证是否有效、权限范围是否覆盖要读写的对象、应用版本是否发布 |
| 腾讯会议 | Token 未配置、无录制查看权限 | Token 是否按官方要求放环境变量、当前账号是否有目标会议的权限 |
| 外部 API | 地址或密钥错误、超时 | Base URL 与密钥是否正确、服务是否可达、是否需要代理 |
| MCP 数据源 | 依赖的数据源未配置 | 数据源服务是否先配置好，再配置 Skill |
安全边界
- 密钥一律走环境变量或官方要求的配置方式，不进对话、不进截图
- 无权限时停止读取并返回所需授权，不尝试绕过
- 涉及企业数据时遵守所在组织的数据和隐私要求
版本说明：功能与界面可能随更新变化
- 资料整理于 2026-09-21，参考资料保存于 2026-09-20。
- 以下内容尚未逐项确认，请以当前应用为准：连接器清单；授权入口。
确认问题已解决
- 最小验证任务能跑通，返回真实数据而不是报错
- 凭据保存在环境变量或官方要求的配置处，没有出现在对话或截图里
- 排错记录保留了连接器名称、错误信息和时间，方便复查
容易遇到的问题
- 把「已安装 Skill」当成「已授权连接器」——两步缺一不可
- 把 Token、密钥直接粘贴到对话里——应使用环境变量等官方要求的方式保存
- 权限范围不够就反复重试——先核对所需的读写权限再重试
- 用大任务做首次验证——失败原因难以定位，先用最小任务
关联内容
其他攻略：自动化任务失败排查 · 下载安装与登录问题排查