在一个 App 下管理多个连接:新增、改名、查看详情、删除。
连接建好之后,都归集在 App 详情页的 已连接的用户 区域。这一页说明怎么管理它们。
在 Apps 页面单击一个 App 卡片进入详情页。页面分两块:
每张连接卡片显示名称、状态和创建时间,例如已连接、创建时间:2026-08-25 14:40:32。
一个 App 下可以建多个连接,互不干扰。常见用法:
单击 已连接的用户 区域的 连接新用户 卡片即可再建一个。流程和第一次连接完全相同。
连接名称是区分同类连接的主要依据,建好之后随时可以改。
单击连接名称右侧的编辑图标,名称变为可编辑状态,改完确认即可。输入框右下角有字数计数,上限 64 个字符。
把鼠标移到连接卡片上,卡片下方出现 详情 与 删除 两个按钮。单击 详情 查看这个连接的完整信息。
删除连接不会删除它使用的身份验证配置,配置仍留在 身份验证配置 列表中,可以给新连接复用。
凭证失效的常见原因是对方系统里的 Token 过期、密钥被轮转,或 OAuth 应用被停用。排查思路见OAuth 2.0 配置与API Key 配置。
找到已有连接
在 Apps 页面单击一个 App 卡片进入详情页。页面分两块:
| 区域 | 内容 |
|---|---|
| 已连接的用户(N) | 该 App 下的全部连接,N 是数量 |
| 可用的工具 | 该 App 生成的工具及各自的入参出参 |
同一个 App 连多个账号
一个 App 下可以建多个连接,互不干扰。常见用法:
| 场景 | 例子 |
|---|---|
| 环境隔离 | 一个 MySQL 连接指向测试库,另一个指向生产库 |
| 内容分区 | 一个文件连接器放产品文档,另一个放内部制度 |
| 账号区分 | 一个语雀连接用团队账号,另一个用个人账号 |
| 权限分级 | 一个连接只读,另一个可写 |
需要身份验证配置的 App,多个连接可以共用同一个配置,也可以各用一个。用不同配置的典型场景是两个账号的凭证不同。
改名
连接名称是区分同类连接的主要依据,建好之后随时可以改。
单击连接名称右侧的编辑图标,名称变为可编辑状态,改完确认即可。输入框右下角有字数计数,上限 64 个字符。
查看详情
把鼠标移到连接卡片上,卡片下方出现 详情 与 删除 两个按钮。单击 详情 查看这个连接的完整信息。
这两个按钮只在鼠标悬停时出现,卡片静止状态下看不到。
删除
1
悬停卡片
把鼠标移到要删除的连接卡片上,等按钮出现。
2
单击删除
单击 删除。控制台弹出确认框,标题是删除已关联的账户,提示为此操作将永久断开该账户的连接。您稍后可以重新连接,但现有的任何配置可能会丢失。
3
确认
确认无误后单击弹窗中的 删除。删除成功后连接从列表中消失。要取消操作,单击 取消。
状态与失效
| 状态 | 含义 | 处理 |
|---|---|---|
| 已连接 | 凭证有效,工具可用 | 无需处理 |
| 已过期 | 凭证失效,工具调用会失败 | 更新身份验证配置中的凭证,然后重建连接 |
不支持的操作
| 操作 | 说明 |
|---|---|
| 修改连接类型 | 创建后不可更改,只能新建 |
| 恢复已删除的连接 | 删除不可撤销,需要重新创建 |