# Feishu Doc MCP

> Call Feishu document MCP tools to fetch, search, create, update Feishu docs, or manage comments. Use when the user provides Feishu wiki/doc URLs (*.feishu.cn), asks to read/create/update Feishu docs, fetch API docs from Feishu, search Feishu content, or view/add document comments.

- Skill: `darknessomi/feishu-doc-mcp` (Agent Skill)
- Install (CLI): `npx skillmds@latest add darknessomi/feishu-doc-mcp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/darknessomi/feishu-doc-mcp/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: darknessomi (https://skillmd.com/u/darknessomi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/darknessomi/feishu-doc-mcp

---

# 调用飞书文档 MCP

通过 `call_mcp_tool` 调用飞书文档 MCP，需指定 `server: "user-feishu-mcp"`（按本地 MCP 配置替换）。

## 调用方式

```json
{
  "server": "user-feishu-mcp",
  "toolName": "<工具名>",
  "arguments": { ... }
}
```

**调用前**：先读取工具 schema 确认参数（`mcps/user-feishu-mcp/tools/<tool-name>.json`）。

## 工具一览

| 操作 | 工具 |
|------|------|
| 搜索云文档 | `search-doc` |
| 查看云文档 | `fetch-doc` |
| 创建云文档 | `create-doc` |
| 更新云文档 | `update-doc` |
| 获取知识空间节点下的云文档列表 | `list-docs` |
| 查看全文评论与划词评论 | `get-comments` |
| 添加全文评论 | `add-comments` |
| 获取文件/图片/画板 Base64 | `fetch-file` |
| 搜索用户（@ 他人前需调用） | `search-user` |
| 获取用户信息 | `get-user` |

## 常用场景

### 1. 读取飞书文档

用户提供 `https://your-org.feishu.cn/wiki/xxx` 或 `https://xxx.feishu.cn/doc/xxx`：

```
call_mcp_tool: server=user-feishu-mcp, toolName=fetch-doc, arguments={ doc_id: "完整URL或文档ID" }
```

`doc_id` 支持 URL 自动解析，无需手动提取 ID。

### 2. 搜索文档

```
call_mcp_tool: server=user-feishu-mcp, toolName=search-doc
arguments: { query: "关键词", filters: { sort_rule: "EDIT_TIME", create_time_relative: "last_7_days" } }
```

**注意**：`owners` 需 open_id，需先 `search-user` 或 `get-user` 获取；时间跨度 ≤ 3 个月。

### 3. 创建文档

```
call_mcp_tool: server=user-feishu-mcp, toolName=create-doc
arguments: { title: "标题", markdown: "## 内容\n\n...", wiki_node: "可选" }
```

`wiki_node` / `wiki_space` / `folder_token` 三选一。

### 4. 更新文档

```
call_mcp_tool: server=user-feishu-mcp, toolName=update-doc
arguments: { doc_id: "文档ID或URL", mode: "append", markdown: "追加内容" }
```

`mode` 可选：`overwrite`、`append`、`replace_range`、`replace_all`、`insert_before`、`insert_after`、`delete_range`。

定位用 `selection_by_title`（如 `## 章节名`）或 `selection_with_ellipsis`（如 `开头...结尾`）。

### 5. 查看评论

```
call_mcp_tool: server=user-feishu-mcp, toolName=get-comments
arguments: { doc_id: "文档ID或URL", comment_type: "all|whole|segment" }
```

`comment_type`：`all` 全部，`whole` 全文评论，`segment` 划词评论。

### 6. 添加全文评论

```
call_mcp_tool: server=user-feishu-mcp, toolName=add-comments
arguments: { doc_id: "文档ID或URL", elements: [{type:"text",text:"..."},{type:"mention",open_id:"ou_xxx"},{type:"link",url:"..."}] }
```

仅支持 text、mention、link。@ 用户需先 `search-user` 获取 open_id。

## 注意事项

- **fetch-doc**：`doc_id` 必填，支持 URL，不能传文章标题
- **search-doc**：需 owners 时需先获取 open_id；时间跨度 ≤ 3 个月
- **create-doc**：正文不要重复 title；`<image>`、`<file>` 仅支持 url，不支持 token
- **update-doc**：优先局部更新（append/replace_range），慎用 overwrite
- **get-comments**：`doc_id` 必填；`comment_type` 可选 all/whole/segment
- **add-comments**：仅支持 text、mention、link；@ 用户需先 search-user 获取 open_id

## 参考

工具 schema 位于 `mcps/user-feishu-mcp/tools/*.json`，内含各工具的参数说明、Hard Rules 和调用示例。