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

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

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

MCP คืออะไร

Model Context Protocol (MCP) เป็นมาตรฐานเปิดที่ช่วยให้ AI assistant สามารถเรียกใช้เครื่องมือภายนอกและดึง context ที่มีโครงสร้างได้ 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 — สร้างโมเดล 3 มิติจาก prompt ข้อความ
• meshy_image_to_3d — สร้างโมเดล 3 มิติจากภาพเดียว
• meshy_multi_image_to_3d — สร้างโมเดล 3 มิติจากหลายภาพของวัตถุเดียวกัน
• meshy_text_to_3d_refine — เพิ่มเท็กซ์เจอร์ให้กับ preview mesh

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

• meshy_remesh — เปลี่ยน topology และ/หรือจำนวนโพลิกอนของโมเดลที่มีอยู่
• meshy_retexture — นำเท็กซ์เจอร์ใหม่มาใช้กับโมเดลที่มีอยู่
• meshy_rig — เพิ่มโครงกระดูกให้กับตัวละครฮิวแมนอยด์ 3 มิติ
• meshy_animate — นำแอนิเมชันมาใช้กับตัวละครที่มีการ rig แล้ว

การสร้างภาพ

• 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 ที่อยู่ในสถานะ pending หรือกำลังดำเนินการ
• meshy_download_model — ดึงไฟล์โมเดลที่เสร็จสมบูรณ์และบันทึกไว้ในเครื่อง

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

• meshy_list_models — แสดงรายการโมเดลทั้งหมดในพื้นที่ทำงานของผู้ใช้ที่ผ่านการยืนยันตัวตน

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

• meshy_send_to_slicer — ตรวจจับ slicer ที่ติดตั้งไว้และเปิดโมเดลในโปรแกรมนั้น (ทำงานในเครื่องของคุณเอง ไม่มีการเรียก Meshy API)
• meshy_analyze_printability — ปัจจุบันจะคืนค่าเป็นรายการตรวจสอบความพร้อมในการพิมพ์แบบแมนวล (ความหนาผนัง overhang แมนิโฟลด์เมช ฯลฯ) จะได้รับการอัปเกรดเป็นการวิเคราะห์อัตโนมัติเมื่อ Meshy printability API พร้อมใช้งาน
• meshy_process_multicolor — แปลงโมเดลที่มีเท็กซ์เจอร์ให้เป็นไฟล์ 3MF หลายสีสำหรับการพิมพ์

บัญชี

• 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 โดยตรง ให้ชี้ไปที่พื้นผิว plain-text ของเรา:

• llms.txt — ดัชนีแบบกระชับ + คำแนะนำการเชื่อมต่อ (รูปแบบ async-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