Feishu MCP Pro功能总览及用户使用指南
概述
功能总览
Feishu MCP Pro 包含 13 个功能模块：
| 模块 |
工具数 |
核心能力 |
| 📊 多维表格 |
16 |
元数据查询、记录增删改查、批量操作（500条/次）、高级筛选排序、字段管理、视图创建 |
| 📈 电子表格 |
27 |
创建表格、工作表管理、单元格读写、批量读写、追加行数据、查找替换、行列增删插入、合并拆分、样式设置、内容清除、筛选器管理 |
| 📄 文档读写 |
4 |
读取、创建、覆写、追加飞书云文档。写入时支持扩展 Markdown：Mermaid 流程图、Callout 高亮块、多列布局、富文本表格、图片嵌入等 |
| 📐 文档表格操作 |
5 |
插入/删除行列、合并单元格，精准操控飞书文档中的表格结构 |
| 📚 知识库 |
8 |
浏览知识空间与节点列表、创建知识库页面、移动/复制/重命名节点、将云文档迁入知识库 |
| 📁 云盘 |
7 |
浏览文件夹、查看文件信息、创建文件夹、移动文件、删除文件、复制文件、创建快捷方式 |
| 🔒 权限 |
3 |
查看协作者、添加协作者（支持邮箱）、移除协作者 |
| 🔍 搜索 |
1 |
按关键词、作者、时间范围搜索飞书文档 |
| 💬 评论 |
2 |
查看文档评论（全文/划词）、添加评论（支持 @人和超链接） |
| 👤 用户 |
3 |
获取用户信息、通过 open_id / 邮箱 / 中文姓名智能解析用户、支持批量解析 |
| 📅 日历 |
12 |
查看日历列表、创建/编辑/删除日程、搜索日程、管理参会人、回复日程邀请、查询忙闲状态 |
| ✅ 任务 |
14 |
创建/编辑/完成/删除任务、子任务管理、添加与移除成员、任务列表的创建/查看/删除 |
| 🖼️ 媒体 |
1 |
下载文档中的图片和白板内容，支持 Base64 输出 |
一、多维表格管理（16 个工具）
多维表格模块是覆盖最广的功能，提供从元数据查询、记录增删改查到批量操作、视图管理的完整能力链。支持直接传入 /base/ 或 /wiki/ 格式 URL。
1.1 获取表格元数据
- 工具：
bitable_get_meta
- 功能：查看多维表格中包含哪些数据表及各表基本信息
- 示例：
这个多维表格里有哪些数据表？https://*.feishu.cn/base/XXX
- 返回：app_token、每个数据表的 table_id 和名称
- URL 智能解析：支持
/base/XXX 和 /wiki/XXX 两种格式
1.2 查看字段定义
- 工具：
bitable_list_fields
- 功能：获取数据表的所有字段（列）定义，包含字段名称、字段类型和是否为主键
1.3 查询记录
- 工具：
bitable_list_records、bitable_get_record
- 功能：
bitable_list_records：分页列出记录，支持按视图筛选bitable_get_record：根据 record_id 获取单条记录详情
1.4 高级搜索与筛选
- 工具：
bitable_search_records
- 功能：按字段值进行条件筛选，支持排序和指定返回字段
- 筛选语法：
| 语法 |
含义 |
示例 |
| 字段=值 |
精确匹配 |
状态=进行中 |
| 字段!=值 |
不等于 |
状态!=已关闭 |
| 字段>数值 / 字段<数值 |
数值比较 |
分数>80 |
| 字段~关键词 |
模糊匹配 |
标题~登录 |
| 字段? |
字段不为空 |
— |
| 字段!? |
字段为空 |
— |
多个筛选条件之间自动以 AND 逻辑组合。
1.5 创建和更新记录
- 工具：
bitable_create_record、bitable_update_record
- 智能转换：
- 人员字段：直接传入企业邮箱（如 zhangsan@example.com），自动解析为飞书 open_id
- 日期字段：直接传入 YYYY-MM-DD 格式，自动转换为飞书时间戳
1.6 删除记录
- 工具：
bitable_delete_record
- ⚠️ 删除操作不可恢复
1.7 批量操作
- 工具：
bitable_batch_create、bitable_batch_update、bitable_batch_delete
- 单次上限 500 条
- 批量更新流程：先用
bitable_search_records 筛选目标记录 → 再用 bitable_batch_update 一次性更新
1.8 创建多维表格与数据表
- 工具：
bitable_create_app、bitable_create_table
1.9 字段管理
- 工具：
bitable_create_field
- 支持文本、数字、单选、多选、日期、人员、复选框等 15+ 种字段类型
1.10 视图管理
- 工具：
bitable_list_views、bitable_create_view
- 支持视图类型：
| 类型 |
说明 |
| grid |
表格视图（默认），适合数据浏览和编辑 |
| kanban |
看板视图，按某个字段分组展示卡片 |
| gallery |
画册视图，以卡片形式展示 |
| gantt |
甘特图视图，以时间轴展示任务进度 |
| form |
表单视图，用于数据收集 |
二、电子表格（27 个工具）
电子表格模块提供对飞书电子表格（类 Excel）的全方位操作能力。支持直接传入 /sheets/ 格式 URL。
2.1 获取表格元数据
- 工具：
sheet_meta
- URL 智能解析：支持
/sheets/shtXXX 格式 URL，自动提取 spreadsheetToken
2.2 创建电子表格
- 工具：
sheet_create
- 支持指定存放文件夹
2.3 工作表管理
- 工具：
sheet_list_sheets、sheet_add_sheet、sheet_delete_sheet、sheet_copy_sheet、sheet_rename
- ⚠️ 删除工作表不可恢复
2.4 读取数据
- 工具：
sheet_read、sheet_read_batch
- 范围格式：
<工作表名或sheetId>!<起始单元格>:<结束单元格>，如 Sheet1!A1:D10
- 渲染选项：
render_option 参数可选 FormattedValue（默认）、UnformattedValue（原始值）、Formula（公式文本）
2.5 写入与追加数据
- 工具：
sheet_write、sheet_write_batch、sheet_append
sheet_write：覆盖指定范围sheet_append：在工作表已有数据末尾追加新行
2.6 查找与替换
- 工具：
sheet_find、sheet_replace
2.7 行列操作
- 工具：
sheet_add_rows、sheet_add_cols、sheet_insert_rows、sheet_insert_cols、sheet_delete_rows、sheet_delete_cols
- 位置编号：行列位置使用 0 起始索引，第 1 行对应索引 0，删除范围为左闭右开区间 [start, end)
2.8 单元格操作
- 工具：
sheet_clear、sheet_merge、sheet_unmerge、sheet_style
- 样式参数：
| 参数 |
说明 |
可选值 |
| bold |
加粗 |
true / false |
| italic |
斜体 |
true / false |
| fontSize |
字号 |
如 "12" |
| hAlign |
水平对齐 |
LEFT、CENTER、RIGHT |
| vAlign |
垂直对齐 |
TOP、MIDDLE、BOTTOM |
| bgColor |
背景颜色 |
如 "#CCE5FF" |
| foreColor |
字体颜色 |
如 "#FF0000" |
| formatter |
数字格式 |
如 "0.00"、"0.00%" |
| clean |
清除样式 |
true |
2.9 数据筛选
- 工具：
sheet_filter_create、sheet_filter_get、sheet_filter_delete
三、文档操作（4 个工具）
提供飞书文档的读取、创建、内容覆写和末尾追加四项核心操作。v0.5.0 起新增扩展 Markdown 支持：Mermaid 流程图（自动渲染为画板）、Callout 高亮块、Grid 多列布局、富文本表格、图片嵌入等。
3.1 读取文档内容
- 工具：
doc_read
- 返回：文档标题、全文纯文本、document_id、版本号
3.2 创建文档
- 工具：
doc_create
- Markdown 转换能力：标题、段落、列表、表格、代码块、引用块、分割线
- 飞书扩展格式：
- Mermaid 流程图 — 支持 flowchart、sequence、class、ER、state、mindmap 等
- Callout 高亮块 — 自定义 emoji 和背景色
- Grid 多列布局 — 左右分栏
- 富文本表格 — 单元格内支持嵌套列表、代码块等
- 图片嵌入 — 网络图片 URL 自动上传
3.3 覆写文档
- 工具：
doc_write
- ⚠️ 覆写不可逆：会清空所有现有内容块（包括图片、画板等）。如只需修改局部，建议用"追加"或手动编辑。
3.4 追加内容
- 工具：
doc_append
- 最安全的文档写入方式，不影响已有正文
四、文档搜索（1 个工具）
- 工具：
search_docs
- 支持按关键词、作者、创建时间、打开时间等维度筛选，支持多种排序方式和分页
- 排序参数：
| 排序参数 |
说明 |
| open_time |
按最近浏览时间排序（默认） |
| edit_time |
按最近编辑时间倒序 |
| edit_time_asc |
按编辑时间正序（最早优先） |
| create_time |
按创建时间排序 |
五、知识库管理（8 个工具）
5.1 列出知识库空间
5.2 浏览知识库文档树
- 工具：
wiki_list_nodes
- 配合
has_child 字段可递归展开完整文档层级
5.3 获取节点信息
5.4 创建知识库页面
- 工具：
wiki_create_node
- 默认创建飞书文档（docx），也支持 sheet 和 bitable 类型
5.5 移动节点
5.6 复制节点
5.7 重命名节点
5.8 将云文档迁入知识库
- 工具：
wiki_move_docs_to_wiki
六、云盘文件管理（7 个工具）
6.1 浏览云盘目录
- 工具：
drive_list
- 支持分页（默认 20 条，最大 200 条）
6.2 获取文件详情
6.3 创建文件夹
6.4 移动文件
6.5 复制文件
6.6 创建快捷方式
6.7 删除文件
七、权限管理（3 个工具）
支持 doc、docx、sheet、bitable、file、wiki、mindnote、minutes、slides 等多种资源类型。
7.1 查看协作者列表
7.2 添加协作者
- 工具：
perm_add
- 直接支持企业邮箱地址，无需手动查找用户 ID
- 权限级别：
| 权限 |
说明 |
| view |
仅查看 |
| edit |
可编辑 |
| full_access |
完全控制（含管理协作者权限） |
7.3 移除协作者
八、评论管理（2 个工具）
8.1 查看评论
- 工具：
comment_list
- 筛选选项：
all（所有）、whole（全文评论）、segment（划词评论）
- 返回评论类型、评论者、内容、是否已解决、回复列表。划词评论还包含引用的原文片段。
8.2 添加评论
九、用户信息查询（3 个工具）
9.1 获取用户信息
- 工具：
user_info
- 不传参数返回当前登录用户信息，传入 open_id 返回指定用户信息
9.2 智能用户解析
- 工具：
user_resolve
- 支持 open_id、企业邮箱、中文姓名自动识别
- 输入类型智能判断：
ou_xxx → open_id，xxx@example.com → 邮箱，中文 → 姓名搜索
9.3 批量用户解析
- 工具：
user_resolve_batch
- 支持混合输入，一次解析多个用户标识
十、日历管理（12 个工具）
10.1 查看日历列表
10.2 获取主日历
10.3 创建日程
- 工具：
calendar_event_create
- 时间格式：RFC3339
10.4 查看日程详情
10.5 列出日程
10.6 编辑日程
10.7 删除日程
10.8 搜索日程
10.9 回复日程邀请
- 工具：
calendar_event_reply
- 支持 accept / decline / tentative
10.10 添加参会人
- 工具：
calendar_event_attendees_add
10.11 查看参会人
- 工具：
calendar_event_attendees_list
10.12 查询忙闲状态
十一、任务管理（14 个工具）
11.1 创建任务
- 工具：
task_create
- 截止日期格式支持
YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss
11.2 查看任务详情
11.3 列出任务
11.4 编辑任务
11.5 完成任务
11.6 删除任务
11.7 添加任务成员
11.8 移除任务成员
11.9 创建子任务
11.10 查看子任务
11.11 将任务加入任务列表
11.12 创建任务列表
11.13 查看任务列表
11.14 删除任务列表
十二、文档表格操作（5 个工具）
📌 本模块操作的是飞书云文档（docx）中嵌入的表格，不是多维表格（bitable）或电子表格（sheet）。
| 工具 |
功能 |
docx_table_insert_row |
在文档表格中插入行 |
docx_table_insert_column |
在文档表格中插入列 |
docx_table_delete_rows |
删除文档表格中的行 |
docx_table_delete_columns |
删除文档表格中的列 |
docx_table_merge_cells |
合并文档表格中的单元格 |
十三、媒体下载（1 个工具）
- 工具：
media_download
- 功能：下载文档中嵌入的图片或白板内容，返回 Base64 编码数据
- 典型场景：读取文档获取图片 token → 下载图片 → AI 分析图片内容
注意事项
⚠️ 不可逆操作汇总
以下操作执行后无法撤销，请确认目标无误后再执行：
| 工具 |
操作 |
doc_write |
覆写文档（清空全部原有内容，含图片和画板） |
bitable_delete_record / bitable_batch_delete |
删除多维表格记录 |
drive_delete |
删除云盘文件 |
sheet_delete_sheet |
删除电子表格工作表 |
perm_remove |
移除协作者权限 |
task_delete |
删除任务 |
tasklist_delete |
删除任务列表 |
calendar_event_delete |
删除日程 |
权限范围
工具只能操作当前授权用户有权访问的飞书资源。权限不足时需联系资源管理员开通权限。
常见问题
| 问题 |
解答 |
| 认证过期怎么办？ |
工具会自动弹出浏览器重新授权。授权有效期约 30 天，到期后自动引导续期。 |
| 能操作别人的文档吗？ |
只能操作你有权限的文档。没有权限时 AI 会提示你联系文档所有者。 |
| 批量操作有上限吗？ |
多维表格批量操作每次最多 500 条。超过时需分批执行。 |
| 操作失败了能回退吗？ |
飞书文档支持「版本历史」恢复。多维表格和云盘的删除操作不可撤销。 |
| 人员字段怎么填？ |
直接用企业邮箱即可，工具自动将邮箱解析为飞书用户 ID。 |
| 支持 /wiki/ 格式的 URL 吗？ |
完全支持。多维表格的 /wiki/XXX URL 会自动解析为 bitable app_token。 |
| 支持哪些 AI 工具？ |
所有兼容 MCP 协议的工具，包括 Windsurf、Cursor、Claude Desktop、MiCode、OpenCode 等。 |
附录：完整工具速查表
| 模块 |
工具名 |
功能说明 |
| 多维表格 |
bitable_get_meta |
获取多维表格元数据（支持 /base/ 和 /wiki/ URL） |
|
bitable_list_fields |
列出数据表所有字段定义 |
|
bitable_list_records |
分页列出记录 |
|
bitable_get_record |
获取单条记录详情 |
|
bitable_search_records |
条件筛选 + 排序 + 字段选择 |
|
bitable_create_record |
创建记录（邮箱自动解析、日期自动转换） |
|
bitable_update_record |
更新记录 |
|
bitable_delete_record |
删除单条记录 |
|
bitable_batch_create |
批量创建（≤500 条/次） |
|
bitable_batch_update |
批量更新（≤500 条/次） |
|
bitable_batch_delete |
批量删除（≤500 条/次） |
|
bitable_create_app |
创建多维表格应用 |
|
bitable_create_table |
新增数据表 |
|
bitable_create_field |
新增字段（15+ 字段类型） |
|
bitable_list_views |
列出视图 |
|
bitable_create_view |
创建视图（grid/kanban/gallery/gantt/form） |
| 电子表格 |
sheet_meta |
获取电子表格元数据 |
|
sheet_create |
创建新电子表格 |
|
sheet_list_sheets |
列出所有工作表 |
|
sheet_read |
读取指定范围的单元格数据 |
|
sheet_read_batch |
一次读取多个范围的数据 |
|
sheet_write |
将数据写入指定范围 |
|
sheet_write_batch |
一次写入多个范围 |
|
sheet_append |
在工作表末尾追加行数据 |
|
sheet_find |
查找匹配关键词的单元格 |
|
sheet_replace |
批量替换单元格内容 |
|
sheet_rename |
重命名电子表格标题 |
|
sheet_add_sheet |
新增工作表 |
|
sheet_delete_sheet |
删除工作表（不可恢复） |
|
sheet_copy_sheet |
复制工作表 |
|
sheet_add_rows / sheet_add_cols |
在末尾追加空行/空列 |
|
sheet_insert_rows / sheet_insert_cols |
在指定位置插入空行/空列 |
|
sheet_delete_rows / sheet_delete_cols |
删除指定范围的行/列 |
|
sheet_clear |
清除单元格内容（保留样式） |
|
sheet_merge / sheet_unmerge |
合并/拆分单元格 |
|
sheet_style |
设置单元格样式 |
|
sheet_filter_create / get / delete |
筛选器管理 |
| 文档 |
doc_read |
读取文档内容和元数据 |
|
doc_create |
创建文档（支持标准及扩展 Markdown） |
|
doc_write |
覆写文档正文（不可逆） |
|
doc_append |
在文档末尾追加内容 |
| 文档表格 |
docx_table_insert_row |
在文档表格中插入行 |
|
docx_table_insert_column |
在文档表格中插入列 |
|
docx_table_delete_rows |
删除文档表格中的行 |
|
docx_table_delete_columns |
删除文档表格中的列 |
|
docx_table_merge_cells |
合并文档表格中的单元格 |
| 搜索 |
search_docs |
按关键词、作者、时间范围搜索文档 |
| 知识库 |
wiki_list_spaces |
列出可访问的知识库空间 |
|
wiki_list_nodes |
列出知识库子节点 |
|
wiki_get_node |
获取节点详细信息 |
|
wiki_create_node |
创建知识库页面 |
|
wiki_move_node |
移动知识库节点 |
|
wiki_copy_node |
复制知识库节点 |
|
wiki_rename_node |
重命名知识库节点 |
|
wiki_move_docs_to_wiki |
将云文档迁入知识库 |
| 云盘 |
drive_list |
浏览云盘文件和文件夹 |
|
drive_info |
获取文件详细信息 |
|
drive_mkdir |
创建文件夹 |
|
drive_move |
移动文件 |
|
drive_copy_file |
复制文件 |
|
drive_create_shortcut |
创建快捷方式 |
|
drive_delete |
删除文件（不可恢复） |
| 权限 |
perm_list |
查看协作者和权限级别 |
|
perm_add |
添加协作者（支持邮箱） |
|
perm_remove |
移除协作者 |
| 评论 |
comment_list |
查看文档评论（全文/划词/全部） |
|
comment_add |
添加全文评论 |
| 用户 |
user_info |
获取用户信息 |
|
user_resolve |
智能解析用户（open_id / 邮箱 / 中文姓名） |
|
user_resolve_batch |
批量解析多个用户标识 |
| 日历 |
calendar_list |
列出可访问的日历 |
|
calendar_get_primary |
获取主日历信息 |
|
calendar_event_create |
创建日程 |
|
calendar_event_get |
查看日程详情 |
|
calendar_event_list |
列出日程（支持时间范围筛选） |
|
calendar_event_update |
编辑日程 |
|
calendar_event_delete |
删除日程 |
|
calendar_event_search |
按关键词搜索日程 |
|
calendar_event_reply |
回复日程邀请（接受/拒绝/暂定） |
|
calendar_event_attendees_add |
添加参会人 |
|
calendar_event_attendees_list |
查看参会人列表 |
|
calendar_freebusy |
查询用户忙闲状态 |
| 任务 |
task_create |
创建任务 |
|
task_get |
查看任务详情 |
|
task_list |
列出当前用户的任务 |
|
task_update |
编辑任务 |
|
task_complete |
标记任务为已完成 |
|
task_delete |
删除任务 |
|
task_add_members |
添加任务成员 |
|
task_remove_members |
移除任务成员 |
|
task_subtask_create |
创建子任务 |
|
task_subtask_list |
列出子任务 |
|
task_add_to_tasklist |
将任务加入任务列表 |
|
tasklist_create |
创建任务列表 |
|
tasklist_list |
列出所有任务列表 |
|
tasklist_delete |
删除任务列表 |
| 媒体 |
media_download |
下载文档中的图片/白板（Base64 输出） |
