# 飞书项目 MCP 工具完整目录（48 Tools）

## 🔍 查询/搜索（32 Tools）

| # | 工具名 | 描述 |
|---|--------|------|
| 1 | `search_project_info` | 空间名→project_key，验证空间存在 |
| 2 | `search_user_info` | 批量查询用户基础信息，姓名/邮箱→userkey |
| 3 | `search_by_mql` | MQL高级搜索跨空间工作项 |
| 4 | `search_view_by_title` | 视图名模糊查询视图ID（需view_scope+key_word） |
| 5 | `list_todo` | 我的待办/已办（按空间、action筛选） |
| 6 | `list_workitem_types` | 空间的工作项类型列表 |
| 7 | `list_workitem_field_config` | 工作项字段配置 |
| 8 | `list_workitem_role_config` | 工作项角色配置 |
| 9 | `list_workitem_comments` | 工作项评论列表 |
| 10 | `list_workitem_relations` | 工作项关联关系 |
| 11 | `list_project_team` | 空间团队列表 |
| 12 | `list_team_members` | 团队成员和角色 |
| 13 | `list_schedule` | 人员排期与工作量（支持多人多类型聚合） |
| 14 | `list_related_workitem` | 关联工作项查询 |
| 15 | `list_deliverables` | 交付物溯源（根工作项+来源工作项） |
| 16 | `list_charts` | 空间视图下的度量图表列表 |
| 17 | `list_node_field_config` | 节点字段配置 |
| 18 | `list_element_template` | 资源节点/任务模板 |
| 19 | `list_wbs_draft_rows` | 计划表草稿行数据 |
| 20 | `list_wbs_instance_rows` | 计划表正式行数据 |
| 21 | `list_multi_project_view_workitems` | 全景视图跨空间工作项 |
| 22 | `get_workitem_brief` | 按ID/名查工作项概况 |
| 23 | `get_workitem_op_record` | 工作项操作记录 |
| 24 | `get_workitem_man_hour_records` | 工时登记记录 |
| 25 | `get_workitem_field_meta` | 创建工作项必填字段元信息 |
| 26 | `get_node_detail` | 节点详情（子项、字段、状态） |
| 27 | `get_view_detail` | 视图下工作项列表 |
| 28 | `get_chart_detail` | 度量图表详情数据 |
| 29 | `get_transitable_states` | 可流转目标状态列表 |
| 30 | `get_transition_required` | 流转必填信息 |
| 31 | `get_resource_work_item_type_conf` | 资源库配置详情 |
| 32 | `get_wbs_draft_operation_progress` | 计划表草稿操作进度 |

## ✏️ 创建/编辑/流转（13 Tools）

| # | 工具名 | 描述 |
|---|--------|------|
| 33 | `create_workitem` | 创建工作项（需先获取字段/角色配置） |
| 34 | `create_fixed_view` | 创建固定视图 |
| 35 | `create_resource_work_item` | 创建资源库模板 |
| 36 | `create_wbs_draft` | 创建计划表草稿 |
| 37 | `update_field` | 更新字段值/角色（一次多字段） |
| 38 | `update_node` | 修改节点（负责人/排期） |
| 39 | `update_node_subtask` | 子任务CRUD |
| 40 | `update_fixed_view` | 更新视图工作项列表 |
| 41 | `transition_node` | **节点流转** — action: "confirm"(通过) / "rollback"(回退) |
| 42 | `transition_state` | 状态流转（缺陷等状态流工作项） |
| 43 | `add_comment` | 添加评论（支持@人、markdown、附件） |
| 44 | `edit_wbs_draft` | 编辑计划表草稿行（原子操作） |
| 45 | `publish_wbs_draft` | 发布计划表草稿为正式 |

## 📁 附件/其他（3 Tools）

| # | 工具名 | 描述 |
|---|--------|------|
| 46 | `upload_file` | 上传附件 |
| 47 | `get_download_url` | 附件下载链接 |
| 48 | `reset_wbs_draft` | 重置计划表草稿 |

## 已知项目空间和类型

### 项目空间
| project_key | 名称 | simple_name |
|-------------|------|-------------|
| `6593cd71471290e3cc6be6e6` | 销售管理 | xsguanli |
| `658bb60520ea78a2125f1b99` | 客户项目管理 | csrw |
| `658288abfb8bd616b17025f1` | 售后管理 | br-shgl |

### 工作项类型
| type_key | 名称 | 所属空间 |
|----------|------|---------|
| `story` | 商机 | 销售管理/客户项目管理 |
| `6669433056a98249604376de` | 客户反馈单 | 售后管理 |
| `658bc2e62f7a609dbd1bf0b8` | 项目 | 客户项目管理 |
| `issue` | 缺陷 | 销售管理 |
| `sub_task` | 任务 | 销售管理 |

## 连接配置

```yaml
mcp_servers:
  feishu-project:
    url: https://project.feishu.cn/mcp_server/v1
    transport: sse
    headers:
      X-Mcp-Token: "m-xxxxxxxxxx"
```

**关键注意事项**：
- Feishu MCP 使用 **SSE 传输**（非 Streamable HTTP），必须设置 `transport: sse`
- `transition_node` 的 `action` 只能是 `"confirm"` 或 `"rollback"`
- `list_todo` 返回的 `node_name` 是流程标签，不一定是当前实际阻塞节点，需 `get_node_detail` 确认
- `search_view_by_title` 需要同时传 `view_scope` 和 `key_word` 两个参数