Lark / Meegle MCP 集成¶

Lark（飞书国际版）和 Meegle（飞书项目）的 MCP 配置参考。不包含应用代码。

历史: 这些文档原本在独立的 retaintive/lark repo,2026-05-09 合并进 docs repo 统一维护。studio-产品闭环完整方案.md 移到 product-design/。retaintive/lark repo 已归档。

Files¶

File	Purpose
`setup.md`	Lark 平台 MCP（`@larksuiteoapi/lark-mcp`）完整配置指南：创建应用、配置权限、OAuth 登录、Claude Code 配置

Lark MCP（飞书平台 — 文档、IM、Bitable）¶

已配置在 Claude Code 中，使用 @larksuiteoapi/lark-mcp npm 包，通过 stdio transport 运行。

配置方式见 setup.md。核心工具： - docx_builtin_import — Markdown → 飞书文档 - bitable_v1_* — 多维表格 CRUD - wiki_v1_node_search — Wiki 搜索 - im_v1_* — 群聊和消息

Meegle MCP（飞书项目 — 任务管理）¶

飞书项目官方托管的 MCP Server，使用 Streamable HTTP transport。

Endpoint¶

https://project.larksuite.com/mcp_server/v1?mcpKey={MEEGLE_MCP_KEY}&userKey={MEEGLE_USER_KEY}

Server info: Meego MCP Server v1.0.0, protocol 2025-03-26。

可用 Tools（7 个）¶

Tool	功能	写操作？
`create_workitem`	创建 work item	Yes
`update_field`	更新 work item 字段值	Yes
`finish_node`	完成 workflow 节点	Yes
`get_workitem_brief`	获取 work item 摘要	No
`get_workitem_info`	获取字段和角色配置	No
`get_view_detail`	获取视图实例	No
`get_node_detail`	获取节点详情（含子任务）	No

限速：每个 tool 5 QPS。

配置步骤¶

1. 创建 Meegle Plugin

打开 project.larksuite.com/openapp/home
创建新 Plugin
Plugin Details → Plugin Release → MCP Configuration → 启用 MCP Server
记录生成的 mcpKey
获取 userKey（飞书项目空间中 hover 头像查看）

2. 设置环境变量

在 ~/.zshrc 中添加：

export MEEGLE_MCP_KEY="your-mcp-key-here"
export MEEGLE_USER_KEY="your-user-key-here"

3. 添加到 Claude Code

claude mcp add --transport http meegle \
  "https://project.larksuite.com/mcp_server/v1?mcpKey=${MEEGLE_MCP_KEY}&userKey=${MEEGLE_USER_KEY}"

或在项目 .mcp.json 中配置：

{
  "mcpServers": {
    "meegle": {
      "type": "http",
      "url": "https://project.larksuite.com/mcp_server/v1?mcpKey=${MEEGLE_MCP_KEY}&userKey=${MEEGLE_USER_KEY}"
    }
  }
}

4. 重启 Claude Code

使用注意¶

project_key 参数可以用 space 的域名简称（simpleName），不一定要 projectKey
work_item_id 可以用 work item 名称替代 ID
人员字段值用英文逗号分隔
时间字段需要 16 位 Unix 毫秒时间戳
不支持的字段类型（写操作）：附件、富文本、级联多选、投票、组合字段

Resource	Link
官方 MCP 文档	project.feishu.cn/b/helpcenter/.../jdmql9oj
开发者手册	project.feishu.cn/b/helpcenter/.../73n2upf3
Open API 列表	project.feishu.cn/b/helpcenter/.../wlcwhshe
社区参考（已归档）	github.com/Roland0511/mcp-feishu-proj