mcp-feishu-project

# 飞书项目 MCP 配置辅助

当用户提供飞书项目 MCP URL 或请求配置时，自动应用此 skill，**同时配置到 Claude Code 和 Cursor**。

## 触发场景

用户消息满足以下任一条件时触发：

1. 包含飞书项目 MCP URL（`https://project.feishu.cn/mcp_server/v1?...`）
2. 包含配置相关关键词 + "飞书项目"：
   - 「配置」「设置」「添加」「同步」+ 「飞书项目」
   - 「feishu project」「project mcp」
3. 需要查询项目任务、工作项、需求

## 核心原则

⚠️ **强制要求：必须完成两个任务**

此 skill 的目标是同时配置 Claude Code 和 Cursor。**只有两个任务都成功完成才算真正完成。**

**任务清单：**
1. ✅ 配置 Claude Code (`~/.claude.json`)
2. ✅ 配置 Cursor (`~/.cursor/mcp.json`)

**如果任一任务失败，必须：**
- 明确告知用户哪个任务失败
- 提供具体的错误信息和解决方案
- 不能只完成一个任务就结束

## 执行流程

### 阶段 0：准备工作

**0.1 提取 URL 或收集参数**

**情况 A：用户提供完整 URL**

从用户消息中提取飞书项目 MCP URL：
```regex
https://project\.feishu\.cn/mcp_server/v1\?mcpKey=[^&]+&projectKey=[^&]+&userKey=[^&\s]+
```

**情况 B：用户未提供 URL**

引导用户获取配置参数：

```
⚠️ 飞书项目 MCP 需要以下参数：

1. mcpKey: MCP 密钥
2. projectKey: 项目空间 ID
3. userKey: 用户 ID

获取步骤：
1. 打开飞书项目：https://project.feishu.cn
2. 进入目标项目空间，获取 MCP 配置（包含 mcpKey 和 projectKey）
3. 点击右上角头像获取 userKey（用户 ID）

参考文档：https://xd.feishu.cn/wiki/KIZrwBH1viRRGHkBTWmcSwyInwf#share-YnMwdzjOnohu9sxQqbKc3oFSnwI

请提供完整的 MCP URL 或以下参数：
- mcpKey:
- projectKey:
- userKey:
```

**0.2 构建 MCP URL**

如果用户提供分散参数，构建完整 URL：
```
https://project.feishu.cn/mcp_server/v1?mcpKey={mcpKey}&projectKey={projectKey}&userKey={userKey}
```

**0.3 创建任务清单**

使用 TodoWrite 创建任务清单：
```
- 配置 Claude Code
- 配置 Cursor
```

### 阶段 1：配置 Claude Code

**1.1 检查现有配置**

执行命令：
```bash
claude mcp get feishu-project-mcp
```

**判断逻辑：**
- 输出包含 `Status: ✓ Connected` → 已配置，跳至 1.4
- 输出包含 `No MCP server found` 或错误 → 需要配置，继续 1.2

**1.2 添加配置**

执行命令：
```bash
claude mcp add --transport http feishu-project-mcp "<完整 URL>"
```

**1.3 验证配置**

执行命令：
```bash
claude mcp get feishu-project-mcp
```

**验证标准：**
- ✅ 输出包含 `Status: ✓ Connected`
- ✅ 输出包含 `Type: http`
- ✅ 输出包含正确的 URL

如果验证失败，记录错误并继续执行 Cursor 配置（不要因为一个失败就放弃另一个）。

**1.4 更新任务清单**

使用 TodoWrite 标记 "配置 Claude Code" 为 completed。

### 阶段 2：配置 Cursor

**2.1 检查配置文件**

使用 Read 工具读取 `~/.cursor/mcp.json`。

**判断逻辑：**
- 文件不存在 → 需要创建，跳至 2.2
- 文件存在 → 检查内容