flow2

Flow2 MCP Server

设计移动优先的演示文稿——通过 AI 助手创建、编辑、预览和发布。

这是 Flow2 的官方 Model Context Protocol 服务。它让 Claude 等 AI 助手能够直接操作你的 Flow2 账户：创建新流程、添加和编辑屏幕、插入区块、预览结果并发布——只需在聊天中输入提示词。

• Endpoint： https://mcp.flow2.co/
• Transport： streamable-http
• Auth： 使用动态客户端注册（RFC 7591）的 OAuth 2.1
• Registry： co.flow2/flow2

---

快速开始

Claude Code（和 Cowork）

claude mcp add --transport http flow2 https://mcp.flow2.co/ --scope user

然后在 Claude Code 中运行 /mcp，完成 OAuth 登录。

Claude.ai（网页端 + 桌面端）

设置 → 连接器 → 添加自定义连接器 → URL：https://mcp.flow2.co/。点击 连接 进行授权。

Cursor

在 ~/.cursor/mcp.json 中：

{
  "mcpServers": {
    "flow2": {
      "url": "https://mcp.flow2.co/"
    }
  }
}

其他兼容 MCP 的客户端

任何支持远程 streamable-HTTP MCP 服务的客户端，都可以使用上方的 URL 进行连接。客户端支持 DCR 时，OAuth 会自动处理。

---

功能

Flow2 MCP 服务通过工具提供完整的流程创作功能：

工具	功能
create_flow	创建新的 Flow2 演示文稿
update_flow_meta	重命名流程或更新流程级元数据
get_flow	读取流程的当前状态
add_screen	向流程添加新屏幕
get_screen	读取屏幕及其区块
delete_screen	从流程中移除屏幕
add_block	向屏幕添加区块（文本、图片、按钮等）
patch_block	更新现有区块的内容或样式
delete_block	从屏幕中移除区块
get_blocks_schema	列出可用的区块类型及其架构
get_preview	获取单个屏幕的截图 URL
render-flow-preview	在聊天中内嵌显示整个流程——以垂直滚动方式预览所有屏幕，并显示主题强调色指示器（在支持 Apps 的客户端中可交互）
render-screen-preview	在聊天中以内嵌的手机边框截图形式显示单个屏幕
list_jobs / check_job_status	跟踪长时间运行的操作
check_credits	查看账户剩余点数

所有写入工具在适用情况下都标注了 destructiveHint: false，让 AI 客户端能够判断操作是否安全。只读工具标注了 readOnlyHint: true。

内嵌预览（支持 Apps 的客户端）

在支持 MCP Apps 扩展 的客户端（Claude.ai 网页端 + 桌面端、Claude Code、ChatGPT、Cursor、VS Code）中，render-flow-preview 和 render-screen-preview 会在沙盒 iframe 中生成可交互的内嵌预览——无需离开聊天即可查看流程。单个屏幕上的 CTA 按钮会变成可点击跳转的链接；指示器会采用流程的主题强调色。其他客户端则会回退为封面截图。

---

提示词示例

连接服务后，可以试试：

• “为我的金融科技应用创建一份新的移动端路演演示文稿，应用名为 ‘Lumen’。”
• “添加一个主视觉屏幕，包含醒目的标题和一个 ‘Get started’ 按钮。”
• “生成三个产品功能屏幕，配上图标和简短说明。”
• “给我看看最新的流程。”（会渲染内嵌预览）
• “预览我的定价流程中的第 3 个屏幕。”
• “分享最新流程的链接。”

助手会调用相应的 MCP 工具，你会在 Flow2 账户中实时看到更改。

---

身份验证

该服务通过动态客户端注册实现 OAuth 2.1。首次从新客户端连接时，它会：

1. 发现 /.well-known/oauth-authorization-server
2. 通过 registration_endpoint 将自身注册为客户端
3. 引导你完成标准的 PKCE 授权码流程
4. 存储刷新令牌，以便持续访问

你可以随时在 Flow2 账户设置中撤销客户端。

---

隐私与数据处理

• 范围： MCP 服务仅访问属于已通过身份验证用户的 Flow2 数据。
• 日志记录： 出于运维目的，会记录请求元数据（工具名称、时间戳、状态）；工具参数和响应正文仅在请求生命周期内保留。
• 第三方服务： Flow2 使用少量基础设施服务提供商（托管、错误跟踪）——完整列表请参阅隐私政策。
• 保留期限： 身份验证令牌以静态加密方式存储；在 Flow2 设置中撤销访问权限后，这些令牌将被清除。

详细信息：隐私政策 · 服务条款。

---

支持

• 电子邮件： [email protected]
• 问题反馈： github.com/flowboard/flow2-mcp/issues

---

许可证

MIT — 请参阅 LICENSE。