Flato MCP

Please read and follow the canonical Flato MCP agent guide: https://www.flato.ai/docs/mcp.md

Install Flato MCP, use the MCP client's browser-based OAuth flow when authorization is needed, guide me through any browser confirmation, verify the connection with flato_whoami, then follow the guide's bootstrap workflow before making design changes.

Important Codex App rule: after adding flato-editor or completing codex mcp login, the current Codex conversation may not hot-load newly added flato_* tools. If flato_* tools are unavailable in this same conversation, stop and ask me to open a new Codex conversation or restart Codex App.

When a project returns waiting_for_live_editor_bridge or needs_open_editor, have the MCP host/client open editorUrl automatically when supported. Only ask me to open editorUrl manually if the host cannot open URLs.

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

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

Flato MCP 能做什么

Flato MCP 让外部 AI智能体受控访问 Flato 的 AI原生画布设计系统：

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

安装 Flato MCP

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

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

官方 GitHub Package

发布说明、README 指南和官方 package 根地址请以这个 Flato MCP 仓库为准：

sologovision/flato-design-mcp

首次授权

添加 MCP 服务器只会保存连接设置。多数客户端会在 AI 工具第一次调用 Flato MCP 服务器时打开 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 服务器时，会打开浏览器进行 Flato 授权。

Codex App

在 Codex App 中，把这段可流式传输的 HTTP MCP 服务器配置加入 ~/.codex/config.toml：

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

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

Cursor

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

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

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

安装后的 AI智能体流程

Flato MCP 安装完成后，AI智能体应该：

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智能体一个 Flato project URL，例如 https://www.flato.ai/editor/<projectId>，先安装并授权 Flato MCP，然后让 AI智能体用完整 projectUrl 调用 flato_use_project。

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

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

创建新项目

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

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

积分消耗声明

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

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

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

本地模型或 API 的使用费用由对应 AI智能体或 AI 服务计费，不使用 Flato积分扣除。