Flato MCP

Please read this Flato MCP guide, install Flato MCP, trigger OAuth authorization when needed, guide me through the browser confirmation, verify the connection with flato_whoami, then follow the agent workflow in the guide. Important Codex App rule: after adding flato-editor or completing codex mcp login, the current Codex conversation may not hot-load newly added MCP tools. If flato_* tools are unavailable in this same conversation, stop and ask me to open a new Codex conversation or restart Codex App; do not inspect local OAuth/token stores or manually extract bearer tokens. When a project returns waiting_for_live_editor_bridge or needs_open_editor, have the MCP host/client open editorUrl automatically when supported, and only ask me to open editorUrl if the host cannot open URLs. Markdown guide: https://www.flato.ai/docs/mcp.md

Flato 提供用于 AI 设计的 AI 原生画布运行时，让 AI Agent 与人可以在同一个连续工作流中共同创建可编辑演示文稿和视觉内容。

Flato MCP 将 Claude Code、Codex、Cursor 以及其他支持 MCP 的 Agent 连接到 Flato 的 AI 原生画布运行时。Agent 可以创建并持续更新演示文稿、海报、社媒视觉等可编辑设计；用户也可以打开浏览器编辑器，手动修改、导出 PDF 或图片、分享链接，并在同一个项目里继续与 AI 协作。

Flato MCP 能做什么

Flato MCP 让外部 AI Agent 受控访问 Flato 的 AI 原生画布运行时：

1. 创建已保存的可编辑设计项目。
2. 接管已有 editor URL 或分享链接。
3. 读取当前画布、页面、区块、样式和版式反馈。
4. 创建并更新演示文稿、海报、社媒视觉和其他设计格式。
5. 让用户打开实时编辑器，手动修改、导出、分享，并继续与 AI 协作。
6. 让每一次 AI 修改都基于同一个实时项目，而不是生成彼此断开的文件。

安装 Flato MCP

把 Flato 添加到 AI coding tool 时，使用这个 HTTP MCP server URL：

https://api.flato.ai/api/mcp/editor

首次授权

添加 MCP server 只会保存连接设置。多数客户端会在 AI 工具第一次调用 Flato MCP server 时打开 Flato OAuth 窗口，而不是保存配置时立刻打开。

如果安装后没有浏览器窗口打开，可以让 AI 工具通过调用 mcp_auth 或 flato_whoami 来触发 Flato MCP 授权。授权成功后，再让它调用 flato_whoami 确认连接状态。

Claude Code

在终端运行这个命令：

claude mcp add --transport http flato https://api.flato.ai/api/mcp/editor

然后在 Claude Code 会话里输入 /mcp 启动 OAuth 登录流程。Claude Code 第一次调用 Flato MCP server 时，会打开浏览器进行 Flato 授权。

Codex App

在 Codex App 中，把这段直接 Streamable HTTP MCP server 配置加入 ~/.codex/config.toml：

[mcp_servers.flato-editor]
url = "https://api.flato.ai/api/mcp/editor"
tool_timeout_sec = 120

添加 server 后，打开新的 Codex 对话或重启 Codex App。如果 OAuth 没有自动开始，运行 codex mcp login flato-editor。OAuth 在浏览器中完成；不要索要 Flato 用户名、密码或 Authorization header。个人 Codex plugin 只用于旧的本地 demo，不是正常 Flato MCP 安装路径。

Cursor

打开 Cursor Settings > MCP 添加新 server，或把下面配置加入 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "flato": {
      "type": "http",
      "url": "https://api.flato.ai/api/mcp/editor"
    }
  }
}

认证通过 OAuth 处理。Cursor 通常会在第一次实际调用 MCP tool 时打开浏览器进行 Flato 授权。如果 Cursor 已加载 server 但没有 OAuth 窗口，让 Cursor Agent 调用 mcp_auth 或 flato_whoami，任一操作都应触发授权。

安装后的 Agent 流程

Flato MCP 安装完成后，Agent 应该：

1. 如果还没有授权，先触发 OAuth 授权。
2. 调用 flato_whoami 确认授权，并检查项目/编辑器状态。
3. 如果是新设计，选择一个简洁、面向用户的 projectName，然后调用 flato_create_project。
4. 如果有 editor URL，使用完整 projectUrl 调用 flato_use_project。
5. 如果有分享链接，使用完整 shareUrl 调用 flato_use_share_link。
6. 如果返回状态是 waiting_for_live_editor_bridge，把返回的 editorUrl 给用户，然后停止并等待用户打开。
7. 调用 flato_get_project_status，直到 canWrite=true。
8. 创建、编辑或导出前，先调用 flato_get_design_context。

接管 Flato URL

如果有人给 AI Agent 一个 Flato project URL，例如 https://www.flato.ai/editor/<projectId>，先安装并授权 Flato MCP，然后让 Agent 用完整 projectUrl 调用 flato_use_project。

如果有人给 AI Agent 一个 Flato share URL，例如 https://www.flato.ai/share/<shareId>，让 Agent 用完整 shareUrl 调用 flato_use_share_link。Flato MCP 会在已授权用户账号中创建可编辑项目副本，并返回新的 editorUrl。

如果较旧的 MCP 客户端没有 flato_use_share_link，可以打开分享链接，使用 Edit a copy，然后让 Agent 用复制后的 editor URL 调用 flato_use_project。

创建新项目

对于新任务，让 Agent 选择一个简洁、面向用户的 projectName，并调用 flato_create_project。

当 flato_create_project、flato_use_project 或 flato_use_share_link 返回 waiting_for_live_editor_bridge 时，Agent 应把返回的 editorUrl 给你，停止并等待你打开它。编辑器页面加载后，Agent 应调用 flato_get_project_status 直到 canWrite=true，然后在做任何设计修改前调用 flato_get_design_context。

积分消耗声明

Flato MCP 不会因为 Claude Code、Codex、Cursor 或其他 MCP 客户端等本地 AI Agent 消耗 token 而扣除 Flato Credits。

Flato Credits 只会在使用 Flato 侧 AI 生成或媒体处理能力时消耗。手动修改文字、调整排版、移动元素或裁切图片等普通画布编辑不会消耗 Credits。

部分 Flato 功能需要有效订阅，包括 MPEG 导出、vectorizer 和视频生成。功能可用性以平台当前规则为准；其他已支持的 MCP 和平台功能如未标记为订阅功能，则可免费使用。

本地模型或 API 的使用费用由对应 AI Agent 或 AI 服务计费，不使用 Flato Credits 扣除。