Integrasi AI

Meshy menyediakan dua saluran untuk agen AI dan asisten pemrograman: server Meshy MCP untuk pemanggilan alat, dan llms.txt / llms-full.txt untuk pengambilan dokumen.

Jika Anda mengintegrasikan Meshy dari Claude Code, Cursor, Windsurf, Codex, atau alat lain yang kompatibel dengan MCP, instal server MCP di bawah ini. Jika Anda mengintegrasikan dari agen chat biasa tanpa dukungan MCP, arahkan ke https://docs.meshy.cn/llms.txt sebagai gantinya.

Apa itu MCP

Model Context Protocol (MCP) adalah standar terbuka yang memungkinkan asisten AI memanggil alat eksternal dan mengambil konteks terstruktur. Server Meshy MCP membungkus Meshy REST API sebagai satu set alat yang dapat dipanggil agen Anda — menghasilkan model, memeriksa tugas, mengunduh hasil — tanpa menulis kode HTTP secara manual.

Server MCP bersifat open source dan dipublikasikan di npm sebagai @meshy-ai/meshy-mcp-server. Sumber: github.com/meshy-dev/meshy-mcp-server.

Anda memerlukan kunci API Meshy. Buat satu di https://www.meshy.ai/settings/api. Server MCP membacanya dari variabel lingkungan MESHY_API_KEY.

Instalasi Cepat

# 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 keterampilan drop-in? Paket keterampilan open-source meshy-3d-agent menyediakan alur kerja Meshy yang sudah ditulis sebelumnya (generate → poll → download) untuk Claude Code, Cursor, dan OpenClaw. Ini memanggil Meshy REST API secara langsung — tidak memerlukan server MCP.

npx skills add meshy-dev/meshy-3d-agent

Alat yang Tersedia

Server MCP mengekspos Meshy REST API sebagai alat, dikelompokkan berdasarkan kemampuan.

Generasi 3D

  • meshy_text_to_3d — membuat model 3D 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 pratinjau

Pasca-Pemrosesan

  • meshy_remesh — mengubah topology dan/atau jumlah poligon dari model yang ada
  • 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

Generasi Gambar

  • meshy_text_to_image — gambar 2D dari teks
  • meshy_image_to_image — gambar 2D dari gambar referensi

Manajemen Tugas

  • meshy_get_task_status — memeriksa status tugas dan URL unduhan
  • meshy_list_tasks — daftar tugas terbaru, dapat difilter berdasarkan tipe/status
  • meshy_cancel_task — membatalkan tugas yang tertunda atau sedang berlangsung
  • meshy_download_model — mengambil file model yang telah selesai dan menyimpannya secara lokal

Ruang Kerja

  • meshy_list_models — daftar semua model dalam ruang kerja pengguna yang terautentikasi

Pencetakan 3D

  • meshy_send_to_slicer — mendeteksi slicer yang terinstal dan meluncurkan model dalam satu (berjalan secara lokal di mesin Anda; tidak ada panggilan API Meshy)
  • meshy_analyze_printability — saat ini mengembalikan daftar periksa kesiapan cetak manual (ketebalan dinding, overhang, mesh manifold, dll.). Akan ditingkatkan menjadi analisis otomatis setelah API kemampuan cetak Meshy tersedia.
  • meshy_process_multicolor — mengonversi model bertekstur menjadi file 3MF multi-warna untuk pencetakan

Akun

  • meshy_check_balance — memeriksa saldo kredit yang tersisa

Nama dan perilaku alat dapat berkembang. Daftar otoritatif ada di sumber server MCP.

Contoh Prompt

Masukkan ini ke dalam chat yang mendukung MCP sebagai titik awal.

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 dokumen Meshy langsung ke dalam prompt, arahkan ke permukaan teks biasa kami:

  • llms.txt — indeks ringkas + instruksi integrasi (pola polling asinkron yang benar, aturan autentikasi, batasan laju, pilihan model, kesalahan umum).
  • llms-full.txt — setiap halaman API digabungkan dalam satu file untuk pengambilan satu kali.
  • Markdown per halaman: tambahkan .md ke URL endpoint mana pun. Contoh: https://docs.meshy.cn/api/text-to-3d.md.

Ketiga dokumen ini diperbarui setiap kali situs dokumen dibangun, sehingga tidak pernah menyimpang dari dokumen HTML.

FAQ

Apakah server MCP tanpa status?
Ya. Kunci API MESHY Anda digunakan per permintaan dan tidak pernah disimpan di sisi server.
Apakah biaya MCP sama dengan REST API?
Ya — setiap panggilan alat MCP memetakan ke satu panggilan REST dan mengonsumsi kredit pada tingkat yang sama persis. Lihat halaman Harga untuk matriks lengkap.
Apa batasan laju?
Server MCP berbagi bidang batasan laju yang sama dengan REST API. Lihat halaman Batasan Laju untuk batasan per tingkat.
Data Meshy apa yang dapat diakses MCP?
Hanya apa yang dapat diakses oleh kunci API MESHY melalui REST. Ruang lingkup dan izin identik.
Bagaimana cara melaporkan masalah?
Ajukan masalah di repositori meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues