# 飞书项目MCP工具速查

## 宝锐飞书项目空间

| 项目 | project_key | simple_name | 用途 |
|------|-------------|-------------|------|
| 销售管理 | `6593cd71471290e3cc6be6e6` | `xsguanli` | 商机跟踪/客户活动（story类型） |
| 客户项目管理 | `658bb60520ea78a2125f1b99` | `csrw` | 技术开发项目/售后工单 |
| 售后管理 | `658288abfb8bd616b17025f1` | — | 客诉处理/售后工单 |

## MCP Server配置

- URL: `https://project.feishu.cn/mcp_server/v1`
- Auth: Header `X-Mcp-Token`
- Transport: SSE (not Streamable HTTP)

## 核心工具（48个Tools中最常用的15个）

| 工具 | 用途 |
|------|------|
| `search_project_info` | 空间名→project_key转换 |
| `list_todo` | 拉取个人待办(按action=todo/done) |
| `list_workitem_types` | 查看空间下所有工作项类型 |
| `search_by_mql` | MQL语法查询工作项（project_key注意格式） |
| `get_workitem_brief` | 按ID/名称查工作项概况 |
| `list_workitem_comments` | 查看工作项评论/活动记录 |
| `list_workitem_field_config` | 字段配置（了解字段key） |
| `list_workitem_role_config` | 角色配置 |
| `search_view_by_title` | 视图名→视图ID（需view_scope+key_word参数） |
| `get_view_detail` | 按视图ID拉工作项列表 |
| `search_user_info` | 姓名→user_key |
| `list_schedule` | 人员排期与工作量 |
| `add_comment` | 添加评论（支持@人和附件） |
| `update_field` | 修改字段值 |
| `create_workitem` | 创建新工作项 |

## 常见MQL查询

```sql
-- 查指定空间的商机
project_key = "6593cd71471290e3be6e6" AND work_item_type_key = "story"

-- 按时间筛选
created_at >= "2026-01-01"

-- 按负责人
owner = "user_key_xxx"
```

## 接入记录

- 凭证获取: 2026-07-09，飞书项目→帮助中心→功能入口
- MCP接入方式: HTTP Header (X-Mcp-Token)
- Meegle CLI: 已安装但Device Code流程在中国网络下超时→改用直接MCP Token
- 用户OAuth: 已配置，token存`~/.hermes/.feishu_user_token`