ApeMind 首页RAG 架构场景方案企业部署选型对比安全架构知识图谱Agent 评测文档
English

APEMIND / 开放协议、IM 渠道与数据源连接

把 ApeMind 知识库接入 Cursor、Claude Code、飞书、钉钉、数据库与业务系统

企业知识库只有融入员工与开发者每天使用的工具,才能真正产生复利。ApeMind 对外提供标准开放协议(MCP、OpenAI 兼容接口、A2A 1.0、声明式配置 API 与独立 CLI),支持一键发布至五大企业 IM 渠道和官网气泡,并打通飞书、网站、邮箱与关系型数据库的受控接入。

已核验集成能力矩阵

以下每一项协议、渠道与连接器均已逐条核对 ApeMind 官方文档与源码实现,并明确标注权限与运行边界。

层级协议 / 渠道ApeMind 已核验能力明确边界与安全护栏参考文档
开发者协议内置 MCP Server(/mcp/)基于 Streamable HTTP 的内置 MCP Server,提供 20 个工具覆盖知识检索、原文回读、图谱探索与 Agent 交互,可直接接入 Cursor、Claude Code 或自研 MCP 客户端。通过 Workspace 级 API Key 鉴权,工具可见范围与知识库访问严格限定在密钥所属组织与工作区内。MCP Server
开发者协议OpenAI 兼容接口提供 POST /v1/chat/completions 接口,可直接使用现有 Python / TypeScript OpenAI SDK 调用 ApeMind Agent,支持 SSE 流式输出与多轮对话。使用 Agent 专属 API Key 鉴权,支持范围以文档列明的标准字段与契约为准。OpenAI 兼容接口
开发者协议A2A 1.0 协议通过 /v1/a2a/bots/{bot_id} 暴露私有 Agent Card、JSON-RPC 与 SSE,将 ApeMind Agent 纳入外部多智能体编排框架。A2A v1 当前支持单轮异步任务(单任务内不支持多轮追问或推送通知),且强制 API Key 保护。A2A 1.0 协议
开发者协议声明式配置 API 与独立 CLI通过 metadata + spec 声明式接口管理 Agent、模板与知识库,支持局部更新与预演;配合 apemind CLI 实现自动化脚本与评测闭环。安装独立 CLI 仅用于连接已有 ApeMind 服务端,不会在本地部署后端服务。声明式配置
IM 机器人渠道飞书 / Lark、钉钉、企业微信、Slack、Telegram同一 Agent 可同时绑定五大 IM 平台,支持私聊直接问答与群聊 @机器人自动答疑、话题上下文延续以及分渠道独立监控。持有组织管理权限的 Agent 禁止接入 IM 渠道;需要人工确认的外部写操作在 IM 环境中会被自动安全拦截。IM 机器人接入
网页嵌入与分享免登录链接、网站嵌入气泡与 Agent API Key支持组织内协作分享、生成免登录公开访问链接、嵌入官网客服气泡,以及签发具备三层作用域边界的 Agent 专属 API Key。对外公开分享采用脱敏冻结引用快照,不会暴露内部知识库原文或已撤权文档。访问与嵌入
数据源自动同步飞书知识空间/云盘、公开网站与 IMAP 邮箱支持按日/周/月定时增量同步飞书文档、整站网页与邮箱附件,并在源端文档删除时提供可审阅清理流程。数据源凭据由组织统一托管,源端删除文件不会静默销毁历史快照,需管理员审阅确认。数据源同步
外部工具与数据库PostgreSQL、MySQL、GitHub、外部 MCP 与 HTTP/OpenAPI统一 Connections 管理外部系统凭据与按操作逐条审批授权,涵盖只读数据库知识库、GitHub、远程 Streamable HTTP MCP 与 HTTP/OpenAPI 3.0–3.1。数据库连接强制只读 AST + 只读事务护栏(上限 200 行、256 KiB、30 秒),且仍需提供独立只读数据库账号。连接管理

关于 ApeMind 协议与生态集成的常见问题

如何在 Cursor 或 Claude Code 里直接检索 ApeMind 知识库?

ApeMind 内置 Streamable HTTP MCP Server(路径 /mcp/),提供 20 个内置工具支持知识检索、原文回读与图谱查询。在 Cursor、Claude Code 或其他 MCP 客户端配置服务地址与 Workspace API Key 即可使用。

飞书、钉钉或 Slack 接入是否一定要配置公网回调域名?

飞书 / Lark(长连接模式)、钉钉(Stream 模式)与 Slack(Socket Mode)均无需公网回调 URL,只需私有化集群可发起出向连接即可接收群聊 @ 与私聊消息;企业微信需完成其回调 API 校验。

已有业务系统使用 OpenAI SDK,能否低成本接入 ApeMind?

可以。将现有 Python 或 TypeScript OpenAI SDK 的 Base URL 指向 ApeMind 的 OpenAI 兼容接口(POST /v1/chat/completions),并配置对应 Agent 的 API Key,即可直接获得流式问答与多轮上下文能力。

将知识库 Agent 接入 IM 群聊后,如何防止越权或误触发外部写操作?

ApeMind 禁止拥有组织管理权限的 Agent 绑定 IM 渠道,同时在多人共享的非交互 IM 环境中会自动拦截标记为“需要对话中人工确认”的外部写操作,并建议为群聊机器人仅授权只读知识库与只读连接。

继续阅读

  • ApeMind 企业级 RAG 架构:PDF 解析、Jev 切分与三路 RRF 检索
  • ApeMind 与 Dify、RAGFlow、FastGPT 等 RAG 方案选型对比
  • 安全架构、存储拓扑与凭据权限边界
  • 下载 ApeMind 桌面端与独立 CLI
  • 开发者集成总览文档

把企业知识库无缝接入你的研发与办公链路

签发一个工作区 API Key 接入 MCP 或 OpenAI SDK,或将 Agent 一键发布到飞书、钉钉、企业微信与 Slack 群聊。

进入 ApeMind 工作区