连接管理:数据库、飞书、邮箱、MCP 与 HTTP

将企业内部的数据库、飞书、邮箱、MCP 服务器、GitHub 或 HTTP API 统一登记为受管的「连接」资源——配置与凭据分离、按单个操作逐条授权,既能安全地给 Agent 和函数调用,也能作为知识库的自动同步数据源。

在左侧导航进入连接,即可查看本组织内已登记的全部外部连接,或点击右上角新建连接接入新的外部系统。

ApeMind 连接管理列表页
「连接」管理页:集中展示各类外部连接的类型、可用性状态、授权范围与启用开关。

支持的连接类型

连接类型主要用途鉴权与操作发现
PostgreSQL / MySQL 支撑数据库知识库与自然语言问数,也可供函数执行受管只读 SQL。 独立只读账号密码(支持内网地址与 SSL);内置 schema_overview / validate_sql / execute_sql 等只读受管操作。
飞书 / Lark 作为知识库自动同步数据源,或让 Agent 按需只读查询飞书文档与表格。 企业自建应用 App ID + App Secret(服务端换取令牌);支持「发现操作」自动登记只读工具。
邮箱(IMAP) 专用于知识库只读邮件归档同步(不发信、不修改已读或删除邮件)。 邮箱地址 + 第三方客户端授权码 / 应用专用密码,强制 SSL/TLS 或 STARTTLS。
MCP Server 接入企业内部或第三方 MCP 工具生态,绑定后其工具直接成为 Agent 原生工具。 支持无鉴权、Bearer Token、自定义 Header 或 OAuth(PKCE);通过「发现操作」自动同步远端工具清单。
GitHub 让 Agent 检索代码仓库、Issue、PR 或按审批创建工单。 支持 OAuth 授权或 Personal Access Token;按需选择只读工具集(如 repos、issues)。
HTTP API 对接任意企业内部微服务、工单系统、CRM 或 ERP 接口。 支持无鉴权、Bearer、API Key(Header/Query);可直接粘贴 OpenAPI 3.0 / 3.1(JSON/YAML)一键导入操作目录。

新建连接与安全核验

点击新建连接,选择连接类型并填写主机地址、端口或接口 Base URL 与凭据。在正式保存前,可点击测试连接验证网络连通性与账号认证是否正确。

进入连接详情页的操作区域:数据库、MCP、GitHub 与飞书可点击发现操作拉取可用能力;HTTP 连接可直接导入 OpenAPI 文档或手工添加接口。

出于安全默认原则,新发现的操作(除预设只读外)需由维护者逐条确认并启用。每个操作都明确标注为读操作或写操作;对于写操作,可以配置为「在对话中经人确认」,确保 Agent 发起任何变更前必须得到当前对话者批准。

在连接详情页的访问区域决定可见范围,并按需把连接绑定到具体 Agent(在 Agent 的「资源权限」中勾选)或函数,避免过度暴露。

三档授权与凭据隔离

连接默认设为仅指定成员可见(不向全员暴露),并在详情页按三档精细授权:

授权档位可执行动作典型分配对象
使用(只读) 查看连接可用状态、调用已启用的只读操作。 绝大多数问答 Agent、知识库数据源、普通业务成员。
外部写入 包含只读使用,并允许调用已启用的写操作(仍受「对话确认」策略约束)。 需要建单、回写表格的业务执行 Agent 或审批函数。
维护与授权 修改连接配置与凭据、管理操作目录、启停/删除连接、查看最近调用日志并转授权限。 平台管理员或该外部系统的负责人。

凭据只写不读与目标变更自动清空:填写保存后的密码、Token 与 OAuth 令牌永远不会回显在界面、调用日志或 Agent 对话中;如果有人修改了连接的目标地址(如数据库主机、HTTP Base URL 或 MCP 端点),系统会自动清空已保存的凭据并要求重新输入,彻底杜绝把现有密钥带往恶意地址的风险。

日常运维:停用、最近调用与依赖保护

下一步