连接飞书与 Lark
使用目标
通过自行配置的 lark-cli 使用云端文档和多维表格。
开始前
准备官方 lark-cli、已授权账号和可用于练习的测试文档。
操作步骤
-
自行安装、配置并登录官方 lark-cli,凭据由 CLI 管理。
-
打开 设置 → AI 连接 → 飞书,启用接入,可选填写原生可执行文件路径和 CLI profile,保存后点击 验证连接。路径留空自动检测。
-
在 MCP 访问权限 中分别开启本机 AI 和 Tunnel 的飞书读取、写入。首次启用本机访问时复制专用连接配置;更新后端后刷新客户端工具清单。
-
让 AI 先读取已安装 CLI 的帮助及内置 Skill,再通过通用读写工具操作文档、多维表格及其他业务。块级编辑支持 XML 标题和富文本结构;文档更新仍需要读取所得版本号。账号验证通过不代表对每个资源都有权限。
-
高风险命令和原始 API 调用还需开启本机或 Tunnel 的独立“高风险操作”开关(默认关闭),并逐次明确确认。关闭读取或写入时,高风险权限也会关闭。
-
附件使用临时文件 ID 分块上传下载;导入已关联目录中的现有文件还需笔记读取权限。升级后刷新工具列表:原四个文档/多维表格工具已替换为 CLI 发现、通用读写和文件传输。
同一 Tunnel 的不同聊天共用该 Tunnel 的已配置权限。LeafLoom 独立校验运行时内部身份,不受聊天连接凭据影响,切换聊天无需刷新权限或重连;关闭资源权限仍会立即撤销访问。
Dev 与安装版共用 Tunnel 配置和生命周期:启用后随应用启动,退出时停止;已有安装版时 Dev 复用其运行文件。共享目录只允许一个受管实例,不要再为同一连接手动运行独立 tunnel-client。MCP 鉴权错误会标明 leafloom_mcp,无需重新授权飞书。读取多维表格时应使用表列表返回的真实 ID,不直接采用链接中未经确认的 table 参数。
状态会区分未安装/不兼容、未配置、未登录、登录失效和网络异常。在外部完成配置或重新授权后再次验证。云端操作需要联网,按请求向调用的 AI 返回内容,不会自动导入或索引到本地知识库。详见能力与限制。
完成后的表现
连接状态与读写权限分别可见;云端内容不会自动成为本地笔记。
没有成功时
账号验证通过不等于拥有每个资源的权限;超时或部分成功后先读取结果。