# 连接插件账号与恢复授权

插件需要访问外部系统时，按安装或连接卡片的提示授权相应账号。插件账号授权、手动填写工具凭据和 IM 双向通信是不同流程，应从触发该任务的入口恢复。

## 完成授权

1. 在插件安装或连接卡片中发起授权。
2. 等待授权地址准备完成。显示**正在准备授权**时，先等待页面提供下一步入口。
3. 打开授权页面，检查账号与请求权限，再按外部平台提示确认。
4. 返回 MOI，检查账号连接或授权状态。
5. 回到原任务，确认任务继续执行，并核对实际结果。

## 授权中断后继续

关闭了外部授权页面或安装卡片时，可以重新打开原入口继续原授权流程。先检查现有授权状态，不必反复创建同一连接。

授权页面中的成功提示与原任务完成需要分别确认：返回 MOI 后查看连接状态，再到原对话检查执行进展和结果。

## 凭证过期后重新登录

已连接账号出现凭证过期提示时，使用该账号连接提供的重新登录入口。完成授权后，回到原任务检查是否继续执行；保留原任务的上下文，避免因重复发起任务产生重复写入。

## 排查问题

| 现象 | 检查与处理 |
| --- | --- |
| 一直准备授权 | 保留当前页面提示和操作时间，重新打开原卡片检查状态。 |
| 已在外部平台确认，但 MOI 未显示连接 | 返回原连接卡片检查授权结果，不只看外部页面。 |
| 账号已连接，但执行无权限 | 核对所授权账号及目标对象权限，连接成功不等于拥有所有数据权限。 |
| 工具失败，同时提示执行环境不可用 | 分别检查账号授权和[运行环境](../runtime-environments/index.md)，按具体错误处理。 |

需要手工更换 API Key、Token 或邮箱授权码时，参阅[维护工具与凭证](manage-tools.md)。配置外部 MCP 服务时，参阅[添加自定义 MCP 工具](add-tools.md)。
