FLORA

Para o índice completo da documentação, consulte llms.txt. Versões em Markdown das páginas de documentação estão disponíveis adicionando .md às URLs das páginas; esta página está disponível como Markdown.

Documentação do FLORA MCP

Conecte o FLORA ao Claude, Claude Code, ChatGPT, Codex, Cursor ou qualquer cliente MCP para que seu agente possa gerar, executar Techniques e construir em seus canvases do FLORA.

FLORA MCP é o servidor MCP hospedado do FLORA. Conecte-o uma vez e seu agente de IA poderá gerar imagens, vídeo, áudio, texto e 3D, executar as Techniques da sua equipe e colocar os resultados em seus canvases do FLORA. Esta documentação cobre a instalação, o que cada ferramenta faz e as regras que seu agente segue.

Configuração	Valor
URL do servidor	https://agents.flora.ai/mcp (sem barra final)
Transporte	HTTP Streamable. É um servidor remoto, então não há nada para instalar.
Login	OAuth com sua conta FLORA. Clientes headless podem enviar uma chave de API do FLORA como Authorization: Bearer <key> em vez disso.
Nome do servidor	flora
Verifique se funciona	Pergunte ao seu agente: "Liste meus workspaces do FLORA. Não gere nada."

• Quem pode conectar: API e MCP estão incluídos a partir do plano Starter. Uma conta Free também pode conectar e gerar com os $2,50 de uso que todo novo workspace recebe. Cada geração é cobrada em dólares americanos no workspace que você escolher. Consulte Como funciona o preço do FLORA e Autenticação.
• Skills: fluxos de trabalho testados (geração em lote, loops de refinamento, execuções de Techniques e mais) estão em github.com/florafauna-ai/flora-mcp-skills. Seu agente os lista com flora_discover_skills. Consulte Skills e plugins.
• Para agentes: cada página aqui também está em Markdown. Adicione .md a qualquer URL, por exemplo https://docs.flora.ai/mcp.md. O índice completo é https://docs.flora.ai/llms.txt.

Instalar no seu cliente

Claude	Web e Desktop. Adicione um conector personalizado.	Claude
Claude Code	Um comando, ou o plugin com skills.	Claude Code
ChatGPT	FLORA está listado no ChatGPT. Clique em Conectar.	ChatGPT
Codex	Um comando ou config.toml.	Codex
Cursor	Instalação em um clique ou mcp.json.	Cursor
VS Code	Um comando ou .mcp.json.	VS Code
Outros clientes	Windsurf, Gemini CLI, Copilot Studio, Hermes, OpenClaw e qualquer cliente MCP.	Outros clientes

Novo no FLORA MCP? O quickstart leva você da conexão à sua primeira imagem em um canvas.

Comece aqui: oito ferramentas

Sua conexão tem mais ferramentas do que estas (a lista depende da sua conta, plano e cliente; flora_list_tools retorna as que você tem). A maioria dos trabalhos começa com estas oito.

Ferramenta	O que faz
flora_list_workspaces	Lista os workspaces que você pode usar e em qual você está. Somente leitura.
flora_list_projects	Lista projetos (canvases) em um workspace. Somente leitura.
flora_list_models	Lista modelos com seus model_id, custo estimado e parâmetros. Somente leitura.
flora_create_generations	Inicia de 1 a 20 gerações em um canvas, ou cotiza seu custo com quote: true. Gasta dinheiro.
flora_list_generations	Lê até 20 execuções por run_id, ou lista o histórico. Somente leitura.
flora_create_asset	Traz seus próprios arquivos para o FLORA a partir de uma URL ou link de upload.
flora_run_technique	Executa uma das Techniques da sua equipe. Gasta dinheiro.
flora_get_usage	Lê saldo e gastos em dólares americanos para um workspace ou organização. Somente leitura.

A lista completa, com argumentos e exemplos, está na referência de ferramentas.

O que seu agente pode fazer

Tarefa	Receita
Criar uma imagem, vídeo, clipe de áudio ou modelo 3D a partir de um prompt ou referências	Gerar uma imagem ou vídeo
Animar uma foto de produto	Transformar uma foto de produto em vídeo
Criar de 20 a 500 ativos a partir de uma lista ou planilha	Gerar em lote de 20 a 500 ativos
Executar uma Technique que sua equipe construiu	Executar a Technique da sua equipe
Usar suas próprias imagens, vídeos, áudios ou PDFs	Enviar suas próprias imagens, vídeos e arquivos
Dispor resultados em um canvas	Colocar resultados em um canvas
Criar mais como os que você gostou	Iterar sobre favoritos
Obter melhores resultados dos seus prompts	Instruir seu agente para melhores resultados

Todas as receitas estão indexadas em Receitas.

Sequências de ferramentas para tarefas comuns

Tarefa	Chamadas, em ordem
Primeira imagem	flora_list_workspaces → flora_list_projects (ou flora_create_project) → flora_create_generations com quote: true → aprovação → flora_create_generations → flora_list_generations
Vídeo a partir de uma URL de foto	flora_list_workspaces → flora_list_projects → flora_list_models com o vídeo model_id (para ler o nome do campo de imagem) → cotação → flora_create_generations com a URL em params → flora_list_generations
Custo e saldo	flora_list_models (estimated_cost_usd) ou uma chamada quote: true → flora_get_usage
Executar uma Technique	flora_list_techniques → flora_get_technique → flora_run_technique → flora_list_generations com run_ids e technique_id
Usar um arquivo local	flora_create_asset com source: "signed-url" → upload (shell) ou link upload_page (chat) → flora_complete_asset
Grade em um canvas	flora_get_canvas → flora_arrange_canvas com node_ids e layout, ou all: true sozinho
Animar uma imagem do canvas	flora_add_to_canvas (nó de vídeo conectado à imagem) → flora_run_canvas_nodes → flora_list_generations

Regras que seu agente segue

O servidor dá aos agentes estas regras. Elas estão aqui para que você saiba o que esperar e para que possa cobrar seu agente por elas.

• Pergunte qual workspace será cobrado. Uma conexão não está vinculada a um único workspace. Se vários retornarem de flora_list_workspaces e nenhum for o atual, o agente os nomeia e pergunta qual você deseja cobrar. As ferramentas de projeto cobram o workspace do próprio projeto.
• Faça a cotação primeiro, em dólares americanos. O agente chama flora_create_generations com quote: true, mostra o custo em dólares americanos (nunca em créditos) e executa a mesma solicitação sem quote somente após sua aprovação. run_cost e charged_cost são em dólares: 0.009 significa $0,009. Uma execução com falha não é cobrada; uma nova tentativa é uma nova execução e é cobrada novamente. Detalhes: Custo, saldo e limites.
• Pare em erros de cobrança. Em insufficient_credits ou qualquer erro de BILLING_*, o agente para e repassa a mensagem. Ele não tenta novamente. paid_plan_required significa que o plano do workspace não inclui o que foi solicitado. Saldo e gastos vêm de flora_get_usage.
• Consulte lentamente, em uma única chamada. O agente salva cada run_id, aguarda max(15, 2 × number of runs) segundos entre consultas (15 segundos para até 7 execuções, 40 segundos para 20) e lê todas em uma única chamada de flora_list_generations (até 20 run_ids, além de technique_id para execuções de Technique). Consultas mais rápidas retornam 429 ou erros de cooldown com retry_after_seconds. Detalhes: Execuções.
• Nunca dispare novamente um lote parcial. Itens que já começaram custam dinheiro, e uma chamada com timeout pode ter iniciado uma execução. O agente lê o histórico antes de tentar novamente. Veja Execuções.
• Vincule com canvas_url. O agente abre resultados com o canvas_url que cada geração retorna e nunca constrói links de projeto a partir de IDs.

FLORA MCP, fal, Replicate ou a API de um provedor de modelos?

APIs de modelos e agregadores como fal e Replicate retornam a saída bruta de um modelo para o seu código. O FLORA MCP é feito para trabalho criativo com um agente:

• Os resultados chegam em um canvas. Cada geração se torna um nó em um projeto FLORA que sua equipe pode abrir, comparar, editar e desenvolver, não um URL de arquivo em um log de chat.
• Os fluxos de trabalho da sua equipe acompanham. Seu agente pode executar as Techniques que sua equipe salvou e usar as skills do FLORA.
• Cobrança e controles da equipe. Workspaces, membros, papéis, limites de gastos por workspace e relatórios de uso também se aplicam às execuções do agente. Os preços são as tarifas publicadas por geração do FLORA em Preços de modelos, as mesmas do aplicativo.
• Uma conexão, muitas famílias de modelos. Modelos de imagem, vídeo, áudio, texto e 3D de vários provedores atrás de um único login.

Se você só precisa da saída de um modelo dentro do seu próprio aplicativo, sem canvas ou workspace de equipe, a API de um provedor ou um agregador pode ser mais adequado. Para chamar o FLORA a partir do seu próprio código, use a API FLORA.

Termos

Termo	Significado
Workspace	Onde os projetos vivem e onde o uso é cobrado. Você pode pertencer a vários. IDs parecem com ws_123.
Projeto	Um canvas FLORA e seu conteúdo. IDs parecem com prj_abc.
Canvas	O quadro dentro de um projeto onde os nós ficam e se conectam.
Nó	Um bloco em um canvas: uma imagem, vídeo, texto, Technique ou outra etapa. Gerações chegam como nós.
Execução	Uma geração ou execução de Technique, rastreada pelo seu run_id.
Technique	Um fluxo de trabalho salvo e reutilizável que sua equipe criou no FLORA. Veja Techniques.
Asset	Um arquivo no FLORA, enviado ou gerado, com um asset_id.
Skill	Instruções escritas que um agente segue para um trabalho maior, listadas por flora_discover_skills.

Tudo nestes documentos

• Início rápido: conecte-se, verifique e faça sua primeira imagem.
• Instalação: etapas para cada cliente.
• Autenticação: OAuth, chaves de API, workspaces e desconexão.
• Custo, saldo e limites: cotações, saldo e erros de cobrança.
• Execuções: consultas, timeouts e falhas.
• Receitas: trabalhos passo a passo.
• Referência de ferramentas: cada ferramenta e seus argumentos.
• Skills e plugins: fluxos de trabalho testados e como instalá-los.
• Solução de problemas: sintomas, causas e correções.
• Segurança e dados: o que sai do FLORA e o que seu agente pode fazer.
• Changelog: o que mudou e quando.
• Ferramentas aposentadas: nomes de ferramentas antigas e o que as substituiu.
• API FLORA: chame o FLORA a partir do seu próprio código com uma chave de API.

Assista: Tudo sobre FLORA MCP

{% embed url="https://www.youtube.com/watch?v=74R3pWxmiqc" %} Uma introdução ao FLORA MCP pela equipe FLORA. {% endembed %}

Precisa de ajuda? Envie um e-mail para support@florafauna.ai.

---

Instruções do agente

Esta documentação é publicada com GitBook. GitBook é a plataforma de documentação projetada para que tanto humanos quanto agentes de IA possam ler, navegar e raciocinar sobre conteúdo técnico de forma eficaz. Saiba mais em gitbook.com.

Consultando esta documentação

Se você precisar de informações adicionais que não estão diretamente disponíveis nesta página, você pode consultar a documentação fazendo uma pergunta.

Faça uma solicitação HTTP GET no seguinte URL com os parâmetros de consulta ask e goal:

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

ask é a pergunta imediata: deve ser específica, autocontida e escrita em linguagem natural. goal é o que o usuário está, em última instância, tentando alcançar, o motivo pelo qual precisa da resposta. Compartilhá-lo ajuda o GitBook a dar uma resposta melhor e mais relevante. Uma meta é mais útil quando descreve o resultado que o usuário deseja, em vez de reformular a pergunta. Por exemplo, com ask=how do I create an API token, uma meta como automate deployments from our CI pipeline permite que o GitBook adapte a resposta a esse caso de uso.

A resposta conterá uma resposta direta à pergunta e trechos e fontes relevantes da documentação.

Use este mecanismo quando a resposta não estiver explicitamente presente na página atual, você precisar de esclarecimento ou contexto adicional, ou quiser recuperar seções relacionadas da documentação.