FLORA

oficial

El MCP de FLORA permite a los usuarios generar, organizar e iterar sobre activos visuales — imágenes principales, paneles de inspiración, tomas de estilo de vida, gráficos promocionales — directamente desde una conversación, y enrutarlos hacia las herramientas en las que los equipos ya trabajan (Notion, Google Drive, Slack, calendarios).

Ver en flora.ai

¿Qué puedes hacer con FLORA MCP?

Generar medios a partir de indicaciones — Pide a tu asistente que cree imágenes, video, audio, texto o modelos 3D mediante flora_create_generations, con los resultados apareciendo en tu lienzo.
Ejecutar técnicas de equipo — Haz que tu agente ejecute flujos de trabajo guardados llamando a flora_run_technique después de listar las opciones disponibles con flora_list_techniques.
Verificar costos antes de gastar — Solicita un presupuesto con quote: true en flora_create_generations para ver los costos estimados en USD, y luego consulta el saldo mediante flora_get_usage.
Gestionar diseños de lienzo — Indica a tu asistente que organice los nodos de generación en un tablero de proyecto usando flora_arrange_canvas con node_ids y layout específicos.
Subir y usar archivos locales — Pide a tu agente que traiga tus propias imágenes o videos a FLORA mediante flora_create_asset, y luego completa la subida con flora_complete_asset.
Descubrir habilidades disponibles — Haz que tu asistente liste flujos de trabajo y complementos probados llamando a flora_discover_skills para encontrar recetas de automatización preconstruidas.

Documentación

Para el índice completo de documentación, consulta llms.txt. Las versiones Markdown de las páginas de documentación están disponibles añadiendo .md a las URLs de las páginas; esta página está disponible como Markdown.

Documentación de FLORA MCP

Conecta FLORA a Claude, Claude Code, ChatGPT, Codex, Cursor o cualquier cliente MCP para que tu agente pueda generar, ejecutar Técnicas y construir en tus lienzos de FLORA.

FLORA MCP es el servidor MCP alojado de FLORA. Conéctalo una vez y tu agente de IA podrá generar imágenes, video, audio, texto y 3D, ejecutar las Técnicas de tu equipo y colocar los resultados en tus lienzos de FLORA. Esta documentación cubre cómo instalarlo, qué hace cada herramienta y las reglas que sigue tu agente.

Configuración	Valor
URL del servidor	`https://agents.flora.ai/mcp` (sin barra final)
Transporte	HTTP Streamable. Es un servidor remoto, así que no hay nada que instalar.
Inicio de sesión	OAuth con tu cuenta de FLORA. Los clientes sin interfaz pueden enviar una clave API de FLORA como `Authorization: Bearer <key>` en su lugar.
Nombre del servidor	`flora`
Verificar que funciona	Pregunta a tu agente: "Lista mis espacios de trabajo de FLORA. No generes nada."

Quién puede conectarse: API y MCP están incluidos desde el plan Starter. Una cuenta Free también puede conectarse y generar con los $2.50 de uso que recibe cada nuevo espacio de trabajo. Cada generación se factura en dólares estadounidenses al espacio de trabajo que elijas. Consulta Cómo funciona el precio de FLORA y Autenticación.
Habilidades: flujos de trabajo probados (generación por lotes, bucles de refinamiento, ejecuciones de Técnicas y más) están en github.com/florafauna-ai/flora-mcp-skills. Tu agente los lista con flora_discover_skills. Consulta Habilidades y plugins.
Para agentes: cada página aquí también está en Markdown. Añade .md a cualquier URL, por ejemplo https://docs.flora.ai/mcp.md. El índice completo es https://docs.flora.ai/llms.txt.

Instalar en tu cliente


Claude	Web y Desktop. Añade un conector personalizado.	Claude
Claude Code	Un comando, o el plugin con habilidades.	Claude Code
ChatGPT	FLORA está listado en ChatGPT. Haz clic en Conectar.	ChatGPT
Codex	Un comando o `config.toml`.	Codex
Cursor	Instalación con un clic o `mcp.json`.	Cursor
VS Code	Un comando o `.mcp.json`.	VS Code
Otros clientes	Windsurf, Gemini CLI, Copilot Studio, Hermes, OpenClaw y cualquier cliente MCP.	Otros clientes

¿Nuevo en FLORA MCP? La guía de inicio rápido te lleva desde la conexión hasta tu primera imagen en un lienzo.

Empieza aquí: ocho herramientas

Tu conexión tiene más herramientas que estas (la lista depende de tu cuenta, plan y cliente; flora_list_tools devuelve las que tienes). La mayoría de los trabajos comienzan con estas ocho.

Herramienta	Qué hace
`flora_list_workspaces`	Lista los espacios de trabajo que puedes usar y en cuál estás. Solo lectura.
`flora_list_projects`	Lista proyectos (lienzos) en un espacio de trabajo. Solo lectura.
`flora_list_models`	Lista modelos con su `model_id`, costo estimado y parámetros. Solo lectura.
`flora_create_generations`	Inicia de 1 a 20 generaciones en un lienzo, o cotiza su costo con `quote: true`. Gasta dinero.
`flora_list_generations`	Lee hasta 20 ejecuciones por `run_id`, o lista el historial. Solo lectura.
`flora_create_asset`	Trae tus propios archivos a FLORA desde una URL o un enlace de carga.
`flora_run_technique`	Ejecuta una de las Técnicas de tu equipo. Gasta dinero.
`flora_get_usage`	Lee saldo y gasto en dólares estadounidenses para un espacio de trabajo u organización. Solo lectura.

La lista completa, con argumentos y ejemplos, está en la referencia de herramientas.

Lo que tu agente puede hacer

Tarea	Receta
Crear una imagen, video, clip de audio o modelo 3D a partir de un prompt o referencias	Generar una imagen o video
Animar una foto de producto	Convertir una foto de producto en video
Crear de 20 a 500 activos desde una lista u hoja	Generar por lotes de 20 a 500 activos
Ejecutar una Técnica que tu equipo construyó	Ejecutar la Técnica de tu equipo
Usar tus propias imágenes, video, audio o PDFs	Subir tus propias imágenes, video y archivos
Colocar resultados en un lienzo	Colocar resultados en un lienzo
Crear más como las que te gustaron	Iterar sobre favoritos
Obtener mejores resultados de tus prompts	Instruir a tu agente para mejores resultados

Todas las recetas están indexadas en Recetas.

Secuencias de herramientas para trabajos comunes

Tarea	Llamadas, en orden
Primera imagen	`flora_list_workspaces` → `flora_list_projects` (o `flora_create_project`) → `flora_create_generations` con `quote: true` → aprobación → `flora_create_generations` → `flora_list_generations`
Video desde una URL de foto	`flora_list_workspaces` → `flora_list_projects` → `flora_list_models` con el video `model_id` (para leer su nombre de campo de imagen) → cotización → `flora_create_generations` con la URL en `params` → `flora_list_generations`
Costo y saldo	`flora_list_models` (`estimated_cost_usd`) o una llamada a `quote: true` → `flora_get_usage`
Ejecutar una Técnica	`flora_list_techniques` → `flora_get_technique` → `flora_run_technique` → `flora_list_generations` con `run_ids` y `technique_id`
Usar un archivo local	`flora_create_asset` con `source: "signed-url"` → subir (shell) o enlace `upload_page` (chat) → `flora_complete_asset`
Cuadrícula en un lienzo	`flora_get_canvas` → `flora_arrange_canvas` con `node_ids` y `layout`, o `all: true` solo
Animar una imagen del lienzo	`flora_add_to_canvas` (nodo de video conectado a la imagen) → `flora_run_canvas_nodes` → `flora_list_generations`

Reglas que sigue tu agente

El servidor les da estas reglas a los agentes. Están aquí para que sepas qué esperar y para que puedas exigir que tu agente las cumpla.

Pregunta a qué workspace facturar. Una conexión no está vinculada a un solo workspace. Si varios aparecen de flora_list_workspaces y ninguno es el actual, el agente los nombra y te pregunta a cuál facturar. Las herramientas de proyecto facturan al workspace del propio proyecto.
Cotiza primero, en dólares estadounidenses. El agente llama a flora_create_generations con quote: true, te muestra el costo en dólares estadounidenses (nunca en créditos) y ejecuta la misma solicitud sin quote solo después de que lo apruebes. run_cost y charged_cost son dólares: 0.009 significa $0.009. Una ejecución fallida no se cobra; un reintento es una nueva ejecución y se factura de nuevo. Detalles: Costo, saldo y límites.
Detente ante errores de facturación. Ante insufficient_credits o cualquier error de BILLING_*, el agente se detiene y transmite el mensaje. No reintenta. paid_plan_required significa que el plan del workspace no incluye lo solicitado. El saldo y el gasto provienen de flora_get_usage.
Consulta lentamente, en una sola llamada. El agente guarda cada run_id, espera max(15, 2 × number of runs) segundos entre consultas (15 segundos para hasta 7 ejecuciones, 40 segundos para 20) y las lee todas en una sola llamada a flora_list_generations (hasta 20 run_ids, más technique_id para ejecuciones de Technique). Consultar más rápido devuelve 429 o errores de enfriamiento con retry_after_seconds. Detalles: Ejecuciones.
Nunca vuelvas a lanzar un lote parcial. Los elementos que ya comenzaron cuestan dinero, y una llamada con tiempo agotado puede haber iniciado una ejecución. El agente lee el historial antes de intentarlo de nuevo. Consulta Ejecuciones.
Enlaza con canvas_url. El agente abre los resultados con el canvas_url que cada generación devuelve y nunca construye enlaces de proyecto a partir de IDs.

FLORA MCP, fal, Replicate o la API de un proveedor de modelos?

Las APIs de modelos y agregadores como fal y Replicate devuelven la salida cruda de un modelo a tu código. FLORA MCP está diseñado para trabajo creativo con un agente:

Los resultados llegan a un lienzo. Cada generación se convierte en un nodo en un proyecto de FLORA que tu equipo puede abrir, comparar, editar y ampliar, no en una URL de archivo en un registro de chat.
Los flujos de trabajo de tu equipo vienen incluidos. Tu agente puede ejecutar las Techniques que tu equipo guardó y usar las skills de FLORA.
Facturación y controles de equipo. Los workspaces, miembros, roles, límites de gasto por workspace e informes de uso también se aplican a las ejecuciones del agente. Los precios son las tarifas publicadas por generación de FLORA en Precios de modelos, igual que en la aplicación.
Una conexión, muchas familias de modelos. Modelos de imagen, video, audio, texto y 3D de varios proveedores detrás de un solo inicio de sesión.

Si solo necesitas la salida de un modelo dentro de tu propia aplicación, sin lienzo ni workspace de equipo, la API de un proveedor o un agregador pueden ser más adecuados. Para llamar a FLORA desde tu propio código, usa la API de FLORA.

Términos

Término	Significado
Workspace	Donde viven los proyectos y donde se factura el uso. Puedes pertenecer a varios. Los IDs se ven como `ws_123`.
Proyecto	Un lienzo de FLORA y su contenido. Los IDs se ven como `prj_abc`.
Lienzo	El tablero dentro de un proyecto donde los nodos se colocan y conectan.
Nodo	Un bloque en un lienzo: una imagen, video, texto, Technique u otro paso. Las generaciones llegan como nodos.
Ejecución	Una generación o ejecución de Technique, rastreada por su `run_id`.
Technique	Un flujo de trabajo guardado y reutilizable que tu equipo creó en FLORA. Consulta Techniques.
Recurso	Un archivo en FLORA, subido o generado, con un `asset_id`.
Skill	Instrucciones escritas que un agente sigue para un trabajo más grande, enumeradas por `flora_discover_skills`.

Todo en estos documentos

Inicio rápido: conecta, verifica y crea tu primera imagen.
Instalación: pasos para cada cliente.
Autenticación: OAuth, claves de API, workspaces y desconexión.
Costo, saldo y límites: cotizaciones, saldo y errores de facturación.
Ejecuciones: consultas, tiempos de espera y fallos.
Recetas: trabajos paso a paso.
Referencia de herramientas: cada herramienta y sus argumentos.
Skills y plugins: flujos de trabajo probados y cómo instalarlos.
Solución de problemas: síntomas, causas y soluciones.
Seguridad y datos: qué sale de FLORA y qué puede hacer tu agente.
Registro de cambios: qué cambió y cuándo.
Herramientas retiradas: nombres de herramientas antiguas y qué las reemplazó.
API de FLORA: llama a FLORA desde tu propio código con una clave de API.

Ver: Todo sobre FLORA MCP

{% embed url="https://www.youtube.com/watch?v=74R3pWxmiqc" %} Una introducción a FLORA MCP del equipo de FLORA. {% endembed %}

¿Necesitas ayuda? Envía un correo a support@florafauna.ai.

Instrucciones para el agente

Esta documentación se publica con GitBook. GitBook es la plataforma de documentación diseñada para que tanto humanos como agentes de IA puedan leer, navegar y razonar sobre contenido técnico de manera efectiva. Obtén más información en gitbook.com.

Consultar esta documentación

Si necesitas información adicional que no está disponible directamente en esta página, puedes consultar la documentación haciendo una pregunta.

Realiza una solicitud HTTP GET en la siguiente URL con los parámetros de consulta ask y goal:

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

ask es la pregunta inmediata: debe ser específica, autónoma y estar escrita en lenguaje natural. goal es lo que el usuario intenta lograr en última instancia, la razón por la que necesita la respuesta. Compartirlo ayuda a GitBook a darte una respuesta mejor y más relevante. Un objetivo es más útil cuando describe el resultado que el usuario quiere en lugar de reformular la pregunta. Por ejemplo, con ask=how do I create an API token, un objetivo como automate deployments from our CI pipeline permite que GitBook adapte la respuesta a ese caso de uso.

La respuesta contendrá una respuesta directa a la pregunta y extractos y fuentes relevantes de la documentación.

Usa este mecanismo cuando la respuesta no esté explícitamente presente en la página actual, necesites aclaraciones o contexto adicional, o quieras recuperar secciones relacionadas de la documentación.