Framedeck

framedeck-mcp

适用于 Framedeck 的 MCP 服务 — 将任意 AI 助手连接到你的内容制作工作流。

支持 Claude、ChatGPT、Gemini、Copilot 和任何兼容 MCP 的客户端。

快速开始

1. 前往 framedeck.app > Settings > API Keys 获取 API key
2. 将其添加到 AI 助手配置中（见下文）

设置

Claude Code

claude mcp add framedeck -e FRAMEDECK_API_KEY=your_key_here -- npx -y framedeck-mcp

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "framedeck": {
      "command": "npx",
      "args": ["-y", "framedeck-mcp"],
      "env": {
        "FRAMEDECK_API_KEY": "your_key_here"
      }
    }
  }
}

其他 MCP 客户端

设置环境变量 FRAMEDECK_API_KEY 并运行：

npx framedeck-mcp

使用示例

像平常一样与 AI 助手交流 — 以下是三个端到端工作流：

示例 1 — 收集并转化创意

你： “我刚想到 3 个视频创意：刀具磨刀教程、Sony A7IV 评测，以及一天生活 vlog。把它们添加到我的创意池。”

Claude（通过 MCP）： 调用 create_multiple_cards 创建这三个标题。它们会进入创意池的“创意”阶段。

你： “刀具磨刀那个可以做 — 把它转成正式制作项目。”

Claude： 调用 graduate_to_production，创建一个包含完整阶段的新制作项目（创意 → 脚本撰写 → 拍摄 → 剪辑 → 已发布），并将创意卡片转移过去。

示例 2 — 规划制作日

你： “给 Sony 评测添加子任务：撰写开场、拍摄产品镜头、录制旁白、剪辑 B-roll、调色、导出成片。”

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
• 支持： [email protected]
• 问题反馈： https://github.com/Lukaris/framedeck-mcp/issues

许可证

MIT