从 0 配置 Codex 读写飞书文档,激活你的飞书知识库

这篇教程只解决一个问题：

让 Codex 成功读写你的个人飞书文档内容。

适合个人飞书链接【组织亦可】，例如：

https://my.feishu.cn/docx/xxxx

一、整体流程

一共 5 步：

创建飞书自建应用
配置重定向 URL
开通并发布权限
让 Codex 安装飞书 MCP
OAuth 授权并测试读取文档

二、创建飞书自建应用

打开飞书开放平台：

https://open.feishu.cn/

登录后进入开发者后台，创建一个自建应用。

应用名可以写：

Codex 个人飞书助手

创建完成后，进入应用的：

凭证与基础信息

复制两项：

App IDApp Secret

后面会填到本地配置文件里。

三、配置重定向 URL

进入应用后台的安全设置，添加重定向 URL：

http://localhost:3000/callback

这个地址用于本地 OAuth 授权，必须配置。

四、开通权限并发布

在应用后台进入权限管理，开通下面这些权限

【不想麻烦，可以直接全选文档和多维表格全部权限】

下面中的要搜索添加避免遗漏：

auth:user.id:readoffline_accessdocx:documentdrive:drivesearch:docs:read

权限开通后，记得发布应用。

版本管理与发布

五、让 Codex 安装飞书 MCP

把下面这段提示词发给 Codex：

我想让 Codex 连接我的个人飞书，先实现读取飞书文档内容。请你帮我搜索并安装适合 Codex 使用的飞书/Feishu/Lark MCP。要求：1. 优先使用官方 @larksuiteoapi/lark-mcp。2. 如果本机没有 npm，请帮我安装或使用便携 Node/npm。3. 把 MCP 配置成 Codex 全局可用。4. 凭据放到本地 .env.personal 文件，不要把 App Secret 写进全局配置。5. 安装完成后告诉我在哪里填写 FEISHU_APP_ID 和 FEISHU_APP_SECRET。

Codex 会完成 MCP 安装和本地配置。

六、填写 App ID 和 App Secret

Codex 安装完成后，一般会让你填写一个类似这样的文件：

.env.personal

内容如下：

FEISHU_APP_ID=cli_xxxxxxxxxxxxxFEISHU_APP_SECRET=你的AppSecretFEISHU_DOMAIN=https://open.feishu.cn

其中：

FEISHU_APP_ID 填飞书开放平台里的 App ID
FEISHU_APP_SECRET 填 App Secret
国内飞书用 https://open.feishu.cn

七、让 Codex 发起授权

填好后，把下面提示词发给 Codex：

我已经填好了个人飞书应用的 FEISHU_APP_ID 和 FEISHU_APP_SECRET。请你帮我运行个人飞书 MCP 的 OAuth 登录流程。要求：1. 打开授权链接让我确认授权。2. 如果 3000 端口被占用，请先释放旧的 OAuth 进程后重试。3. 授权完成后检查登录状态。4. 不要输出完整 token 或 App Secret。

浏览器会打开飞书授权页面。

点击确认授权即可。

八、测试读取飞书文档

准备一个个人飞书文档链接，例如：

https://my.feishu.cn/docx/xxxx

然后把下面提示词发给 Codex：

请使用个人飞书 MCP 读取这个飞书文档：【粘贴你的飞书文档链接】要求：1. 从链接中提取 document_id。2. 使用用户身份读取文档正文。3. 只输出读取到的前几行内容用于验证。4. 如果失败，请告诉我是权限问题、账号问题，还是应用配置问题。

如果配置成功，Codex 会读出文档正文。

例如返回：

测试文档用于测试 Codex 能否连接到飞书成功的话你会看到这段内容

到这里，Codex 读取个人飞书文档就配置完成了。

九、后续可以怎么用

成功读取后，就可以直接让 Codex 处理飞书文档：

读取这个飞书文档，帮我总结成一页行动清单。【文档链接】

读取这个飞书文档，帮我改写成公众号文章。并且保存到飞书文档中【文档链接】

核心流程就一句话：

飞书存资料，Codex 读取和加工，再把结果用于写作、总结和执行，同样可以保存到飞书。

— 完 —

如有收货，欢迎关注支持，持续更新，大家一起学习进步！

我是Smaller.孔，6年人工智能专业老学长

专注 Python入门学习 | 深度学习 | AI Agent学习