FLORA

สำหรับดัชนีเอกสารฉบับสมบูรณ์ ดูที่ llms.txt เวอร์ชัน Markdown ของหน้าเอกสารมีให้โดยการเพิ่ม .md ต่อท้าย URL ของหน้า หน้านี้มีให้ในรูปแบบ Markdown

เอกสาร FLORA MCP

เชื่อมต่อ FLORA กับ Claude, Claude Code, ChatGPT, Codex, Cursor หรือไคลเอนต์ MCP ใดก็ได้ เพื่อให้เอเจนต์ของคุณสร้าง รันเทคนิค และทำงานบนผืนผ้าใบ FLORA ของคุณได้

FLORA MCP คือเซิร์ฟเวอร์ MCP ที่โฮสต์โดย FLORA เชื่อมต่อเพียงครั้งเดียว เอเจนต์ AI ของคุณก็สามารถสร้างภาพ วิดีโอ เสียง ข้อความ และ 3D รันเทคนิคของทีมคุณ และนำผลลัพธ์ไปวางบนผืนผ้าใบ FLORA ของคุณได้ เอกสารเหล่านี้ครอบคลุมการติดตั้ง ฟังก์ชันของแต่ละเครื่องมือ และกฎที่เอเจนต์ของคุณต้องปฏิบัติตาม

การตั้งค่า	ค่า
URL เซิร์ฟเวอร์	https://agents.flora.ai/mcp (ไม่มีเครื่องหมายทับท้าย)
การส่งข้อมูล	Streamable HTTP เป็นเซิร์ฟเวอร์ระยะไกล จึงไม่ต้องติดตั้งอะไรเพิ่มเติม
การเข้าสู่ระบบ	OAuth ด้วยบัญชี FLORA ของคุณ ไคลเอนต์แบบ Headless สามารถส่ง FLORA API key เป็น Authorization: Bearer <key> แทนได้
ชื่อเซิร์ฟเวอร์	flora
ตรวจสอบการทำงาน	ถามเอเจนต์ของคุณ: "แสดงรายการเวิร์กสเปซ FLORA ของฉัน อย่าสร้างอะไร"

• ใครเชื่อมต่อได้บ้าง: API และ MCP มีให้ตั้งแต่แพ็กเกจ Starter ขึ้นไป บัญชีฟรียังสามารถเชื่อมต่อและสร้างผลงานโดยใช้เครดิต $2.50 ที่ทุกเวิร์กสเปซใหม่ได้รับ แต่ละการสร้างจะถูกเรียกเก็บเป็นดอลลาร์สหรัฐไปยังเวิร์กสเปซที่คุณเลือก ดู วิธีคิดค่าบริการ FLORA และ การยืนยันตัวตน
• ทักษะ: เวิร์กโฟลว์ที่ทดสอบแล้ว (การสร้างเป็นชุด, ลูปการปรับแต่ง, การรันเทคนิค และอื่นๆ) อยู่ที่ 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	เว็บและเดสก์ท็อป เพิ่มตัวเชื่อมต่อแบบกำหนดเอง	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	อ่านผลลัพธ์สูงสุด 20 รายการตาม run_id หรือแสดงประวัติ อ่านอย่างเดียว
flora_create_asset	นำไฟล์ของคุณเองเข้าสู่ FLORA จาก URL หรือลิงก์อัปโหลด
flora_run_technique	รันเทคนิคของทีมคุณ ใช้เงิน
flora_get_usage	อ่านยอดคงเหลือและค่าใช้จ่ายเป็นดอลลาร์สหรัฐสำหรับเวิร์กสเปซหรือองค์กร อ่านอย่างเดียว

รายการเต็มพร้อมอาร์กิวเมนต์และตัวอย่างอยู่ใน เอกสารอ้างอิงเครื่องมือ

สิ่งที่เอเจนต์ของคุณทำได้

งาน	สูตร
สร้างภาพ วิดีโอ คลิปเสียง หรือโมเดล 3D จากพรอมต์หรือข้อมูลอ้างอิง	สร้างภาพหรือวิดีโอ
ทำให้ภาพผลิตภัณฑ์เคลื่อนไหว	เปลี่ยนภาพผลิตภัณฑ์เป็นวิดีโอ
สร้าง 20 ถึง 500 ชิ้นจากรายการหรือสเปรดชีต	สร้างเป็นชุด 20 ถึง 500 ชิ้น
รันเทคนิคที่ทีมคุณสร้างขึ้น	รันเทคนิคของทีมคุณ
ใช้ภาพ วิดีโอ เสียง หรือ PDF ของคุณเอง	อัปโหลดภาพ วิดีโอ และไฟล์ของคุณเอง
จัดวางผลลัพธ์บนผืนผ้าใบ	วางผลลัพธ์บนผืนผ้าใบ
สร้างเพิ่มเติมแบบที่คุณชอบ	ปรับปรุงจากรายการโปรด
ได้ผลลัพธ์ที่ดีขึ้นจากพรอมต์ของคุณ	แนะนำเอเจนต์ของคุณเพื่อผลลัพธ์ที่ดีขึ้น

สูตรทั้งหมดอยู่ในดัชนี สูตร

ลำดับเครื่องมือสำหรับงานทั่วไป

งาน	การเรียกใช้ ตามลำดับ
ภาพแรก	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
รันเทคนิค	flora_list_techniques → flora_get_technique → flora_run_technique → flora_list_generations ด้วย run_ids และ technique_id
ใช้ไฟล์ในเครื่อง	flora_create_asset ด้วย source: "signed-url" → อัปโหลด (เชลล์) หรือลิงก์ upload_page (แชท) → flora_complete_asset
ตารางบนผืนผ้าใบ	flora_get_canvas → flora_arrange_canvas ด้วย 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) วินาทีระหว่างการสอบถามแต่ละครั้ง (15 วินาทีสำหรับสูงสุด 7 รัน, 40 วินาทีสำหรับ 20 รัน) และอ่านทั้งหมดในการเรียก flora_list_generations ครั้งเดียว (สูงสุด 20 run_ids บวก technique_id สำหรับรันเทคนิค) การสอบถามที่เร็วเกินไปจะส่งคืน 429 หรือข้อผิดพลาดคูลดาวน์พร้อมกับ retry_after_seconds รายละเอียด: รัน
• ห้ามยิงชุดบางส่วนซ้ำ รายการที่เริ่มไปแล้วมีค่าใช้จ่าย และการเรียกที่หมดเวลาอาจยังเริ่มรันไปแล้ว เอเจนต์จะอ่านประวัติก่อนลองอีกครั้ง ดู รัน
• ลิงก์ด้วย canvas_url เอเจนต์เปิดผลลัพธ์ด้วย canvas_url ที่แต่ละเจเนอเรชันส่งคืน และไม่สร้างลิงก์โปรเจกต์จาก ID

FLORA MCP, fal, Replicate หรือ API ของผู้ให้บริการโมเดล?

API ของโมเดลและตัวรวมอย่าง fal และ Replicate ส่งคืนเอาต์พุตดิบของโมเดลให้กับโค้ดของคุณ FLORA MCP สร้างขึ้นสำหรับงานสร้างสรรค์กับเอเจนต์:

• ผลลัพธ์ลงบนแคนวาส ทุกเจเนอเรชันกลายเป็นโหนดบนโปรเจกต์ FLORA ที่ทีมของคุณสามารถเปิด เปรียบเทียบ แก้ไข และต่อยอดได้ ไม่ใช่ URL ไฟล์ในบันทึกแชท
• เวิร์กโฟลว์ของทีมคุณมาด้วย เอเจนต์ของคุณสามารถรันเทคนิคที่ทีมของคุณบันทึกไว้ และใช้สกิลของ FLORA ได้
• การเรียกเก็บเงินและการควบคุมของทีม เวิร์กสเปซ สมาชิก บทบาท ขีดจำกัดค่าใช้จ่ายต่อเวิร์กสเปซ และรายงานการใช้งานใช้กับรันของเอเจนต์ด้วย ราคาเป็นอัตราต่อเจเนอเรชันที่เผยแพร่ของ FLORA ใน ราคาโมเดล เช่นเดียวกับในแอป
• การเชื่อมต่อเดียว หลายตระกูลโมเดล โมเดลภาพ วิดีโอ เสียง ข้อความ และ 3D จากหลายผู้ให้บริการภายใต้การเข้าสู่ระบบเดียว

หากคุณต้องการเพียงเอาต์พุตของโมเดลเดียวภายในแอปของคุณเอง โดยไม่มีแคนวาสหรือเวิร์กสเปซของทีม API ของผู้ให้บริการหรือตัวรวมอาจเหมาะสมกว่า หากต้องการเรียก FLORA จากโค้ดของคุณเอง ใช้ FLORA API

คำศัพท์

คำศัพท์	ความหมาย
เวิร์กสเปซ	ที่ที่โปรเจกต์อยู่และที่ที่เรียกเก็บค่าการใช้งาน คุณสามารถเป็นสมาชิกได้หลายเวิร์กสเปซ ID มีลักษณะเหมือน ws_123
โปรเจกต์	แคนวาส FLORA หนึ่งอันและเนื้อหาภายใน ID มีลักษณะเหมือน prj_abc
แคนวาส	บอร์ดภายในโปรเจกต์ที่โหนดวางและเชื่อมต่อกัน
โหนด	หนึ่งบล็อกบนแคนวาส: ภาพ วิดีโอ ข้อความ เทคนิค หรือขั้นตอนอื่นๆ เจเนอเรชันลงเป็นโหนด
รัน	หนึ่งเจเนอเรชันหรือการดำเนินการเทคนิค ติดตามโดย run_id
เทคนิค	เวิร์กโฟลว์ที่บันทึกไว้และนำกลับมาใช้ใหม่ได้ซึ่งทีมของคุณสร้างใน FLORA ดู เทคนิค
แอสเซ็ต	ไฟล์ใน 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 เป็นแพลตฟอร์มเอกสารที่ออกแบบมาเพื่อให้ทั้งมนุษย์และเอเจนต์ AI สามารถอ่าน นำทาง และใช้เหตุผลกับเนื้อหาทางเทคนิคได้อย่างมีประสิทธิภาพ เรียนรู้เพิ่มเติมที่ 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 ปรับแต่งคำตอบให้เหมาะกับการใช้งานนั้น

การตอบสนองจะประกอบด้วยคำตอบโดยตรงสำหรับคำถามและข้อความที่เกี่ยวข้องและแหล่งที่มาจากเอกสาร

ใช้กลไกนี้เมื่อคำตอบไม่ได้ปรากฏอย่างชัดเจนในหน้าปัจจุบัน คุณต้องการความชัดเจนหรือบริบทเพิ่มเติม หรือคุณต้องการดึงส่วนเอกสารที่เกี่ยวข้อง