内容
# Framedeck-MCP
Framedeck 的 MCP 服务器 — 将任意 AI 助手连接到您的内容生产流程中。
与 **Claude**、**ChatGPT**、**Gemini**、**Copilot** 和任何 MCP 兼容的客户端配合使用。
## 快速开始
1. 在 [framedeck.app](https://framedeck.app) 的设置 > API 密钥中获取您的 API 密钥
2. 将其添加到您的 AI 助手配置中（参见下文）
## 设置
### Claude 代码
```bash
claude mcp add framedeck -e FRAMEDECK_API_KEY=your_key_here -- npx -y framedeck-mcp
```
### Claude 桌面版
在您的 `claude_desktop_config.json` 中添加：
```json
{
"mcpServers": {
"framedeck": {
"command": "npx",
"args": ["-y", "framedeck-mcp"],
"env": {
"FRAMEDECK_API_KEY": "your_key_here"
}
}
}
}
```
### 其他 MCP 客户端
设置环境变量 `FRAMEDECK_API_KEY` 并运行：
```bash
npx framedeck-mcp
```
## 使用示例
自然地与您的 AI 助手交流 — 这里有三个端到端的示例工作流程：
### 示例 1 — 捕捉和培养创意
> **您：** *"我刚刚有 3 个视频创意：一个刀具磨利教程，一个 Sony A7IV 评测，和一个日常生活 Vlog。 将它们添加到我的创意池中。"*
>
> **Claude（通过 MCP）：** 调用 `create_multiple_cards`，包含三个标题。 它们出现在您的创意池的 "创意" 阶段。
>
> **您：** *"刀具磨利的创意可以开始了 — 将它升级为正式制作。"*
>
> **Claude：** 调用 `graduate_to_production`，创建一个新的专用制作，包含完整的阶段（创意 → 编剧 → 拍摄 → 编辑 → 发布），并将创意卡片移动到下一个阶段。
### 示例 2 — 计划制作日
> **您：** *"对于 Sony 评测，添加子任务：写开场，拍摄产品照片，录制旁白，编辑 B 卷，色彩分级，导出最终视频。"*
>
> **Claude：** 调用 `set_active_board` 到 "Sony A7IV 评测"，然后调用 `create_multiple_cards`，包含六个子任务，位于 "拍摄" 阶段。
>
> **您：** *"标记开场和产品照片为已完成。"*
>
> **Claude：** 调用 `move_card` 两次，将它们移动到 "完成" 阶段。
### 示例 3 — 获取项目概览
> **您：** *"我的频道怎么样？有什么逾期任务？"*
>
> **Claude：** 为每个制作调用 `get_board_overview`。 返回一个总结，显示每个阶段的卡片数量，逾期任务以红色突出显示，需要关注的制作。
>
> **您：** *"我现在有什么任务？"*
>
> **Claude：** 调用 `get_my_cards`，列出您所有的任务，按板块和状态分组。
## 工具（32）
| 工具 | 描述 |
|------|-------------|
| `set_active_board` | 设置活跃的制作上下文 |
| `get_active_board` | 显示当前活跃的制作 |
| `list_boards` | 列出所有制作/项目 |
| `create_board` | 创建新的制作或项目 |
| `list_columns` | 列出板块中的阶段 |
| `create_column` | 创建新的阶段 |
| `delete_column` | 删除阶段 |
| `list_cards` | 列出卡片/帧，支持筛选 |
| `create_card` | 创建卡片/帧 |
| `create_multiple_cards` | 批量创建（最多 50 个） |
| `update_card` | 更新标题，描述，优先级，截止日期 |
| `move_card` | 移动到不同阶段 |
| `delete_card` | 永久删除 |
| `archive_card` | 软删除（可恢复） |
| `duplicate_card` | 复制，包含检查清单和标签 |
| `set_card_color` | 为卡片设置颜色 |
| `add_comment` | 添加评论 |
| `add_checklist_item` | 添加子任务 |
| `toggle_checklist_item` | 勾选/取消勾选子任务 |
| `add_labels_to_card` | 为卡片添加标签 |
| `remove_label_from_card` | 删除卡片的标签 |
| `get_card_details` | 获取卡片详细信息 |
| `search_cards` | 按关键词搜索 |
| `assign_card` | 指派团队成员 |
| `get_my_cards` | 获取按状态分组的卡片 |
| `get_board_overview` | 获取板块总结，包含逾期任务 |
| `list_labels` | 列出所有标签 |
| `create_label` | 创建标签 |
| `link_commit` | 将 Git 提交链接到卡片 |
| `log_work` | 记录花费的时间 |
| `get_sprint_summary` | 获取活动总结 |
| `graduate_to_production` | 将创意提升为正式制作 |
## 双模式
Framedeck 支持两种板块模式：
- **创作者模式**：制作，阶段，帧 — 用于内容制作流程
- **经典模式**：项目，阶段，卡片 — 用于标准项目管理
MCP 服务器根据每个板块的模式自动使用正确的术语。
## 创意池
当您添加创意而没有指定板块时，它们会自动进入您的 **创意池**。 当创意准备好时，使用 `graduate_to_production` 创建一个具有完整阶段的专用制作（创意 > 编剧 > 拍摄 > 编辑 > 发布）。
## 安全注解
每个工具都附带 MCP 安全注解（`readOnlyHint`，`destructiveHint`，`idempotentHint`，`openWorldHint`），以便 AI 客户端在执行破坏性操作（如 `delete_card`，`delete_column` 和 `archive_card`）之前警告用户。
## 隐私和支持
- **隐私政策：** https://framedeck.app/privacy
- **服务条款：** https://framedeck.app/terms
- **支持：** support@framedeck.app
- **问题：** https://github.com/Lukaris/framedeck-mcp/issues
## 许可证
MIT
