FLORA

关于完整的文档索引，请参阅 llms.txt。文档页面的 Markdown 版本可通过在页面 URL 后附加 .md 获取；本页面也可作为 Markdown 查看。

FLORA MCP 文档

将 FLORA 连接到 Claude、Claude Code、ChatGPT、Codex、Cursor 或任何 MCP 客户端，让你的智能体能够生成内容、运行 Techniques，并在你的 FLORA 画布上进行构建。

FLORA MCP 是 FLORA 托管的 MCP 服务器。只需连接一次，你的 AI 智能体即可生成图像、视频、音频、文本和 3D 内容，运行你团队的 Techniques，并将结果放到你的 FLORA 画布上。这些文档涵盖了安装方法、每个工具的功能，以及你的智能体需要遵循的规则。

设置项	值
服务器 URL	https://agents.flora.ai/mcp（无尾部斜杠）
传输方式	Streamable HTTP。这是一个远程服务器，因此无需安装任何内容。
登录	使用你的 FLORA 账户进行 OAuth。无头客户端可以改用 FLORA API 密钥作为 Authorization: Bearer <key> 发送。
服务器名称	flora
验证是否可用	向你的智能体提问：“列出我的 FLORA 工作区。不要生成任何内容。”

• 谁可以连接： API 和 MCP 从 Starter 套餐起即包含在内。免费账户也可以连接，并使用每个新工作区附赠的 $2.50 用量进行生成。每次生成都会按美元计费到你所选择的工作区。请参阅 FLORA 定价方式 和 身份验证。
• 技能： 经过测试的工作流程（批量生成、优化循环、Technique 运行等）位于 github.com/florafauna-ai/flora-mcp-skills。你的智能体可通过 flora_discover_skills 列出它们。请参阅 技能与插件。
• 面向智能体： 这里的每个页面也提供 Markdown 格式。在任何 URL 后附加 .md，例如 https://docs.flora.ai/mcp.md。完整索引位于 https://docs.flora.ai/llms.txt。

在你的客户端中安装

Claude	Web 和 Desktop。添加自定义连接器。	Claude
Claude Code	一条命令，或使用带技能的插件。	Claude Code
ChatGPT	FLORA 已在 ChatGPT 中列出。点击连接。	ChatGPT
Codex	一条命令或 config.toml。	Codex
Cursor	一键安装或 mcp.json。	Cursor
VS Code	一条命令或 .mcp.json。	VS Code
其他客户端	Windsurf、Gemini CLI、Copilot Studio、Hermes、OpenClaw 以及任何 MCP 客户端。	其他客户端

刚接触 FLORA MCP？快速入门 将带你从连接开始，直到在画布上生成第一张图像。

从这里开始：八个工具

你的连接拥有的工具不止这些（具体列表取决于你的账户、套餐和客户端；flora_list_tools 会返回你当前可用的工具）。大多数任务从这八个工具开始。

工具	功能
flora_list_workspaces	列出你可以使用的工作区，以及你当前所在的工作区。只读。
flora_list_projects	列出工作区中的项目（画布）。只读。
flora_list_models	列出模型及其 model_id、预估成本和参数。只读。
flora_create_generations	在画布上启动 1 到 20 次生成，或使用 quote: true 报价其成本。会消耗费用。
flora_list_generations	按 run_id 读取最多 20 次运行，或列出历史记录。只读。
flora_create_asset	通过 URL 或上传链接将你自己的文件导入 FLORA。
flora_run_technique	运行你团队的某个 Technique。会消耗费用。
flora_get_usage	以美元读取工作区或组织的余额和支出。只读。

完整列表（含参数和示例）请参阅 工具参考。

你的智能体可以做什么

任务	方法
根据提示词或参考内容生成图像、视频、音频片段或 3D 模型	生成图像或视频
让产品照片动起来	将产品照片转为视频
根据列表或表格生成 20 到 500 个素材	批量生成 20 到 500 个素材
运行你团队构建的 Technique	运行你团队的 Technique
使用你自己的图像、视频、音频或 PDF	上传你自己的图像、视频和文件
将结果布局到画布上	将结果放到画布上
生成更多你喜欢的类似内容	基于收藏进行迭代
从你的提示词中获得更好的结果	为更好的输出向智能体提供简报

所有方法均已收录在 方法索引 中。

常见任务的工具调用序列

任务	按顺序的调用
第一张图像	flora_list_workspaces → flora_list_projects（或 flora_create_project）→ flora_create_generations 并使用 quote: true → 审批 → flora_create_generations → flora_list_generations
从照片 URL 生成视频	flora_list_workspaces → flora_list_projects → flora_list_models 并使用视频 model_id（以读取其图像字段名）→ 报价 → flora_create_generations 并在 params 中使用 URL → flora_list_generations
成本与余额	flora_list_models（estimated_cost_usd）或一次 quote: true 调用 → flora_get_usage
运行 Technique	flora_list_techniques → flora_get_technique → flora_run_technique → flora_list_generations 并使用 run_ids 和 technique_id
使用本地文件	flora_create_asset 并使用 source: "signed-url" → 上传（shell）或 upload_page 链接（聊天）→ flora_complete_asset
在画布上生成网格	flora_get_canvas → flora_arrange_canvas 并使用 node_ids 和 layout，或单独使用 all: true
让画布图像动起来	flora_add_to_canvas（视频节点连接到图像）→ flora_run_canvas_nodes → flora_list_generations

你的智能体遵循的规则

服务器会向智能体提供以下规则。这里列出它们是为了让你了解预期行为，并让你能够据此要求你的智能体遵守。

• 询问要计费的工作区。 连接并不绑定到某个工作区。如果 flora_list_workspaces 返回了多个工作区且当前没有指定，代理会列出这些工作区并询问你要对哪个计费。项目工具会向项目自身所属的工作区计费。
• 先用美元报价。 代理调用 flora_create_generations（使用 quote: true），向你显示以美元（而非积分）计算的费用，并且只有在你批准后，才会在不带 quote 的情况下运行同一请求。run_cost 和 charged_cost 的单位是美元：0.009 表示 $0.009。失败的运行不收费；重试算作一次新的运行，会再次计费。详情请参阅费用、余额和限制。
• 遇到计费错误时停止。 遇到 insufficient_credits 或任何 BILLING_* 错误时，代理会停止并将错误信息转达给你。它不会重试。paid_plan_required 表示该工作区的套餐不包含所请求的内容。余额和消费来自 flora_get_usage。
• 轮询要慢，一次调用完成。 代理会保存每个 run_id，在轮询之间等待 max(15, 2 × number of runs) 秒（最多 7 个运行等待 15 秒，20 个运行等待 40 秒），并通过一次 flora_list_generations 调用读取所有结果（最多 20 个 run_ids，Technique 运行额外加上 technique_id）。更快的轮询会返回 429 或带有 retry_after_seconds 的冷却错误。详情请参阅运行。
• 绝不重新触发部分批次。 已经开始的项目已经产生费用，而超时的调用可能仍然已经启动了运行。代理在重试之前会先读取历史记录。请参阅运行。
• 使用 canvas_url 进行链接。 代理使用每次生成返回的 canvas_url 打开结果，绝不会根据 ID 构建项目链接。

FLORA MCP、fal、Replicate 或模型提供商的 API？

模型 API 以及 fal 和 Replicate 等聚合器会将模型的原始输出返回给你的代码。FLORA MCP 专为与代理一起进行创意工作而构建：

• 结果落在画布上。 每次生成都会成为 FLORA 项目中的一个节点，你的团队可以打开、比较、编辑并在此基础上继续构建，而不是聊天记录中的文件 URL。
• 你团队的工作流也随之而来。 你的代理可以运行你团队保存的 Technique，并使用 FLORA 的技能。
• 团队计费和控制。 工作区、成员、角色、按工作区设置的花费限制和使用报告同样适用于代理运行。价格是 FLORA 在模型定价上公布的每次生成费率，与应用内一致。
• 一次连接，多种模型系列。 通过一次登录即可使用来自多个提供商的图像、视频、音频、文本和 3D 模型。

如果你只需要在自己的应用内获取某个模型的输出，不需要画布或团队工作区，那么提供商的 API 或聚合器可能更合适。要从你自己的代码调用 FLORA，请使用 FLORA API。

术语

术语	含义
工作区	项目存放和使用计费的地方。你可以属于多个工作区。ID 形如 ws_123。
项目	一个 FLORA 画布及其内容。ID 形如 prj_abc。
画布	项目内的面板，节点位于其上并相互连接。
节点	画布上的一个块：图像、视频、文本、Technique 或其他步骤。生成结果以节点形式呈现。
运行	一次生成或 Technique 执行，通过其 run_id 进行跟踪。
Technique	你的团队在 FLORA 中构建的已保存、可复用的工作流。请参阅Techniques。
资产	FLORA 中的文件，已上传或已生成，带有 asset_id。
技能	代理为完成更大任务而遵循的书面指令，由 flora_discover_skills 列出。

本文档的所有内容

• 快速入门：连接、检查并生成你的第一张图像。
• 安装：适用于每个客户端的步骤。
• 身份验证：OAuth、API 密钥、工作区和断开连接。
• 费用、余额和限制：报价、余额和计费错误。
• 运行：轮询、超时和失败。
• 配方：分步任务。
• 工具参考：每个工具及其参数。
• 技能和插件：经过测试的工作流及其安装方法。
• 故障排除：症状、原因和修复方法。
• 安全与数据：哪些数据会离开 FLORA，以及你的代理可以做什么。
• 更新日志：变更内容及时间。
• 已停用工具：旧工具名称及其替代品。
• FLORA API：使用 API 密钥从你自己的代码调用 FLORA。

观看：关于 FLORA MCP 的一切

{% embed url="https://www.youtube.com/watch?v=74R3pWxmiqc" %} 来自 FLORA 团队的 FLORA MCP 介绍。 {% endembed %}

需要帮助？发送邮件至 support@florafauna.ai。

---

代理说明

本文档使用 GitBook 发布。GitBook 是一个文档平台，旨在让人类和 AI 代理都能有效地阅读、导航和推理技术内容。了解更多信息，请访问 gitbook.com。

查询本文档

如果你需要本页未直接提供的额外信息，你可以通过提问来查询文档。

对以下 URL 执行 HTTP GET 请求，并携带 ask 和 goal 查询参数：

GET https://docs.flora.ai/mcp.md?ask=<question>&goal=<user_goal>

ask 是当前的问题：它应当具体、自包含，并用自然语言书写。 goal 是用户最终想要实现的目标，即他们需要答案的原因。分享目标有助于 GitBook 给出更好、更相关的答案。当目标描述用户想要的结果而非重述问题时最为有用。例如，对于 ask=how do I create an API token，像 automate deployments from our CI pipeline 这样的目标可以让 GitBook 针对该用例定制答案。

响应将包含问题的直接答案，以及文档中的相关摘录和来源。

当答案未明确出现在当前页面、你需要澄清或额外上下文，或你想检索相关文档章节时，请使用此机制。