AI entegrasyonu

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

Meshy'yi Claude Code, Cursor, Windsurf, Codex veya MCP uyumlu başka bir araçtan entegre ediyorsanız aşağıdaki MCP server'ı kurun. MCP desteği olmayan düz bir sohbet ajanından entegre ediyorsanız bunun yerine onu https://docs.meshy.ai/llms.txt adresine yönlendirin.

MCP nedir

Model Context Protocol (MCP), AI asistanlarının harici araçları çağırmasını ve yapılandırılmış bağlamı almasını sağlayan açık bir standarttır. Meshy MCP server, Meshy REST API'yi ajanınızın çağırabileceği bir araçlar kümesi olarak sarar — model oluşturma, bir görevi kontrol etme, sonucu indirme — HTTP kodunu elle yazmadan.

MCP server açık kaynaklıdır ve npm'de @meshy-ai/meshy-mcp-server olarak yayımlanır. Kaynak: github.com/meshy-dev/meshy-mcp-server.

Bir Meshy API anahtarı gerekir. https://www.meshy.ai/settings/api adresinde 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

Bunun yerine kullanıma hazır bir skill mi tercih edersiniz? Açık kaynaklı meshy-3d-agent skill paketi, Claude Code, Cursor ve OpenClaw için önceden yazılmış Meshy iş akışlarıyla (oluştur → yokla → indir) birlikte gelir. Meshy REST API'yi doğrudan çağırır — MCP server gerekmez.

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

Kullanılabilir Araçlar

MCP server, Meshy REST API'yi yeteneğe göre gruplanmış araçlar olarak sunar.

3D Oluşturma

  • meshy_text_to_3d — bir metin promptundan 3D model oluştur
  • meshy_image_to_3d — tek bir görselden 3D model oluştur
  • meshy_multi_image_to_3d — aynı nesnenin birden fazla görselinden 3D model oluştur
  • meshy_text_to_3d_refine — önizleme ağına doku ekle

Son İşleme

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

Görsel Oluşturma

  • meshy_text_to_image — metinden 2D görsel
  • meshy_image_to_image — bir referans görselden 2D görsel

Görev Yönetimi

  • meshy_get_task_status — görev durumunu ve indirme URL'lerini kontrol et
  • meshy_list_tasks — isteğe bağlı olarak tür/duruma göre filtrelenmiş son görevleri listele
  • 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 — kurulu dilimleyicileri algıla ve modeli bunlardan birinde başlat (makinenizde yerel olarak çalışır; Meshy API çağrısı yoktur)
  • meshy_analyze_printability — şu anda manuel bir baskıya hazır olma kontrol listesi döndürür (duvar kalınlığı, çıkıntılar, manifold ağ vb.). Meshy basılabilirlik API'si kullanılabilir olduğunda otomatik analize yükseltilecektir.
  • meshy_process_multicolor — dokulu bir modeli baskı için çok renkli bir 3MF dosyasına dönüştür

Hesap

  • meshy_check_balance — kalan kredileri sorgula

Araç adları ve davranışları zamanla değişebilir. Yetkili liste MCP server kaynak kodunda yer alır.

Örnek Promptlar

Başlangıç noktası olarak bunları MCP etkin sohbetinize bırakın.

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 dokümanlarını doğrudan bir prompta almak istiyorsanız onu düz metin yüzeylerimize yönlendirin:

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

Üçü de doküman sitesi her oluşturulduğunda yeniden üretilir, bu nedenle HTML dokümanlarından asla sapmazlar.

SSS

MCP server durum bilgisiz mi?
Evet. MESHY_API_KEY'iniz istek başına kullanılır ve sunucu tarafında hiçbir zaman kalıcı olarak saklanmaz.
MCP'nin maliyeti REST API ile aynı mı?
Evet — her MCP araç çağrısı tek bir REST çağrısına eşlenir ve kredileri tam olarak aynı oranda tüketir. Tam matris için Fiyatlandırma sayfasına bakın.
Hız limitleri nelerdir?
MCP server, REST API ile aynı hız limiti düzlemini paylaşır. Katman başına limitler için Hız Limitleri sayfasına bakın.
MCP hangi Meshy verilerine erişebilir?
Yalnızca MESHY_API_KEY'in REST üzerinden erişebildiklerine. Kapsamlar ve izinler aynıdır.
Sorunları nasıl rapor ederim?
meshy-mcp-server deposunda bir issue açın: https://github.com/meshy-dev/meshy-mcp-server/issues