FLORA
공식FLORA MCP를 통해 사용자는 대화에서 직접 히어로 이미지, 무드보드, 라이프스타일 샷, 프로모 그래픽 등 시각 자산을 생성, 정리, 반복 개선할 수 있으며, 이를 팀이 이미 사용 중인 도구(Notion, Google Drive, Slack, 캘린더)로 전달할 수 있습니다.
FLORA MCP(으)로 무엇을 할 수 있나요?
- 프롬프트로 미디어 생성 — 어시스턴트에게
flora_create_generations를 통해 이미지, 비디오, 오디오, 텍스트 또는 3D 모델을 만들도록 요청하고, 결과는 캔버스에 표시됩니다. - 팀 테크닉 실행 — 에이전트가
flora_list_techniques로 사용 가능한 옵션을 나열한 후flora_run_technique를 호출하여 저장된 워크플로우를 실행하게 하세요. - 지출 전 비용 확인 —
flora_create_generations에quote: true를 사용하여 예상 USD 비용을 확인하고,flora_get_usage로 잔액을 확인하세요. - 캔버스 레이아웃 관리 — 특정
node_ids와layout을 사용하여flora_arrange_canvas로 프로젝트 보드에 생성 노드를 배치하도록 어시스턴트에게 지시하세요. - 로컬 파일 업로드 및 사용 — 에이전트에게
flora_create_asset을 통해 FLORA에 직접 이미지나 비디오를 가져오도록 요청한 후,flora_complete_asset으로 업로드를 완료하세요. - 사용 가능한 스킬 탐색 — 어시스턴트가
flora_discover_skills를 호출하여 테스트된 워크플로우와 플러그인을 나열하고, 사전 구축된 자동화 레시피를 찾도록 하세요.
문서
전체 문서 색인은 llms.txt를 참조하세요. 문서 페이지의 Markdown 버전은 페이지 URL에
.md을 추가하여 사용할 수 있습니다. 이 페이지는 Markdown으로도 제공됩니다.
FLORA MCP 문서
FLORA를 Claude, Claude Code, ChatGPT, Codex, Cursor 또는 모든 MCP 클라이언트에 연결하여 에이전트가 FLORA 캔버스에서 Techniques를 생성, 실행하고 작업을 구축할 수 있게 하세요.
FLORA MCP는 FLORA의 호스팅 MCP 서버입니다. 한 번 연결하면 AI 에이전트가 이미지, 비디오, 오디오, 텍스트 및 3D를 생성하고, 팀의 Techniques를 실행하며, 결과를 FLORA 캔버스에 배치할 수 있습니다. 이 문서는 설치 방법, 각 도구의 기능, 에이전트가 따르는 규칙을 다룹니다.
| 설정 | 값 |
|---|---|
| 서버 URL | https://agents.flora.ai/mcp (끝에 슬래시 없음) |
| 전송 방식 | Streamable HTTP. 원격 서버이므로 설치할 것이 없습니다. |
| 로그인 | FLORA 계정으로 OAuth. 헤드리스 클라이언트는 Authorization: Bearer <key> 대신 FLORA API 키를 보낼 수 있습니다. |
| 서버 이름 | flora |
| 작동 확인 | 에이전트에게 "내 FLORA 워크스페이스를 나열해. 아무것도 생성하지 마."라고 요청하세요. |
- 연결 가능 대상: API 및 MCP는 Starter 요금제부터 포함됩니다. Free 계정도 연결하여 새 워크스페이스마다 제공되는 $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 with quote: true → 승인 → flora_create_generations → flora_list_generations |
| 사진 URL에서 비디오 | flora_list_workspaces → flora_list_projects → flora_list_models with the video model_id (이미지 필드 이름을 읽기 위해) → 견적 → flora_create_generations with the URL in 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 with run_ids 및 technique_id |
| 로컬 파일 사용 | flora_create_asset with source: "signed-url" → 업로드(셸) 또는 upload_page 링크(채팅) → flora_complete_asset |
| 캔버스의 그리드 | flora_get_canvas → flora_arrange_canvas with 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과 함께 쿨다운 오류를 반환합니다. 자세한 내용: Runs. - 부분 배치를 다시 실행하지 마세요. 이미 시작된 항목은 비용이 발생하며, 시간 초과된 호출도 실행을 시작했을 수 있습니다. 에이전트는 다시 시도하기 전에 기록을 읽습니다. Runs를 참조하세요.
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 키, 워크스페이스 및 연결 해제.
- 비용, 잔액 및 한도: 견적, 잔액 및 청구 오류.
- Runs: 폴링, 시간 초과 및 실패.
- 레시피: 단계별 작업.
- 도구 참조: 모든 도구와 인수.
- 스킬 및 플러그인: 테스트된 워크플로우와 설치 방법.
- 문제 해결: 증상, 원인 및 해결 방법.
- 보안 및 데이터: FLORA에서 나가는 것과 에이전트가 할 수 있는 일.
- 변경 로그: 무엇이 언제 변경되었는지.
- 폐기된 도구: 이전 도구 이름과 대체된 도구.
- FLORA API: API 키로 자체 코드에서 FLORA 호출.
시청: Everything About FLORA MCP
{% embed url="https://www.youtube.com/watch?v=74R3pWxmiqc" %} FLORA 팀의 FLORA MCP 소개. {% endembed %}
도움이 필요하신가요? support@florafauna.ai로 이메일을 보내세요.
에이전트 지침
이 문서는 GitBook으로 게시됩니다. GitBook은 인간과 AI 에이전트 모두가 기술 콘텐츠를 효과적으로 읽고, 탐색하고, 추론할 수 있도록 설계된 문서 플랫폼입니다. 자세한 내용은 gitbook.com에서 확인하세요.
이 문서 쿼리하기
이 페이지에서 직접 제공되지 않는 추가 정보가 필요하면, 질문을 통해 문서를 쿼리할 수 있습니다.
ask 및 goal 쿼리 매개변수와 함께 다음 URL에 HTTP GET 요청을 수행하세요:
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이 해당 사용 사례에 맞게 답변을 조정할 수 있게 합니다.
응답에는 질문에 대한 직접적인 답변과 문서의 관련 발췌문 및 출처가 포함됩니다.
답변이 현재 페이지에 명시적으로 없거나, 설명이나 추가 컨텍스트가 필요하거나, 관련 문서 섹션을 검색하려는 경우 이 메커니즘을 사용하세요.