连接器（Connect-It）

连接器让 Bot 能用上第三方服务（GitHub、Notion 这类）的工具。背后接的是 Connect-It，一个和 Memoh 一起部署的配套服务。所有凭据（OAuth token、API Key）都存在 Connect-It 那边；Memoh 只存一张绑定表——哪个 Bot 绑了哪个连接、工具命名空间叫什么、开没开。

对使用者来说，连接器不是单独安装的东西：它作为应用的组件随 App 一起到达。App 的清单里声明了它用到哪些连接器类型、是否必需；装好后在 Bot 的应用标签页里完成授权即可。本页其余部分是部署方视角——怎么把 Connect-It 跑起来，以及连接背后的机制。

服务端前提

服务端配置了 Connect-It 地址，连接器功能才会出现：

toml

[connect_it]
base_url = ""   # 例如 "http://connect-it:8421"
api_token = ""  # 服务端之间的可信 token

两项留空即关闭该功能。线上环境建议用对应的环境变量（MEMOH_CONNECT_IT_BASE_URL、MEMOH_CONNECT_IT_API_TOKEN）。

一键 Server Deploy 会在全新安装时自动带起一个同机部署的 Connect-It，见 Server Deploy。没配置 Connect-It 时，依赖连接器的 App 组件会显示"连接器不可用"。

授权与管理

装好带连接器的 App 后，Bot 的应用标签页会按组件列出它的连接器，并标注状态：需要授权、可选，或 所有工作区共享。点 去授权 完成绑定——OAuth 走弹窗授权（浏览器拦了弹窗就放行后重试），API Key 则填好凭据字段。

每条连接会显示状态：

状态	含义
已连接	正常，工具对 Bot 可用
等待授权	连接建了但 OAuth 没走完；补完授权，或者断开它
需要重新授权	凭据过期或被撤销，点重新授权
授权失败	上次授权没成功，可再点重新授权重试
不可用	这个连接器类型在当前 Connect-It 侧没有提供
已停用	已停用，工具不会给到 Bot

可以启用 / 停用某条连接而不删掉它；断开连接则把绑定从 Bot 上移除，并且删掉 Connect-It 里存的这条连接（含凭据）——之后使用它的 App 需要重新授权。

工具怎么到 Bot 手上

对话时，Memoh 会把这个 Bot 所有启用且状态正常的连接聚合成一个 MCP 会话，作为工具源给智能体。连接器工具和 workspace、MCP 工具并排出现。

每条连接在绑定那一刻会拿到一个按连接器类型生成的工具命名空间——GitHub 连接是 github，再连一个就是 github-2。命名空间在绑定的整个生命周期内固定不变：之后增删其它连接，不会影响已有连接的工具名。

连接器（Connect-It） ​

服务端前提 ​

授权与管理 ​

工具怎么到 Bot 手上 ​

相关页面 ​

连接器（Connect-It）

服务端前提

授权与管理

工具怎么到 Bot 手上

相关页面