FLORA

официальный

MCP-сервер FLORA позволяет пользователям создавать, организовывать и дорабатывать визуальные материалы — hero-изображения, мудборды, лайфстайл-снимки, промо-графику — прямо из диалога и направлять их в инструменты, которые команды уже используют (Notion, Google Drive, Slack, календари).

Смотреть на flora.ai

Что можно делать с FLORA MCP?

Генерация медиа по запросам — Попросите вашего ассистента создать изображения, видео, аудио, текст или 3D-модели через flora_create_generations, и результаты появятся на вашем холсте.
Запуск командных техник — Позвольте вашему агенту выполнять сохранённые рабочие процессы, вызывая flora_run_technique после просмотра доступных опций с помощью flora_list_techniques.
Проверка затрат перед тратами — Запросите оценку с помощью quote: true в flora_create_generations, чтобы увидеть предполагаемую стоимость в долларах США, затем проверьте баланс через flora_get_usage.
Управление макетами холста — Поручите вашему ассистенту расположить узлы генерации на доске проекта с помощью flora_arrange_canvas, указав конкретные node_ids и layout.
Загрузка и использование локальных файлов — Попросите вашего агента добавить ваши собственные изображения или видео в FLORA через flora_create_asset, затем завершите загрузку с помощью flora_complete_asset.
Обнаружение доступных навыков — Попросите вашего ассистента перечислить протестированные рабочие процессы и плагины, вызвав flora_discover_skills, чтобы найти готовые рецепты автоматизации.

Документация

Полный указатель документации см. в llms.txt. Markdown-версии страниц документации доступны при добавлении .md к URL страниц; эта страница доступна как Markdown.

Документация FLORA MCP

Подключите FLORA к Claude, Claude Code, ChatGPT, Codex, Cursor или любому MCP-клиенту, чтобы ваш агент мог генерировать контент, запускать Techniques и работать с вашими canvas в FLORA.

FLORA MCP — это размещенный MCP-сервер FLORA. Подключите его один раз, и ваш ИИ-агент сможет генерировать изображения, видео, аудио, текст и 3D, запускать Techniques вашей команды и размещать результаты на ваших canvas в FLORA. Эта документация описывает установку, назначение каждого инструмента и правила, которым следует ваш агент.

Параметр	Значение
URL сервера	`https://agents.flora.ai/mcp` (без завершающего слэша)
Транспорт	Streamable HTTP. Это удаленный сервер, поэтому устанавливать ничего не нужно.
Вход	OAuth с вашей учетной записью FLORA. Клиенты без интерфейса могут отправлять API-ключ FLORA как `Authorization: Bearer <key>`.
Имя сервера	`flora`
Проверка	Спросите агента: «Перечисли мои рабочие пространства FLORA. Ничего не генерируй».

Кто может подключиться: API и MCP включены начиная с тарифа Starter. Бесплатный аккаунт также может подключиться и генерировать контент на $2.50 использования, которые получает каждое новое рабочее пространство. Каждая генерация тарифицируется в долларах США за выбранное рабочее пространство. См. Как работает ценообразование FLORA и Аутентификация.
Навыки: проверенные рабочие процессы (пакетная генерация, циклы уточнения, запуски Techniques и другое) находятся на github.com/florafauna-ai/flora-mcp-skills. Ваш агент перечисляет их с помощью flora_discover_skills. См. Навыки и плагины.
Для агентов: каждая страница здесь также доступна в Markdown. Добавьте .md к любому URL, например https://docs.flora.ai/mcp.md. Полный указатель — https://docs.flora.ai/llms.txt.

Установка в вашем клиенте


Claude	Web и Desktop. Добавьте пользовательский коннектор.	Claude
Claude Code	Одна команда или плагин с навыками.	Claude Code
ChatGPT	FLORA указан в ChatGPT. Нажмите Connect.	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? Краткое руководство проведет вас от подключения до первого изображения на canvas.

Начните здесь: восемь инструментов

Ваше подключение имеет больше инструментов, чем перечислено (список зависит от вашего аккаунта, тарифа и клиента; flora_list_tools возвращает доступные вам). Большинство задач начинаются с этих восьми.

Инструмент	Назначение
`flora_list_workspaces`	Перечисляет рабочие пространства, которые вы можете использовать, и текущее. Только чтение.
`flora_list_projects`	Перечисляет проекты (canvas) в рабочем пространстве. Только чтение.
`flora_list_models`	Перечисляет модели с их `model_id`, расчетной стоимостью и параметрами. Только чтение.
`flora_create_generations`	Запускает от 1 до 20 генераций на canvas или рассчитывает их стоимость с помощью `quote: true`. Тратит деньги.
`flora_list_generations`	Читает до 20 запусков по `run_id` или перечисляет историю. Только чтение.
`flora_create_asset`	Загружает ваши файлы в FLORA по URL или ссылке для загрузки.
`flora_run_technique`	Запускает одну из Techniques вашей команды. Тратит деньги.
`flora_get_usage`	Читает баланс и расходы в долларах США для рабочего пространства или организации. Только чтение.

Полный список с аргументами и примерами — в справочнике инструментов.

Что может делать ваш агент

Задача	Рецепт
Создать изображение, видео, аудиоклип или 3D-модель по промпту или референсам	Создать изображение или видео
Анимировать фото продукта	Превратить фото продукта в видео
Создать от 20 до 500 ассетов из списка или таблицы	Пакетная генерация от 20 до 500 ассетов
Запустить Technique, созданную вашей командой	Запустить Technique вашей команды
Использовать свои изображения, видео, аудио или PDF	Загрузить свои изображения, видео и файлы
Разложить результаты на canvas	Разместить результаты на canvas
Создать больше похожего на то, что вам понравилось	Итерации по избранному
Получить лучшие результаты из ваших промптов	Инструктируйте агента для лучшего результата

Все рецепты перечислены в Рецептах.

Последовательности инструментов для типовых задач

Задача	Вызовы по порядку
Первое изображение	`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` с URL в `params` → `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`
Сетка на canvas	`flora_get_canvas` → `flora_arrange_canvas` с `node_ids` и `layout`, или только `all: true`
Анимация изображения на canvas	`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) секунд между опросами (15 секунд для до 7 запусков, 40 секунд для 20) и читает все их одним вызовом flora_list_generations (до 20 run_ids, плюс technique_id для запусков Technique). Более частый опрос возвращает 429 или ошибки охлаждения с retry_after_seconds. Подробнее: Запуски.
Никогда не повторяйте частичный пакет. Элементы, которые уже начались, стоят денег, и вызов с тайм-аутом мог всё же запустить выполнение. Агент читает историю перед повторной попыткой. См. Запуски.
Ссылайтесь с помощью canvas_url. Агент открывает результаты с помощью canvas_url, который возвращает каждое поколение, и никогда не строит ссылки на проекты из ID.

FLORA MCP, fal, Replicate или API провайдера моделей?

API моделей и агрегаторы, такие как fal и Replicate, возвращают сырой вывод модели в ваш код. FLORA MCP создан для творческой работы с агентом:

Результаты попадают на холст. Каждое поколение становится узлом в проекте FLORA, который ваша команда может открыть, сравнить, отредактировать и развить, а не URL-адресом файла в журнале чата.
Рабочие процессы вашей команды подключаются. Ваш агент может запускать Techniques, сохранённые вашей командой, и использовать навыки 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: вызывайте FLORA из вашего собственного кода с помощью ключа API.

Смотрите: Всё о FLORA MCP

{% embed url="https://www.youtube.com/watch?v=74R3pWxmiqc" %} Введение в FLORA MCP от команды FLORA. {% endembed %}

Нужна помощь? Напишите на support@florafauna.ai.

Инструкции для агента

Эта документация опубликована с помощью GitBook. GitBook — это платформа документации, созданная так, чтобы и люди, и ИИ-агенты могли эффективно читать, навигировать и рассуждать над техническим контентом. Узнайте больше на gitbook.com.

Запросы к этой документации

Если вам нужна дополнительная информация, которой нет непосредственно на этой странице, вы можете запросить документацию, задав вопрос.

Выполните HTTP GET-запрос на следующий URL с параметрами запроса 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 адаптировать ответ под этот вариант использования.

Ответ будет содержать прямой ответ на вопрос, а также релевантные выдержки и источники из документации.

Используйте этот механизм, когда ответ явно отсутствует на текущей странице, вам нужно уточнение или дополнительный контекст, или вы хотите получить связанные разделы документации.