AI Entegrasyonu

Meshy, AI ajanları ve kodlama asistanları için iki kanal sunar: araç çağırma için Meshy MCP server ve doküman alımı için llms.txt / llms-full.txt.

Claude Code, Cursor, Windsurf, Codex veya başka bir MCP uyumlu araçtan Meshy entegrasyonu yapıyorsanız, aşağıdaki MCP server'ı kurun. MCP desteği olmayan basit bir sohbet ajanından entegrasyon yapıyorsanız, bunun yerine https://docs.meshy.cn/llms.txt adresine yönlendirin.

MCP Nedir

Model Context Protocol (MCP), AI asistanlarının harici araçları çağırmasına ve yapılandırılmış bağlam almasına olanak tanıyan açık bir standarttır. Meshy MCP server, Meshy REST API'sini aracınızın çağırabileceği bir dizi araç olarak sarar — bir model oluşturun, bir görevi kontrol edin, sonucu indirin — HTTP kodu yazmadan.

MCP server açık kaynaklıdır ve npm üzerinde @meshy-ai/meshy-mcp-server olarak yayınlanmıştır. Kaynak: github.com/meshy-dev/meshy-mcp-server.

Bir Meshy API anahtarına ihtiyacınız var. https://www.meshy.ai/settings/api adresinden bir tane oluşturun. MCP server, bunu MESHY_API_KEY ortam değişkeninden okur.

Hızlı Kurulum

# 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

Yerine bir beceri mi tercih ediyorsunuz? Açık kaynaklı meshy-3d-agent beceri paketi, Claude Code, Cursor ve OpenClaw için önceden yazılmış Meshy iş akışları (oluştur → yokla → indir) sunar. Meshy REST API'sini doğrudan çağırır — MCP server gerekmez.

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

Mevcut Araçlar

MCP server, Meshy REST API'sini yeteneklerine göre gruplandırılmış araçlar olarak sunar.

3D Oluşturma

  • meshy_text_to_3d — bir metin prompt'undan 3D model oluştur
  • meshy_image_to_3d — bir görüntüden 3D model oluştur
  • meshy_multi_image_to_3d — aynı nesnenin birden fazla görüntüsünden 3D model oluştur
  • meshy_text_to_3d_refine — bir önizleme ağına doku ekle

Son İşleme

  • meshy_remesh — mevcut bir modelin topology ve/veya poligon sayısını değiştir
  • meshy_retexture — mevcut bir modele yeni bir doku uygula
  • meshy_rig — bir 3D insansı karaktere iskelet ekle
  • meshy_animate — iskeletli bir karaktere animasyon uygula

Görüntü Oluşturma

  • meshy_text_to_image — metinden 2D görüntü
  • meshy_image_to_image — referans bir görüntüden 2D görüntü

Görev Yönetimi

  • meshy_get_task_status — görev durumunu kontrol et ve indirme URL'lerini al
  • meshy_list_tasks — son görevleri listele, isteğe bağlı olarak tür/durum ile filtrele
  • meshy_cancel_task — bekleyen veya devam eden bir görevi iptal et
  • meshy_download_model — tamamlanmış bir model dosyasını al ve yerel olarak kaydet

Çalışma Alanı

  • meshy_list_models — kimliği doğrulanmış kullanıcının çalışma alanındaki tüm modelleri listele

3D Baskı

  • meshy_send_to_slicer — yüklü dilimleyicileri algıla ve modeli birinde başlat (yerel makinenizde çalışır; Meshy API çağrısı yok)
  • meshy_analyze_printability — şu anda manuel baskı hazır olma kontrol listesi döndürür (duvar kalınlığı, çıkıntılar, manifold ağ, vb.). Meshy basılabilirlik API'si kullanıma sunulduğunda otomatik analize yükseltilecektir.
  • meshy_process_multicolor — dokulu bir modeli çok renkli bir 3MF dosyasına dönüştür

Hesap

  • meshy_check_balance — kalan kredileri sorgula

Araç adları ve davranışları değişebilir. Yetkili liste MCP server kaynağında bulunur.

Örnek Prompts

Bunları MCP etkin sohbetinize başlangıç noktası olarak ekleyin.

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 ve llms-full.txt

Ajanınız MCP'yi desteklemiyorsa veya Meshy belgelerini doğrudan bir prompt'a almak istiyorsanız, düz metin yüzeylerimize yönlendirin:

  • llms.txt — kompakt indeks + entegrasyon talimatları (doğru asenkron yoklama deseni, kimlik doğrulama kuralları, hız sınırları, model seçimi, yaygın hatalar).
  • llms-full.txt — her API sayfası tek bir dosyada birleştirilmiş olarak tek seferde alım için.
  • Sayfa başına Markdown: herhangi bir endpoint URL'sine .md ekleyin. Örnek: https://docs.meshy.cn/api/text-to-3d.md.

Üçü de doküman sitesi her oluşturulduğunda yeniden üretilir, böylece HTML belgelerinden asla sapmazlar.

SSS

MCP server durumsuz mu?
Evet. MESHY_API_KEY her istek için kullanılır ve sunucu tarafında asla saklanmaz.
MCP, REST API ile aynı maliyete mi sahip?
Evet — her MCP araç çağrısı tek bir REST çağrısına eşlenir ve kredileri aynı hızda tüketir. Tam matris için Fiyatlandırma sayfasına bakın.
Hız sınırları nelerdir?
MCP server, REST API ile aynı hız sınırı düzlemine sahiptir. Katman başına sınırlar için Hız Sınırları sayfasına bakın.
MCP, hangi Meshy verilerine erişebilir?
Sadece MESHY_API_KEY'in REST üzerinden erişebileceği verilere. Kapsamlar ve izinler aynıdır.
Sorunları nasıl rapor edebilirim?
meshy-mcp-server deposunda bir sorun bildirin: https://github.com/meshy-dev/meshy-mcp-server/issues