飞书文档 MCP 接入指南

本文档说明如何在支持 MCP（Model Context Protocol）的 AI 工具中接入飞书官方 MCP，实现直接读取飞书文档、Wiki 知识库，以及在指定目录创建文档的能力。

一、基本信息

MCP 包名：@larksuiteoapi/lark-mcp

官方仓库：https://github.com/larksuite/lark-openapi-mcp

飞书应用 App ID：cli_axxxxxxxxxxxxxxx

飞书应用 App Secret：xxxxxxxxxxxxxxx（敏感信息，请勿提交到公开仓库）

二、前置条件

Node.js >= 18（推荐 v22）
已安装 npx（随 npm 自带）
使用任意支持 MCP stdio 协议的 AI 工具（Cursor、Claude Desktop、Kiro、Continue 等）

三、MCP 配置

所有支持 MCP 的工具，配置格式基本一致，核心配置如下：

JSON 复制代码

{
  "mcpServers": {
    "lark-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@larksuiteoapi/lark-mcp@latest",
        "mcp",
        "--app-id", "cli_xxxxxx",
        "--app-secret", "xxxxxx",
        "--token-mode", "tenant_access_token",
        "--tools", "preset.default,wiki.v2.spaceNode.create,wiki.v2.spaceNode.moveDocsToWiki,wiki.v2.spaceNode.move,docx.v1.documentBlockChildren.create,docx.v1.documentBlock.patch,docx.v1.documentBlock.get,docx.v1.documentBlockChildren.get"
      ]
    }
  }
}

各工具配置文件路径

Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）
Cursor：~/.cursor/mcp.json 或项目根目录 .cursor/mcp.json
Kiro：~/.kiro/settings/mcp.json（全局）或项目 .kiro/settings/mcp.json
Continue：~/.continue/config.json 中的 mcpServers 字段
Windsurf：~/.codeium/windsurf/mcp_config.json

四、开启 Wiki 目录创建能力（关键配置）

lark-mcp 默认只开启 preset.default 工具集，不包含 wiki 节点创建 / 移动接口，以及文档块级读取、追加、编辑接口。通过在 args 中加入 --tools 参数可以额外开启，实现直接在指定 wiki 目录下创建文档，并支持后续按块读写文档内容。

改动说明

在 mcp.json 的 lark-mcp args 数组末尾加入以下两项，其中第二项为完整工具串：

JSON 复制代码

"--tools",
"preset.default,wiki.v2.spaceNode.create,wiki.v2.spaceNode.moveDocsToWiki,wiki.v2.spaceNode.move,docx.v1.documentBlockChildren.create,docx.v1.documentBlock.patch,docx.v1.documentBlock.get,docx.v1.documentBlockChildren.get"

新增七个工具说明

wiki.v2.spaceNode.create：在指定 wiki 节点下直接创建子文档（无需移动，一步到位）
wiki.v2.spaceNode.moveDocsToWiki：将普通云文档移入 wiki 知识库指定节点
wiki.v2.spaceNode.move：在 wiki 内部移动节点位置
docx.v1.documentBlockChildren.create：向指定文档块下追加子块，适合 AI 连续写入段落、列表、代码块等内容
docx.v1.documentBlock.patch：更新已有文档块内容，适合修订、替换或补写既有文档片段
docx.v1.documentBlock.get：读取单个文档块详情，便于精确定位目标块并确认当前内容
docx.v1.documentBlockChildren.get：读取指定块的子块列表，便于遍历章节结构、查找插入点和确认层级关系

前置条件

目标 wiki 节点需将飞书应用（cli_aa847619b7781cc2）添加为「可管理」协作者
配置修改后需重启编辑器或在 MCP Server 面板重连 lark-mcp 才能生效

五、已开通的飞书应用权限

以下权限已申请并发布，无需重复申请：

wiki:wiki:readonly --- 读取知识库 / Wiki
wiki:wiki --- 创建、编辑、移动 Wiki 节点（含 spaceNode.create / moveDocsToWiki / move）
docx:document:readonly --- 读取新版飞书文档
docx:document --- 创建、编辑新版飞书文档
docs:doc:readonly --- 读取旧版飞书文档
drive:drive:readonly --- 读取云盘文件
drive:file --- 管理云盘文件（移动、删除、权限）
bitable:app --- 读写多维表格
im:message --- 发送消息
im:message:send_as_bot --- 以机器人身份发消息

如需申请其他权限，访问：https://open.feishu.cn/app/cli_aa847619b7781cc2/auth

六、lark-mcp 支持的全量工具分类

lark-mcp 内置超过 600 个工具，覆盖飞书全产品线。默认 preset.default 只开启常用工具子集，可通过 --tools 参数按需开启。

文档类（docx / docs / drive / wiki）

docx.v1.document.create / get / rawContent / convert --- 文档创建、读取、转换
docx.v1.documentBlock.* --- 文档块操作（增删改查）
drive.v1.file.* --- 云盘文件管理（移动、复制、删除、上传）
drive.v1.permissionMember.* --- 文档权限管理
wiki.v2.spaceNode.create / move / moveDocsToWiki / copy / list --- Wiki 节点操作
wiki.v2.space.* --- Wiki 空间管理

消息类（im）

im.v1.message.create / reply / update / delete / list --- 消息发送与管理
im.v1.chat.create / get / list / update --- 群组管理

其他模块

bitable.* --- 多维表格（App、Table、Record、Field、View）
contact.v3.user.* / department.* --- 通讯录用户与部门管理
calendar --- 日历与日程管理
task.v2 --- 任务管理
sheets.v3 --- 电子表格操作
hire / corehr / performance --- 招聘、人事、绩效
vc --- 视频会议； okr --- OKR 管理

完整工具列表查看命令：

Bash 复制代码

npx @larksuiteoapi/lark-mcp@latest mcp --help

七、常见问题

Q: 报错 99991672 Access denied

权限未开通或应用未发布新版本。检查飞书开放平台 → 权限管理，确认所需权限已申请，并在版本管理中发布新版本。

Q: 创建文档后无法移动到 wiki 目录

原因：普通 import 接口不支持指定目标目录，且应用创建的文档归属应用所有，个人账号无法移动。解决方案：使用 wiki.v2.spaceNode.create 直接在目标节点下创建，无需移动。

Q: 新增工具后 AI 仍无法调用

修改 mcp.json 后需重启编辑器或在 MCP Server 面板手动重连 lark-mcp。

八、相关链接

飞书开放平台应用管理：https://open.feishu.cn/app/cli_aa847619b7781cc2
lark-openapi-mcp 官方仓库：https://github.com/larksuite/lark-openapi-mcp
MCP 协议说明：https://modelcontextprotocol.io

九、MCP 更新功能测试

✅ MCP 更新功能验证成功。本条目由 AI 通过 tenant_access_token 调用 docx.v1.documentBlockChildren.create 接口写入，再通过 docx.v1.documentBlock.patch 接口修改，验证应用身份对自身创建的文档同时具备「追加」和「编辑」权限。测试时间：2026-05-28