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

Meshy เปิดช่องทางสองช่องทางสำหรับ AI agent และเครื่องมือช่วยเขียนโค้ด: Meshy MCP server สำหรับการเรียกใช้เครื่องมือ (tool-calling) และ llms.txt / llms-full.txt สำหรับการนำเข้าเอกสาร

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

MCP คืออะไร

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

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

ติดตั้งอย่างรวดเร็ว

# 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

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

การประมวลผลภายหลัง

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

Creative Lab

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

การสร้างภาพ

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

การจัดการ Task

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

พื้นที่ทำงาน

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

การพิมพ์ 3 มิติ

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

บัญชี

• meshy_check_balance: ตรวจสอบเครดิตที่เหลืออยู่

ตัวอย่าง Prompt

ลองนำสิ่งเหล่านี้ไปใส่ใน chat ที่รองรับ 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

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

• llms.txt — ดัชนีแบบกระชับ + คำแนะนำการเชื่อมต่อ (รูปแบบการ polling แบบอะซิงโครนัสที่ถูกต้อง กฎการยืนยันตัวตน ขีดจำกัดอัตรา การเลือกโมเดล ข้อผิดพลาดที่พบบ่อย)
• llms-full.txt — ทุกหน้าของ API รวมกันเป็นไฟล์เดียวสำหรับการดึงข้อมูลครั้งเดียว
• Markdown รายหน้า: เพิ่ม .md ต่อท้าย URL ของเอนด์พอยต์ใดก็ได้ ตัวอย่าง: https://docs.meshy.ai/api/text-to-3d.md

ทั้งสามรายการจะถูกสร้างใหม่ทุกครั้งที่เว็บไซต์เอกสารถูก build ดังนั้นจึงไม่มีทางเบี่ยงเบนไปจากเอกสาร HTML

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

Is the MCP server stateless?

Yes. Your MESHY_API_KEY is used per request and never persisted on the server side.

Does MCP cost the same as the REST API?

Yes — every MCP tool call maps to a single REST call and consumes credits at the exact same rate. See the Pricing page for the full matrix.

What are the rate limits?

The MCP server shares the same rate-limit plane as the REST API. See the Rate Limits page for per-tier limits.

What Meshy data can the MCP access?

Only what the MESHY_API_KEY can access via REST. Scopes and permissions are identical.

How do I report issues?

File an issue at the meshy-mcp-server repository: https://github.com/meshy-dev/meshy-mcp-server/issues