Quartz 4

🔍 搜索

Claude Code 访问飞书文档

7 min read

Claude Code访问飞书文档

📌 Update 20250330: 周末飞书官方推出了cli，可以通过skill的方式接入到cc。相比mcp的方式，功能强大很多，建议参考使用： https://github.com/larksuite/cli

一、背景

飞书文档沉淀了大量内部知识，若能在 AI Agent 中被直接调用与处理，将有助于提升我们的开发效率。

然而由于权限等问题，Claude Code等AI Agent是无法直接访问飞书文档的。好在飞书官方提供了MCP能力，我们可以通过接入MCP的方式，为Claude Code赋予操作飞书文档的能力。

二、接入飞书MCP

官方文档介绍了两种接入的方式，远程调用MCP server和本地调用。第二种方式虽然功能比较强大，但接入流程相对复杂。我们选择第一种方式接入。

首先访问飞书 MCP 配置平台，点击左侧”创建 MCP 服务”

点击”添加工具”，选择飞书文档相关的工具。

本演示仅勾选了飞书文档相关的、比较有限的工具。如果你有其他需求，可以”自定义选择”界面，勾选更多工具。

🥖 2026.02.10 更新: 近期飞书Mcp官方对上述工具列表做了改版，新版的工具变少了很多，仅支持飞书文档，界面如下：

点击右下角”添加”按钮，弹出授权界面

点击”授权”之后，会生成你个人专属的URL，点击”服务器URL”右侧的复制小按钮。

📌 在工程上云上使用Claude Code需要修改飞书域名：http://mcp.feishu.xiaomi.srv/mcp

打开你的终端，输入以下命令添加飞书MCP

本地接入：

# 最后的url地址是你刚刚复制的内容
claude mcp add --transport http mi-feishu --scope user https://open.feishu.cn/mcp/stream/mcp_F9WlFMhEIMASh7-s1PREh-*********
 
# 2026.02.10 更新: 近期飞书Mcp官方对服务器域名做了修改，新的域名请以你在网站上复制粘贴的为准，比如：
claude mcp add --transport http mi-feishu --scope user https://mcp.feishu.cn/mcp/mcp_JD-VvU9z8l_0-*********

工程上云接入（需要注意替换代理域名）

mcp.feishu.cn → mcp.feishu.xiaomi.srv

https → http

claude mcp add --transport http mi-feishu --scope user http://mcp.feishu.xiaomi.srv/mcp/mcp_JD-VvU9z8l_0-*********

执行claude mcp list 查看已创建成功

启动claude code 测试一下，发现已经可以访问飞书文档了。

# 输入提示词
https://mi.feishu.cn/wiki/GDLsw1fxMiMsSLkyF4Dc0D2DnRe 使用mi-feishu mcp 总结文档内容

由于我们使用的飞书文档域名并非官方域名，若希望 Agent 正常调用飞书 MCP，需要在提示词中显式指定”使用 mi-feishu MCP”。

我们还可以创建一个专门用于访问飞书文档的Sub Agent，使其独立处理飞书文档相关问题，从而提升使用体验。

三、创建飞书文档助手Agent（可选）

Claude Code支持创建Sub Agent，来处理特定领域问题。

打开Claude Code，输入/agents， 并选择Create new agent

选择Personal，创建一个对当前用户全局生效的agent。

Project 仅对当前项目目录生效

接下来推荐选择第一项Generate with Claude，让AI辅助你创建

输入你期望创建的agent是什么样的。举例：

创建飞书文档助手，通过mi-feishu MCP访问飞书文档；飞书文档的域名是：https://mi.feishu.cn；飞书文档地址举例：https://mi.feishu.cn/docx/KFT1dhACwoXADhxbynNcRthZn6f

点击确定

模型选择第4项：

选择一个颜色，或者用自动的颜色

点击确定创建成功

测试一下，告诉AI使用刚刚创建的飞书文档助手subagent，Claude Code会将任务委派给这个agent来处理。

下面我们介绍一些使用案例

四、使用案例

4.1 读取API文档，生成测试代码

在Claude Code中输入相关提示词

使用飞书文档助手subagent，读取此api文档，生成python测试代码 https://mi.feishu.cn/docx/KFT1dhACwoXADhxbynNcRthZn6f

可以看到生成了比较完善的代码及说明文档：

4.2 搜索飞书文档

搜索Claude Code 相关文档，获取领域知识

使用mi-feishu mcp，搜索10篇Claude Code相关的飞书文档，给出访问链接

4.3 为项目生成设计文档，并发布到飞书

使用mi-feishu mcp，为本项目生成一个设计文档，发布到飞书

点击生成的链接，可以看到已经将生成的设计文档发布成了飞书文档

4.4 提升飞书文档质量

下面是找错别字的例子

使用mi-feishu mcp，为我找一下这篇文档，有什么错别字: https://mi.feishu.cn/wiki/MIkfw2TJjioBBlkGBiYcuoybnqf

可以看到，Agent帮我发现了本篇文档的错别字

五、总结

本文介绍了 Claude Code 如何接入飞书 MCP，并基于此创建了一个飞书文档 Agent，从而实现对飞书文档的操作。

实际上，飞书 MCP 提供的工具非常丰富，你可以根据自身业务需求灵活扩展，接入更多工具，创建更多垂直领域的 Agent，进一步提升日常开发效率。

常用命令

claude mcp remove mi-feishu

参考文档

飞书MCP官方文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/mcp_integration

飞书MCP tools列表：https://github.com/larksuite/lark-openapi-mcp/blob/main/docs/reference/tool-presets/tools-zh.md

Claude Code MCP：https://code.claude.com/docs/en/mcp

Claude Code SubAgents：https://code.claude.com/docs/en/sub-agents

Graph View