การเชื่อมต่อ AI

เชื่อมต่อเอเจนต์ AI และผู้ช่วยเขียนโค้ดเข้ากับ Meshy ด้วย Meshy MCP server สำหรับการเรียกใช้เครื่องมือ หรือด้วย llms.txt และ llms-full.txt สำหรับการอ่านเอกสาร

หากคุณใช้ Claude Code, Cursor, Windsurf, Codex หรือ MCP client อื่น ๆ ให้ติดตั้ง MCP server หากเอเจนต์แชทของคุณไม่รองรับ MCP ให้ชี้ไปที่ https://docs.meshy.ai/llms.txt แทน

MCP คืออะไร

Model Context Protocol (MCP) เป็นมาตรฐานเปิดที่ช่วยให้ผู้ช่วย AI เรียกใช้เครื่องมือภายนอกและรับบริบทที่มีโครงสร้างได้ Meshy MCP server ห่อหุ้ม Meshy REST API ให้เป็นเครื่องมือที่ agent ของคุณสามารถเรียกใช้ได้ ด้วยเครื่องมือเหล่านี้ agent สามารถสร้างโมเดล ตรวจสอบ task และดาวน์โหลดผลลัพธ์ได้โดยไม่ต้องเขียนโค้ด HTTP เอง

MCP server เป็นโอเพนซอร์ส เผยแพร่บน npm ในชื่อ @meshy-ai/meshy-mcp-server และซอร์สโค้ดอยู่ใน meshy-mcp-server repository บน GitHub

คุณต้องมี Meshy API คีย์ สร้างได้ที่ API Keys page ของ Developer Platform MCP server จะอ่านค่านี้จากตัวแปรสภาพแวดล้อม MESHY_API_KEY

ติดตั้ง MCP server

ในการติดตั้ง server ให้ใช้แท็บสำหรับ AI client ของคุณ แทนที่ msy_YOUR_API_KEY ด้วย API คีย์ของคุณ

# Detects installed AI clients and configures Meshy for each
npx add-mcp @meshy-ai/meshy-mcp-server --env MESHY_API_KEY=msy_YOUR_API_KEY

npx skills add meshy-dev/meshy-3d-agent

เครื่องมือที่ใช้งานได้

MCP server นำเสนอ Meshy REST API เป็นเครื่องมือต่อไปนี้ โดยจัดกลุ่มตามความสามารถ

3D generation

• meshy_text_to_3d: สร้างเมชตัวอย่าง (preview) ที่ไม่มีเท็กซ์เจอร์จาก prompt ข้อความ
• meshy_image_to_3d: สร้างโมเดล 3D จากภาพเดียว
• meshy_multi_image_to_3d: สร้างโมเดล 3D จากภาพหลายภาพของวัตถุเดียวกัน
• meshy_text_to_3d_refine: เพิ่มเท็กซ์เจอร์ให้กับเมชตัวอย่าง (preview)

Post-processing

• meshy_remesh: เปลี่ยน topology หรือจำนวนโพลิกอนของโมเดลที่มีอยู่ หรือทั้งสองอย่าง
• meshy_retexture: ใส่เท็กซ์เจอร์ใหม่ให้กับโมเดลที่มีอยู่
• meshy_rig: เพิ่มโครงกระดูกให้กับตัวละครฮิวแมนนอยด์ 3D
• meshy_animate: ใส่แอนิเมชันให้กับตัวละครที่มี rig แล้ว
• meshy_convert: แปลงโมเดลเป็นรูปแบบไฟล์อื่น
• meshy_resize: ปรับขนาดโมเดลให้ตรงกับขนาดจริง
• meshy_uv_unwrap: สร้างเลย์เอาต์ UV ใหม่สำหรับโมเดล
• meshy_text_to_motion: สร้างแอนิเมชันจาก prompt ข้อความ
• meshy_list_animations: ค้นหา ID ของแอนิเมชันที่ตั้งไว้ล่วงหน้า ได้ฟรี

Creative Lab

• meshy_creative_lab: เปลี่ยนภาพถ่ายให้เป็นผลิตภัณฑ์ Creative Lab ที่เสร็จสมบูรณ์ (รัน task ต้นแบบและ build)

Image generation

• meshy_text_to_image: สร้างภาพ 2D จากข้อความ
• meshy_image_to_image: สร้างภาพ 2D จากภาพอ้างอิง

Task management

• meshy_get_task_status: ตรวจสอบสถานะ task และ URL สำหรับดาวน์โหลด
• meshy_list_tasks: แสดงรายการ task ล่าสุด สามารถกรองตามประเภทหรือสถานะได้
• meshy_cancel_task: ลบ task Meshy จะลบและคืนเครดิตสำหรับ task ที่อยู่ในสถานะ PENDING และลบ task ที่เสร็จสิ้นแล้ว ส่วน task ที่อยู่ในสถานะ IN_PROGRESS ไม่สามารถยกเลิกได้ และ API จะส่งคืน 409
• meshy_download_model: ดาวน์โหลดไฟล์โมเดลที่เสร็จสิ้นแล้วและบันทึกไว้ในเครื่อง

Workspace

• meshy_list_models: แสดงรายการโมเดล ข้อความเป็น 3D ล่าสุดของคุณ สำหรับประเภท task อื่น ให้ใช้ meshy_list_tasks

3D printing

• meshy_send_to_slicer: ค้นหาโปรแกรม slicer ที่ติดตั้งอยู่บนคอมพิวเตอร์ของคุณ และส่งคืนคำสั่งสำหรับเปิดโมเดลในโปรแกรมนั้น ทำงานในเครื่องและไม่เรียกใช้ Meshy API
• meshy_analyze_printability: ตรวจสอบความสามารถในการพิมพ์แบบ FDM ของโมเดลได้ฟรี รวมถึงความกันน้ำ ปริมาตร รู ขอบ non-manifold และหน้าเสื่อม
• meshy_process_multicolor: แปลงโมเดลที่มีเท็กซ์เจอร์ให้เป็นไฟล์ 3MF หลายสีสำหรับการพิมพ์
• meshy_repair_printability: ซ่อมแซมโมเดลสำหรับการพิมพ์แบบ FDM
• meshy_auto_split: แบ่งโมเดลออกเป็นชิ้นส่วนที่พิมพ์แยกกันได้

Account

• meshy_check_balance: ตรวจสอบเครดิตที่เหลืออยู่ของคุณ
• meshy_list_usage: แสดงรายการ task API ที่เสร็จสิ้นแล้วของทีมคุณ และเครดิตที่แต่ละ task ใช้ไป สำหรับทีม Studio และ Enterprise

ตัวอย่าง prompt

เริ่มต้นได้โดยลองใช้ prompt เหล่านี้ในแชทที่เปิดใช้งาน MCP ของคุณ:

Generate a 3D fox from the prompt "a cartoon fox sitting", preview it, then
texture it with PBR maps. Download the final GLB to ./outputs.

Take the image at https://example.com/sculpture.jpg and convert it into a
riggable 3D character. Use `should_remesh: true` and 50k target polycount.

What's my current Meshy credit balance?

List my last 10 successful text-to-3d tasks and download the top 3 as GLB
into ./downloads/.

llms.txt และ llms-full.txt

หากเอเจนต์ของคุณไม่รองรับ MCP หรือคุณต้องการนำเอกสาร Meshy ไปใส่ใน prompt โดยตรง ให้ชี้ไปที่เวอร์ชันข้อความธรรมดาของเอกสาร:

• llms.txt: ดัชนีแบบย่อพร้อมคำแนะนำการเชื่อมต่อ เช่น วิธี poll task แบบ async, การยืนยันตัวตน, rate limit, การเลือกโมเดล และข้อผิดพลาดที่พบบ่อย
• llms-full.txt: หน้า API ทั้งหมดอยู่ในไฟล์เดียว เพื่อให้เอเจนต์สามารถอ่านเอกสารได้ในคำขอเดียว
• Markdown รายหน้า: เพิ่ม .md ต่อท้าย URL ของเอนด์พอยต์ใด ๆ ตัวอย่างเช่น https://docs.meshy.ai/api/text-to-3d.md

Meshy จะสร้างไฟล์ทั้งสามใหม่ทุกครั้งที่มีการ build เว็บไซต์เอกสาร เพื่อให้ตรงกับเอกสาร HTML

คำถามที่พบบ่อย

MCP server ไม่มีสถานะ (stateless) หรือไม่?

ไม่มีการเก็บข้อมูลรับรองของคุณ server จะเก็บ MESHY_API_KEY ของคุณไว้ในหน่วยความจำเท่านั้น และไม่เคยเขียนลงดิสก์ โดยค่าเริ่มต้น จะบันทึกโมเดลที่ดาวน์โหลดพร้อมเมทาดาทาไว้ในโฟลเดอร์ meshy_output ภายในไดเรกทอรีทำงานของมัน หากต้องการบันทึกการดาวน์โหลดไว้ที่อื่น ให้กำหนด path save_to ให้กับเครื่องมือดาวน์โหลด

MCP มีค่าใช้จ่ายเท่ากับ REST API หรือไม่?

ใช่ การเรียกใช้เครื่องมือ MCP จะเรียก REST เดียวกันและใช้เครดิตในอัตราเดียวกัน ดูราคาทั้งหมดได้ที่หน้า ราคา

Rate limit คืออะไร?

การเรียกใช้ของ MCP server จะนับรวมใน rate limit เดียวกับการเรียกใช้ REST API ของคุณ ดูขีดจำกัดของแต่ละแพลนได้ที่หน้า Rate limits

MCP server เข้าถึงข้อมูล Meshy อะไรได้บ้าง?

เฉพาะข้อมูลที่ MESHY_API_KEY ของคุณสามารถเข้าถึงได้ผ่าน REST API เท่านั้น โดยมีสิทธิ์เท่ากัน

จะรายงานปัญหาได้อย่างไร?

เปิด issue ใน meshy-mcp-server repository บน GitHub: https://github.com/meshy-dev/meshy-mcp-server/issues