飞书 MCP 操控
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/whatevertogo-feishuskill。
技能介绍
飞书 API 与学习成本之间的鸿沟
飞书开放能力分散在多维表格、即时消息、文档与知识库等多条产品线上。若每次都要查接口文档、拼 app_token / chat_id、处理租户令牌与用户令牌差异,自动化脚本和对话式助手都很难稳定落地。
通过 MCP 把自然语言映射成飞书工具调用
FeiShuSkill 以 MCP(Model Context Protocol) 为桥梁,依托官方包 @larksuiteoapi/lark-mcp,由支持 MCP 的客户端(如 Claude Desktop)在后台用 npx 拉起飞书 MCP 服务。你在对话里描述意图,模型会按场景选择工具链,例如:用 bitable_v1_appTableRecord_search 查表后再 bitable_v1_appTableRecord_update 批量改字段;或用 im_v1_message_create 向指定 chat_id 发富文本。
文档中列出的主要能力包括:
- 多维表格:建应用/表/字段,记录的增删改查
- 消息:向群或个人发文本或富文本(机器人须已在群内)
- 群组与联系人:建群、成员与用户信息查询
- 权限:协作者与访问控制相关操作
- 文档与知识库:
docx_builtin_search、wiki_v1_node_search等需 OAuth 且--token-mode user_access_token
凭证侧只需企业自建应用的 App ID(cli_ 前缀)与 App Secret,并在开放平台为 bitable:app、im:message:send_as_bot 等按需开权限。
适用边界与常见坑
默认 租户身份(useUAT: false)创建的资源归应用所有,你可能打不开;需要让 AI 以用户身份(useUAT: true)创建。仅配 --oauth 不足以搜文档,须同时配置用户访问令牌;redirect_uri_mismatch 时在安全设置加入 http://localhost:3000/callback。发群消息失败时先确认机器人已入群,并区分 receive_id_type 用 chat_id 还是个人的 open_id。
使用场景
- 迭代里要根据多维表格筛选条件批量改「状态」列,不想手写 Open API 循环更新
- 周五需从 bitable 拉记录拼成富文本周报,发到指定项目群的 `chat_id`
- 新员工入项时要建群、拉成员,并用邮箱查 `open_id` 核对是否在职
- 产品文档散落在云文档里,已配 OAuth,想在对话里搜 docx 再摘段落给同事
适合人员
- 用飞书多维表格管需求与缺陷的 Scrum Master,希望用一句话查表并改记录
- 维护飞书自建应用与权限清单的 IT 集成同事,要把 MCP 配进 Claude Desktop
- 运营同学每周从表格汇总指标并群发通知,要减少复制粘贴和接口调试
- 已开通 wiki/docx 只读权限的知识管理员,需在助手内搜节点而非仅搜表格