FLORA

Để xem mục lục tài liệu đầy đủ, hãy xem llms.txt. Các phiên bản Markdown của các trang tài liệu có sẵn bằng cách thêm .md vào URL của trang; trang này có sẵn dưới dạng Markdown.

Tài liệu FLORA MCP

Kết nối FLORA với Claude, Claude Code, ChatGPT, Codex, Cursor hoặc bất kỳ máy khách MCP nào để agent của bạn có thể tạo, chạy Techniques và xây dựng trên các canvas FLORA của bạn.

FLORA MCP là máy chủ MCP được lưu trữ của FLORA. Kết nối một lần và agent AI của bạn có thể tạo hình ảnh, video, âm thanh, văn bản và 3D, chạy Techniques của nhóm bạn và đưa kết quả lên các canvas FLORA của bạn. Tài liệu này bao gồm cách cài đặt, chức năng của từng công cụ và các quy tắc mà agent của bạn tuân theo.

Cài đặt	Giá trị
URL máy chủ	https://agents.flora.ai/mcp (không có dấu gạch chéo cuối)
Giao thức vận chuyển	Streamable HTTP. Đây là máy chủ từ xa, vì vậy không có gì để cài đặt.
Đăng nhập	OAuth với tài khoản FLORA của bạn. Máy khách headless có thể gửi khóa API FLORA dưới dạng Authorization: Bearer <key> thay thế.
Tên máy chủ	flora
Kiểm tra hoạt động	Hỏi agent của bạn: "Liệt kê các workspace FLORA của tôi. Đừng tạo bất cứ thứ gì."

• Ai có thể kết nối: API và MCP được bao gồm từ gói Starter trở lên. Tài khoản Free cũng có thể kết nối và tạo với $2.50 sử dụng mà mỗi workspace mới nhận được. Mỗi lần tạo được tính phí bằng đô la Mỹ vào workspace bạn chọn. Xem Cách hoạt động của giá FLORA và Xác thực.
• Kỹ năng: các quy trình làm việc đã được kiểm tra (tạo hàng loạt, vòng lặp tinh chỉnh, chạy Technique và hơn thế nữa) nằm tại github.com/florafauna-ai/flora-mcp-skills. Agent của bạn liệt kê chúng bằng flora_discover_skills. Xem Kỹ năng và plugin.
• Dành cho agent: mọi trang ở đây cũng là Markdown. Thêm .md vào bất kỳ URL nào, ví dụ https://docs.flora.ai/mcp.md. Chỉ mục đầy đủ là https://docs.flora.ai/llms.txt.

Cài đặt trong máy khách của bạn

Claude	Web và Desktop. Thêm trình kết nối tùy chỉnh.	Claude
Claude Code	Một lệnh, hoặc plugin với các kỹ năng.	Claude Code
ChatGPT	FLORA được liệt kê trong ChatGPT. Nhấp vào Kết nối.	ChatGPT
Codex	Một lệnh hoặc config.toml.	Codex
Cursor	Cài đặt một cú nhấp chuột hoặc mcp.json.	Cursor
VS Code	Một lệnh hoặc .mcp.json.	VS Code
Máy khách khác	Windsurf, Gemini CLI, Copilot Studio, Hermes, OpenClaw và bất kỳ máy khách MCP nào.	Máy khách khác

Mới dùng FLORA MCP? Khởi động nhanh sẽ đưa bạn từ việc kết nối đến hình ảnh đầu tiên trên canvas.

Bắt đầu ở đây: tám công cụ

Kết nối của bạn có nhiều công cụ hơn những công cụ này (danh sách phụ thuộc vào tài khoản, gói và máy khách của bạn; flora_list_tools trả về những công cụ bạn có). Hầu hết các công việc bắt đầu với tám công cụ này.

Công cụ	Chức năng
flora_list_workspaces	Liệt kê các workspace bạn có thể sử dụng và workspace bạn đang ở. Chỉ đọc.
flora_list_projects	Liệt kê các dự án (canvas) trong một workspace. Chỉ đọc.
flora_list_models	Liệt kê các mô hình với model_id, chi phí ước tính và tham số của chúng. Chỉ đọc.
flora_create_generations	Bắt đầu 1 đến 20 lần tạo trên một canvas, hoặc báo giá chi phí của chúng bằng quote: true. Tiêu tiền.
flora_list_generations	Đọc tối đa 20 lần chạy theo run_id, hoặc liệt kê lịch sử. Chỉ đọc.
flora_create_asset	Đưa tệp của riêng bạn vào FLORA từ một URL hoặc liên kết tải lên.
flora_run_technique	Chạy một trong các Technique của nhóm bạn. Tiêu tiền.
flora_get_usage	Đọc số dư và chi tiêu bằng đô la Mỹ cho một workspace hoặc tổ chức. Chỉ đọc.

Danh sách đầy đủ, với các đối số và ví dụ, nằm trong tham chiếu công cụ.

Những gì agent của bạn có thể làm

Công việc	Công thức
Tạo hình ảnh, video, đoạn âm thanh hoặc mô hình 3D từ lời nhắc hoặc tài liệu tham khảo	Tạo hình ảnh hoặc video
Làm hoạt ảnh cho ảnh sản phẩm	Biến ảnh sản phẩm thành video
Tạo 20 đến 500 tài sản từ danh sách hoặc bảng tính	Tạo hàng loạt 20 đến 500 tài sản
Chạy một Technique mà nhóm bạn đã xây dựng	Chạy Technique của nhóm bạn
Sử dụng hình ảnh, video, âm thanh hoặc PDF của riêng bạn	Tải lên hình ảnh, video và tệp của riêng bạn
Bố trí kết quả trên một canvas	Đặt kết quả lên canvas
Tạo thêm những thứ giống như những thứ bạn thích	Lặp lại trên các mục yêu thích
Cải thiện kết quả từ lời nhắc của bạn	Hướng dẫn agent của bạn để có đầu ra tốt hơn

Tất cả các công thức được lập chỉ mục trong Công thức.

Chuỗi công cụ cho các công việc phổ biến

Công việc	Các lệnh gọi, theo thứ tự
Hình ảnh đầu tiên	flora_list_workspaces → flora_list_projects (hoặc flora_create_project) → flora_create_generations với quote: true → phê duyệt → flora_create_generations → flora_list_generations
Video từ URL ảnh	flora_list_workspaces → flora_list_projects → flora_list_models với video model_id (để đọc tên trường hình ảnh của nó) → báo giá → flora_create_generations với URL trong params → flora_list_generations
Chi phí và số dư	flora_list_models (estimated_cost_usd) hoặc một lệnh gọi quote: true → flora_get_usage
Chạy một Technique	flora_list_techniques → flora_get_technique → flora_run_technique → flora_list_generations với run_ids và technique_id
Sử dụng tệp cục bộ	flora_create_asset với source: "signed-url" → tải lên (shell) hoặc liên kết upload_page (trò chuyện) → flora_complete_asset
Lưới trên canvas	flora_get_canvas → flora_arrange_canvas với node_ids và layout, hoặc chỉ all: true
Làm hoạt ảnh cho hình ảnh canvas	flora_add_to_canvas (nút video được kết nối với hình ảnh) → flora_run_canvas_nodes → flora_list_generations

Quy tắc agent của bạn tuân theo

Máy chủ cung cấp cho agent các quy tắc này. Chúng ở đây để bạn biết điều gì sẽ xảy ra và để bạn có thể giữ agent của mình tuân thủ chúng.

• Hỏi workspace nào sẽ được tính phí. Một kết nối không gắn với một workspace duy nhất. Nếu nhiều workspace trả về từ flora_list_workspaces và không có workspace nào đang hoạt động, agent sẽ liệt kê chúng và hỏi bạn muốn tính phí cho workspace nào. Các công cụ dự án sẽ tính phí vào workspace của chính dự án đó.
• Báo giá trước, bằng đô la Mỹ. Agent gọi flora_create_generations với quote: true, hiển thị cho bạn chi phí bằng đô la Mỹ (không bao giờ bằng tín dụng), và chỉ chạy cùng một yêu cầu mà không có quote sau khi bạn phê duyệt. run_cost và charged_cost là đô la: 0.009 nghĩa là $0,009. Một lần chạy thất bại không bị tính phí; một lần thử lại là một lần chạy mới và sẽ bị tính phí lần nữa. Chi tiết: Chi phí, số dư và giới hạn.
• Dừng lại khi gặp lỗi thanh toán. Khi gặp insufficient_credits hoặc bất kỳ lỗi BILLING_* nào, agent sẽ dừng lại và chuyển tiếp thông báo. Nó không thử lại. paid_plan_required nghĩa là gói của workspace không bao gồm những gì được yêu cầu. Số dư và chi tiêu lấy từ flora_get_usage.
• Thăm dò chậm, trong một lần gọi. Agent lưu mọi run_id, chờ max(15, 2 × number of runs) giây giữa các lần thăm dò (15 giây cho tối đa 7 lần chạy, 40 giây cho 20 lần), và đọc tất cả chúng trong một lần gọi flora_list_generations (tối đa 20 run_ids, cộng thêm technique_id cho các lần chạy Technique). Thăm dò nhanh hơn sẽ trả về 429 hoặc lỗi thời gian chờ với retry_after_seconds. Chi tiết: Các lần chạy.
• Không bao giờ kích hoạt lại một phần của batch. Các mục đã bắt đầu đã tốn tiền, và một lần gọi hết thời gian vẫn có thể đã bắt đầu một lần chạy. Agent đọc lịch sử trước khi thử lại. Xem Các lần chạy.
• Liên kết bằng canvas_url. Agent mở kết quả bằng canvas_url mà mỗi lần tạo trả về và không bao giờ xây dựng liên kết dự án từ ID.

FLORA MCP, fal, Replicate hay API của nhà cung cấp mô hình?

API mô hình và các nền tảng tổng hợp như fal và Replicate trả về đầu ra thô của mô hình cho mã của bạn. FLORA MCP được xây dựng cho công việc sáng tạo với agent:

• Kết quả nằm trên canvas. Mỗi lần tạo trở thành một nút trên dự án FLORA mà nhóm của bạn có thể mở, so sánh, chỉnh sửa và phát triển, không phải là một URL tệp trong nhật ký trò chuyện.
• Quy trình làm việc của nhóm đi kèm. Agent của bạn có thể chạy các Technique mà nhóm đã lưu và sử dụng các kỹ năng của FLORA.
• Thanh toán và kiểm soát theo nhóm. Workspace, thành viên, vai trò, giới hạn chi tiêu theo workspace và báo cáo sử dụng cũng áp dụng cho các lần chạy của agent. Giá là mức giá công bố cho mỗi lần tạo của FLORA tại Bảng giá mô hình, giống như trong ứng dụng.
• Một kết nối, nhiều họ mô hình. Mô hình hình ảnh, video, âm thanh, văn bản và 3D từ nhiều nhà cung cấp chỉ với một lần đăng nhập.

Nếu bạn chỉ cần đầu ra của một mô hình trong ứng dụng của riêng mình, không cần canvas hay workspace nhóm, API của nhà cung cấp hoặc nền tảng tổng hợp có thể phù hợp hơn. Để gọi FLORA từ mã của riêng bạn, hãy sử dụng FLORA API.

Thuật ngữ

Thuật ngữ	Ý nghĩa
Workspace	Nơi các dự án lưu trú và nơi mức sử dụng được tính phí. Bạn có thể thuộc về nhiều workspace. ID trông giống như ws_123.
Dự án	Một canvas FLORA và nội dung của nó. ID trông giống như prj_abc.
Canvas	Bảng bên trong dự án nơi các nút nằm và kết nối với nhau.
Nút	Một khối trên canvas: hình ảnh, video, văn bản, Technique hoặc bước khác. Các lần tạo trở thành nút.
Lần chạy	Một lần tạo hoặc thực thi Technique, được theo dõi bằng run_id.
Technique	Một quy trình làm việc có thể tái sử dụng đã lưu mà nhóm của bạn xây dựng trong FLORA. Xem Techniques.
Tài sản	Một tệp trong FLORA, được tải lên hoặc tạo ra, có asset_id.
Kỹ năng	Hướng dẫn bằng văn bản mà agent tuân theo cho một công việc lớn hơn, được liệt kê bởi flora_discover_skills.

Mọi thứ trong tài liệu này

• Bắt đầu nhanh: kết nối, kiểm tra và tạo hình ảnh đầu tiên của bạn.
• Cài đặt: các bước cho từng ứng dụng khách.
• Xác thực: OAuth, khóa API, workspace và ngắt kết nối.
• Chi phí, số dư và giới hạn: báo giá, số dư và lỗi thanh toán.
• Các lần chạy: thăm dò, hết thời gian và lỗi.
• Công thức: các công việc từng bước.
• Tài liệu tham khảo công cụ: mọi công cụ và đối số của nó.
• Kỹ năng và plugin: các quy trình đã kiểm thử và cách cài đặt chúng.
• Xử lý sự cố: triệu chứng, nguyên nhân và cách khắc phục.
• Bảo mật và dữ liệu: những gì rời khỏi FLORA và agent của bạn có thể làm gì.
• Nhật ký thay đổi: những gì đã thay đổi và khi nào.
• Công cụ đã ngừng sử dụng: tên công cụ cũ và những gì đã thay thế chúng.
• FLORA API: gọi FLORA từ mã của riêng bạn bằng khóa API.

Xem: Mọi thứ về FLORA MCP

{% embed url="https://www.youtube.com/watch?v=74R3pWxmiqc" %} Giới thiệu về FLORA MCP từ đội ngũ FLORA. {% endembed %}

Cần trợ giúp? Gửi email đến support@florafauna.ai.

---

Hướng dẫn cho Agent

Tài liệu này được xuất bản bằng GitBook. GitBook là nền tảng tài liệu được thiết kế để cả con người và agent AI có thể đọc, điều hướng và suy luận về nội dung kỹ thuật một cách hiệu quả. Tìm hiểu thêm tại gitbook.com.

Truy vấn tài liệu này

Nếu bạn cần thông tin bổ sung không có trực tiếp trên trang này, bạn có thể truy vấn tài liệu bằng cách đặt câu hỏi.

Thực hiện yêu cầu HTTP GET trên URL sau với các tham số truy vấn ask và goal:

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

ask là câu hỏi trực tiếp: nó phải cụ thể, tự chứa đầy đủ và được viết bằng ngôn ngữ tự nhiên. goal là điều người dùng cuối cùng đang cố gắng đạt được, lý do họ cần câu trả lời. Chia sẻ mục tiêu giúp GitBook đưa ra câu trả lời tốt hơn và phù hợp hơn. Mục tiêu hữu ích nhất khi nó mô tả kết quả người dùng muốn thay vì diễn đạt lại câu hỏi. Ví dụ, với ask=how do I create an API token, một mục tiêu như automate deployments from our CI pipeline cho phép GitBook điều chỉnh câu trả lời cho trường hợp sử dụng đó.

Phản hồi sẽ chứa câu trả lời trực tiếp cho câu hỏi cùng các đoạn trích và nguồn liên quan từ tài liệu.

Sử dụng cơ chế này khi câu trả lời không có sẵn rõ ràng trên trang hiện tại, bạn cần làm rõ hoặc thêm ngữ cảnh, hoặc bạn muốn truy xuất các phần tài liệu liên quan.