lowpoly dihentikan pada 30 Okt 2026. Ganti model sebelum tanggal-tanggal ini agar permintaan tidak error. Lihat semua penghentian

Integrasi AI

Hubungkan agen AI dan asisten coding ke Meshy, dengan MCP server Meshy untuk pemanggilan tool, atau dengan llms.txt dan llms-full.txt untuk membaca dokumentasi.

Jika Anda menggunakan Claude Code, Cursor, Windsurf, Codex, atau klien MCP lainnya, instal MCP server. Jika agen chat Anda tidak mendukung MCP, arahkan ke https://docs.meshy.ai/llms.txt.


Apa itu MCP

Model Context Protocol (MCP) adalah standar terbuka yang memungkinkan asisten AI memanggil tool eksternal dan mendapatkan konteks terstruktur. MCP server Meshy membungkus Meshy API REST sebagai tools yang dapat dipanggil oleh agen Anda. Dengannya, agen dapat membuat model, memeriksa task, dan mengunduh hasilnya tanpa perlu menulis kode HTTP sendiri.

MCP server bersifat open source. Ini dipublikasikan di npm sebagai @meshy-ai/meshy-mcp-server, dan sumbernya berada di repositori meshy-mcp-server di GitHub.

Anda memerlukan kunci API Meshy. Buat satu di halaman API Keys pada Developer Platform. MCP server membacanya dari variabel lingkungan MESHY_API_KEY.


Instal MCP server

Untuk menginstal server, gunakan tab sesuai klien AI Anda. Ganti msy_YOUR_API_KEY dengan kunci API Anda.

# 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

Tools yang tersedia

MCP server menyediakan Meshy API REST sebagai tools berikut, dikelompokkan berdasarkan kemampuannya.

Pembuatan 3D

  • meshy_text_to_3d: membuat mesh preview tanpa tekstur dari prompt teks
  • meshy_image_to_3d: membuat model 3D dari satu gambar
  • meshy_multi_image_to_3d: membuat model 3D dari beberapa gambar objek yang sama
  • meshy_text_to_3d_refine: menambahkan tekstur ke mesh preview

Pasca-pemrosesan

  • meshy_remesh: mengubah topology atau jumlah poligon dari model yang ada, atau keduanya
  • meshy_retexture: menerapkan tekstur baru ke model yang ada
  • meshy_rig: menambahkan kerangka ke karakter humanoid 3D
  • meshy_animate: menerapkan animasi ke karakter yang sudah di-rig
  • meshy_convert: mengonversi model ke format file lain
  • meshy_resize: mengubah ukuran model sesuai dimensi dunia nyata
  • meshy_uv_unwrap: membuat tata letak UV baru untuk model
  • meshy_text_to_motion: membuat animasi dari prompt teks
  • meshy_list_animations: mencari ID aksi animasi preset, secara gratis

Creative Lab

  • meshy_creative_lab: mengubah foto menjadi produk Creative Lab yang sudah jadi (menjalankan task prototype dan build)

Pembuatan gambar

  • meshy_text_to_image: membuat gambar 2D dari teks
  • meshy_image_to_image: membuat gambar 2D dari gambar referensi

Manajemen task

  • meshy_get_task_status: memeriksa status task dan URL unduhan
  • meshy_list_tasks: mencantumkan task terbaru, dapat difilter berdasarkan tipe atau status
  • meshy_cancel_task: menghapus task. Meshy menghapus dan mengembalikan dana untuk task PENDING, dan menghapus task yang sudah selesai. Task IN_PROGRESS tidak dapat dibatalkan, dan API akan mengembalikan 409.
  • meshy_download_model: mengunduh file model yang sudah selesai dan menyimpannya secara lokal

Ruang kerja

  • meshy_list_models: mencantumkan model Teks ke 3D terbaru Anda. Untuk jenis task lainnya, gunakan meshy_list_tasks.

Pencetakan 3D

  • meshy_send_to_slicer: menemukan slicer yang terinstal di komputer Anda, dan mengembalikan perintah yang membuka model di salah satunya. Tool ini berjalan secara lokal dan tidak memanggil Meshy API.
  • meshy_analyze_printability: memeriksa kemampuan cetak FDM suatu model secara gratis, termasuk watertightness, volume, lubang, tepi non-manifold, dan permukaan degenerasi
  • meshy_process_multicolor: mengonversi model bertekstur menjadi file 3MF multi-warna untuk pencetakan
  • meshy_repair_printability: memperbaiki model untuk pencetakan FDM
  • meshy_auto_split: membagi model menjadi bagian-bagian yang dapat dicetak secara terpisah

Akun

  • meshy_check_balance: memeriksa sisa kredit Anda
  • meshy_list_usage: mencantumkan task API tim Anda yang sudah selesai dan kredit yang digunakan masing-masing, untuk tim Studio dan Enterprise

Contoh prompt

Untuk memulai, coba prompt berikut di chat Anda yang mendukung 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 dan llms-full.txt

Jika agen Anda tidak mendukung MCP, atau Anda ingin memasukkan dokumentasi Meshy langsung ke dalam prompt, arahkan ke versi plain-text dari dokumentasi:

  • llms.txt: indeks ringkas dengan instruksi integrasi, seperti cara melakukan polling task asinkron, autentikasi, rate limit, pemilihan model, dan kesalahan umum.
  • llms-full.txt: setiap halaman API dalam satu file, sehingga agen dapat membaca dokumentasi dalam satu permintaan.
  • Markdown per halaman: tambahkan .md ke URL endpoint mana pun, misalnya https://docs.meshy.ai/api/text-to-3d.md.

Meshy membuat ulang ketiganya setiap kali situs dokumentasi dibangun, sehingga tetap sesuai dengan dokumentasi HTML.


FAQ

Apakah MCP server bersifat stateless?
Server ini tidak menyimpan kredensial Anda. Server menyimpan MESHY_API_KEY Anda di memori dan tidak pernah menuliskannya ke disk. Secara default, server menyimpan model yang diunduhnya, beserta metadatanya, di folder meshy_output pada direktori kerjanya. Untuk menyimpan unduhan di tempat lain, berikan path save_to pada tool unduhan.
Apakah MCP memiliki biaya yang sama dengan REST API?
Ya. Pemanggilan tool MCP melakukan panggilan REST yang sama dan menggunakan kredit dengan tarif yang sama. Lihat halaman Harga untuk setiap harganya.
Apa saja rate limit-nya?
Pemanggilan MCP server dihitung dalam rate limit yang sama dengan pemanggilan REST API Anda. Lihat halaman Rate limits untuk batas masing-masing paket.
Data Meshy apa saja yang dapat diakses oleh MCP server?
Hanya yang dapat diakses oleh MESHY_API_KEY Anda melalui REST API, dengan izin yang sama.
Bagaimana cara melaporkan masalah?
Buka issue di repositori meshy-mcp-server di GitHub: https://github.com/meshy-dev/meshy-mcp-server/issues