Claude Code接入飞书MCP保姆级教程

飞书MCP的强大之处在于，只需一句话就能让AI自动创建文档、发送群消息、操作多维表格。然而，不少用户在接入Claude Code时，往往会在配置环节遇到阻碍——权限设置搞不定、回调地址遗漏、机器人未加入群聊……其实整个流程只有5个步骤，3分钟即可顺利完成。下面这份保姆级教程配有详细截图，跟着操作就能轻松搞定。

先梳理一下核心要点：整个过程涵盖飞书开放平台的应用创建、权限配置、OAuth回调、应用发布，最后在终端通过一条命令将Claude Code与飞书MCP串联起来。每个环节都有容易忽略的细节，我会把关键提示一一标出，帮你避开常见陷阱。

步骤1：创建飞书应用，添加机器人

登录飞书开放平台（https://open.feishu.cn），使用你的飞书账号进入后台。点击「创建企业自建应用」，填写应用名称和描述——名称可自定义，比如“Claude MCP”，描述填写“用于Claude Code集成飞书功能”。点击创建即可完成。

【截图1：创建应用页面】

步骤2：配置应用权限

进入应用管理页面的「权限管理」，这里需要开通两类关键权限。注意：权限必须一次性配齐，否则后续调用会报错。

聊天相关权限

在“消息与群组”类别中，将所有涉及获取、发送单聊及群组消息、以应用身份发消息、获取群信息等权限全部勾选。不要怕麻烦，全部选中最为稳妥。

【截图2：聊天权限配置】

文档相关权限

在“云文档”类别中，同样全选：查看、编辑、创建云文档，查看云空间信息，查看知识库等。飞书的权限粒度虽然细，但全选不会带来副作用。

【截图3：文档权限配置】

权限配置完成后，点击「创建版本」并提交审核。企业自建应用通常秒过，无需长时间等待。

步骤3：配置OAuth回调地址

在应用管理页面找到「安全设置」，点击「添加重定向URL」，填入：

http://localhost:3000/callback

保存即可。这一步很多人容易忽略，但它是跳转认证的核心——如果不配置，后续浏览器授权将无法成功。

【截图4：OAuth回调地址配置】

步骤4：发布应用

页面上方会有应用发布的提示，只有发布后配置才会生效。注意：发布审批需要管理员权限，如果你自己不是管理员，请找有权限的同事帮忙通过。

步骤5：Claude Code接入飞书MCP

打开终端，执行以下命令。命令中的 你的App_ID 和 你的App_Secret 需要替换为步骤4中获取的实际值——这两个值在应用详情页即可看到。

claude mcp add-json --scope=user lark-mcp '{
  "command": "npx",
  "args": [
    "-y",
    "@larksuiteoapi/lark-mcp",
    "mcp",
    "-a",
    "你的App_ID",
    "-s",
    "你的App_Secret",
    "--oauth"
  ]
}'

执行后会自动打开浏览器，跳转到飞书授权页面，登录并完成授权。授权成功后浏览器会显示成功提示。

【截图5：App ID和Secret页面】

结果展示

配置完成，现在可以在Claude Code中直接调用飞书功能了。

创建飞书文档

输入提示词：

创建一个飞书文档，标题是测试飞书mcp

Claude会自动调用飞书MCP创建文档，并返回文档链接。

【截图6：创建文档演示】

发送群聊消息

输入提示词：

在群聊测试mcp中，发送消息：test

Claude会先找到对应的群聊，然后发送消息。

【截图7：发送群消息演示】

容易踩坑的地方

⚠️ callback务必填写：步骤3的回调地址必须配置，否则跳转登录认证会失败。

⚠️ 机器人需先加入群聊：发送群消息前，一定要把机器人拉进目标群聊，否则无法找到群。

⚠️ 修改后记得重新发布：飞书应用的任何配置修改后，均需重新发布才能生效。

⚠️ 使用用户级别配置：Claude Code的mcp必须配置为用户级别（--scope=user），否则 /mcp 命令无法识别。

总结

5个步骤全部走完，你已经成功打通了Claude Code与飞书的连接。飞书MCP还能操作多维表格，这个功能值得深入挖掘——自动更新数据库、同步任务状态、批量创建文档……应用前景非常广阔。希望这份教程能帮你快速上手，少走弯路，顺利开启AI与飞书的高效协作。