SKILL.md
Lark MCP
⚠️ 重要提醒
搜索文档/知识库必须配置 OAuth：
docx_builtin_search→ 需要--oauth
wiki_v1_node_search→ 需要--oauth
否则返回 99991663 错误。配置方法见 installation.md
核心规则
# 工具命名（连字符，非下划线）
✅ mcp__lark-mcp__tool_name
❌ mcp__lark_mcp__tool_name参数结构
path: {app_token, table_id} # URL路径参数
params: {page_size, ...} # 查询参数
data: {fields, ...} # 请求体
useUAT: false # true=用户身份, false=租户身份
## 常见陷阱
content 必须是 JSON 字符串
❌ content: {"text": "hello"}
✅ content: '{"text": "hello"}'
过滤条件 value 必须是数组
❌ value: "已完成"
✅ value: ["已完成"]
创建群组必须指定 owner_id，否则群主为机器人
owner_id: "ou_xxxxx"
参数名差异
docx_builtin_search: search_key # 不是 query
wiki_v1_node_search: query # 不是 search_key
token 类型
wiki_v2_space_getNode: 用 wikcn... # 不能用 doxcn...
docx_v1_document_rawContent: 用 doxcn...
## useUAT 选择
场景
useUAT
创建资源（想让用户可访问）
`true`
搜索文档/知识库
`true`
访问用户私有数据
`true`
查询公共数据
`false`
## 工具速查
类别
工具
文档
消息
`im_v1_message_create`, `im_v1_message_list`
[im.md](https://github.com/whatevertogo/feishuskill/blob/HEAD/lark-mcp/reference/im.md)
群组
`im_v1_chat_create`, `im_v1_chat_list`, `im_v1_chatMembers_get`
[chat.md](https://github.com/whatevertogo/feishuskill/blob/HEAD/lark-mcp/reference/chat.md)
多维表格
`bitable_v1_app_create`, `bitable_v1_appTableRecord_search/create/update`
[bitable.md](https://github.com/whatevertogo/feishuskill/blob/HEAD/lark-mcp/reference/bitable.md)
文档
`docx_builtin_search`, `docx_v1_document_rawContent`, `docx_builtin_import`
[documents.md](https://github.com/whatevertogo/feishuskill/blob/HEAD/lark-mcp/reference/documents.md)
知识库
`wiki_v1_node_search`, `wiki_v2_space_getNode`
[wiki.md](https://github.com/whatevertogo/feishuskill/blob/HEAD/lark-mcp/reference/wiki.md)
## ID 类型
前缀
类型
来源
`ou_`
用户ID
API返回
`oc_`
群聊ID
`im_v1_chat_list`
`bascn`
多维表格
URL中 `base/` 后
`tbl`
数据表
URL参数 `table=`
`doxcn`
文档
搜索结果或URL
`wikcn`
知识库节点
知识库URL
## 快速示例
发送消息
工具: mcp__lark-mcp__im_v1_message_create
data:
receive_id: "oc_xxxxx"
msg_type: "text"
content: '{"text": "消息内容"}'
params:
receive_id_type: "chat_id"
创建群组
工具: mcp__lark-mcp__im_v1_chat_create
data:
name: "群名"
chat_mode: "group"
owner_id: "ou_xxxxx"
user_id_list: ["ou_xxxxx"]
params:
user_id_type: "open_id"
创建多维表格记录
工具: mcp__lark-mcp__bitable_v1_appTableRecord_create
path:
app_token: "bascnxxxxxx"
table_id: "tblxxxxxx"
data:
fields:
文本字段: "值"
单选字段: "选项名"
useUAT: true
搜索文档
工具: mcp__lark-mcp__docx_builtin_search
data:
search_key: "关键词"
count: 10
useUAT: true