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

Meshy เปิดให้ใช้งานสองช่องทางสำหรับ AI agents และผู้ช่วยเขียนโค้ด: Meshy MCP server สำหรับการเรียกใช้เครื่องมือ และ 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 สามารถเรียกใช้เครื่องมือภายนอกและดึงบริบทที่มีโครงสร้างได้ Meshy MCP server ห่อหุ้ม Meshy REST API เป็นชุดเครื่องมือที่ agent ของคุณสามารถเรียกใช้ได้ — สร้างโมเดล ตรวจสอบงาน ดาวน์โหลดผลลัพธ์ — โดยไม่ต้องเขียนโค้ด 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

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

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

การสร้าง 3 มิติ

  • meshy_text_to_3d — สร้างโมเดล 3 มิติจาก text 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 — ใช้แอนิเมชันกับตัวละครที่ rig แล้ว

การสร้างรูปภาพ

  • meshy_text_to_image — รูปภาพ 2D จากข้อความ
  • meshy_image_to_image — รูปภาพ 2D จากรูปภาพอ้างอิง

การจัดการงาน

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

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

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

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

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

บัญชี

  • meshy_check_balance — สอบถามเครดิตที่เหลืออยู่

ตัวอย่าง 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

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

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

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


FAQ

MCP server เป็น stateless หรือไม่?
ใช่ MESHY_API_KEY ของคุณจะถูกใช้ต่อคำขอแต่ละครั้งและไม่ถูกเก็บไว้ที่ฝั่งเซิร์ฟเวอร์
MCP มีค่าใช้จ่ายเท่ากับ REST API หรือไม่?
ใช่ — ทุกการเรียกเครื่องมือ MCP จะ map ไปยังการเรียก REST หนึ่งครั้งและใช้เครดิตในอัตราเดียวกันทุกประการ ดูหน้า Pricing สำหรับ matrix ทั้งหมด
rate limits คืออะไร?
MCP server ใช้ระนาบ rate-limit เดียวกันกับ REST API ดูหน้า Rate Limits สำหรับขีดจำกัดตามแต่ละ tier
MCP สามารถเข้าถึงข้อมูล Meshy ใดได้บ้าง?
เฉพาะสิ่งที่ MESHY_API_KEY สามารถเข้าถึงได้ผ่าน REST เท่านั้น Scopes และสิทธิ์เหมือนกันทุกประการ
ฉันจะรายงานปัญหาได้อย่างไร?
เปิด issue ที่ repository meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues