framedeck-mcp

Framedeck 的 MCP 服务器 — 将任何 AI 助手连接到您的内容生产流水线。

适用于 Claude、ChatGPT、Gemini、Copilot 以及任何兼容 MCP 的客户端。

快速入门

1. 在 framedeck.app > 设置 > API 密钥处获取您的 API 密钥

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 个视频创意：磨刀教程、索尼 A7IV 评测和生活 Vlog。把它们加到我的创意池里。”

Claude (通过 MCP)： 调用 create_multiple_cards 并传入这三个标题。它们会进入您创意池的“创意”阶段。

您： “磨刀那个可以做 — 把它升级为一个正式的生产项目。”

Claude： 调用 graduate_to_production，创建一个包含完整阶段（创意 → 脚本 → 拍摄 → 编辑 → 发布）的新生产项目，并将该创意卡片移动过去。

示例 2 — 规划生产日

您： “对于索尼评测，添加子任务：写开场白、拍摄产品镜头、录制旁白、剪辑 B-roll、调色、导出最终成品。”

Claude： 调用 set_active_board 设置为“索尼 A7IV 评测”，然后调用 create_multiple_cards 在“拍摄”阶段创建所有六个子任务。

您： “把开场白和产品镜头标记为已完成。”

Claude： 调用两次 move_card 将它们移动到“已完成”阶段。

示例 3 — 获取项目概览

您： “我的频道进展如何？有什么逾期的吗？”

Claude： 为每个生产项目调用 get_board_overview。返回一个摘要，显示每个阶段的卡片数量、以红色高亮显示的逾期项目，以及哪些生产项目需要关注。

您： “我现在被分配了什么任务？”

Claude： 调用 get_my_cards 并按看板和状态列出您名下的所有任务。

工具 (32)

双模式

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