LeafLoom帮助中心

连接飞书与 Lark

使用目标

通过自行配置的 lark-cli 使用云端文档和多维表格。

开始前

准备官方 lark-cli、已授权账号和可用于练习的测试文档。

操作步骤

  1. 自行安装、配置并登录官方 lark-cli,凭据由 CLI 管理。

  2. 打开 设置 → AI 连接 → 飞书,启用接入,可选填写原生可执行文件路径和 CLI profile,保存后点击 验证连接。路径留空自动检测。

  3. 在 MCP 访问权限 中分别开启本机 AI 和 Tunnel 的飞书读取、写入。首次启用本机访问时复制专用连接配置;更新后端后刷新客户端工具清单。

  4. 让 AI 先读取已安装 CLI 的帮助及内置 Skill,再通过通用读写工具操作文档、多维表格及其他业务。块级编辑支持 XML 标题和富文本结构;文档更新仍需要读取所得版本号。账号验证通过不代表对每个资源都有权限。

  5. 高风险命令和原始 API 调用还需开启本机或 Tunnel 的独立“高风险操作”开关(默认关闭),并逐次明确确认。关闭读取或写入时,高风险权限也会关闭。

  6. 附件使用临时文件 ID 分块上传下载;导入已关联目录中的现有文件还需笔记读取权限。升级后刷新工具列表:原四个文档/多维表格工具已替换为 CLI 发现、通用读写和文件传输。

同一 Tunnel 的不同聊天共用该 Tunnel 的已配置权限。LeafLoom 独立校验运行时内部身份,不受聊天连接凭据影响,切换聊天无需刷新权限或重连;关闭资源权限仍会立即撤销访问。

Dev 与安装版共用 Tunnel 配置和生命周期:启用后随应用启动,退出时停止;已有安装版时 Dev 复用其运行文件。共享目录只允许一个受管实例,不要再为同一连接手动运行独立 tunnel-client。MCP 鉴权错误会标明 leafloom_mcp,无需重新授权飞书。读取多维表格时应使用表列表返回的真实 ID,不直接采用链接中未经确认的 table 参数。

状态会区分未安装/不兼容、未配置、未登录、登录失效和网络异常。在外部完成配置或重新授权后再次验证。云端操作需要联网,按请求向调用的 AI 返回内容,不会自动导入或索引到本地知识库。详见能力与限制。

完成后的表现

连接状态与读写权限分别可见;云端内容不会自动成为本地笔记。

没有成功时

账号验证通过不等于拥有每个资源的权限;超时或部分成功后先读取结果。

下一步

查看仓库原文 ↗