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
Lebih suka skill? Paket skill open-source meshy-3d-agent memiliki alur kerja Meshy yang sudah siap pakai untuk Claude Code, Cursor, dan OpenClaw, seperti membuat model, memantau task, dan mengunduh hasilnya. Paket ini memanggil Meshy API REST secara langsung, jadi Anda tidak memerlukan MCP server.
npx skills add meshy-dev/meshy-3d-agent
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 teksmeshy_image_to_3d: membuat model 3D dari satu gambarmeshy_multi_image_to_3d: membuat model 3D dari beberapa gambar objek yang samameshy_text_to_3d_refine: menambahkan tekstur ke mesh preview
Pasca-pemrosesan
meshy_remesh: mengubah topology atau jumlah poligon dari model yang ada, atau keduanyameshy_retexture: menerapkan tekstur baru ke model yang adameshy_rig: menambahkan kerangka ke karakter humanoid 3Dmeshy_animate: menerapkan animasi ke karakter yang sudah di-rigmeshy_convert: mengonversi model ke format file lainmeshy_resize: mengubah ukuran model sesuai dimensi dunia nyatameshy_uv_unwrap: membuat tata letak UV baru untuk modelmeshy_text_to_motion: membuat animasi dari prompt teksmeshy_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 teksmeshy_image_to_image: membuat gambar 2D dari gambar referensi
Manajemen task
meshy_get_task_status: memeriksa status task dan URL unduhanmeshy_list_tasks: mencantumkan task terbaru, dapat difilter berdasarkan tipe atau statusmeshy_cancel_task: menghapus task. Meshy menghapus dan mengembalikan dana untuk taskPENDING, dan menghapus task yang sudah selesai. TaskIN_PROGRESStidak dapat dibatalkan, dan API akan mengembalikan409.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, gunakanmeshy_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 degenerasimeshy_process_multicolor: mengonversi model bertekstur menjadi file 3MF multi-warna untuk pencetakanmeshy_repair_printability: memperbaiki model untuk pencetakan FDMmeshy_auto_split: membagi model menjadi bagian-bagian yang dapat dicetak secara terpisah
Akun
meshy_check_balance: memeriksa sisa kredit Andameshy_list_usage: mencantumkan task API tim Anda yang sudah selesai dan kredit yang digunakan masing-masing, untuk tim Studio dan Enterprise
Nama dan perilaku tool dapat berubah. Untuk daftar lengkap, lihat tools di sumber MCP server.
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
.mdke URL endpoint mana pun, misalnyahttps://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