AI entegrasyonu

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

Meshy'i Claude Code, Cursor, Windsurf, Codex veya herhangi bir MCP uyumlu araçtan entegre ediyorsanız, aşağıdaki MCP server'ı kurun. MCP desteği olmayan sade bir sohbet ajanından entegre ediyorsanız, bunun yerine ajanı https://docs.meshy.ai/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 ajanınızın çağırabileceği bir dizi araç olarak sarmalar — bir model oluşturun, bir görevi kontrol edin, sonucu indirin — elle HTTP kodu yazmadan.

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

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

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

Kullanılabilir 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 promptundan dokusuz bir önizleme ağı oluşturur
• meshy_image_to_3d: tek bir görüntüden 3D model oluşturur
• meshy_multi_image_to_3d: aynı nesnenin birden fazla görüntüsünden 3D model oluşturur
• meshy_text_to_3d_refine: bir önizleme ağına doku ekler

Son İşlem

• meshy_remesh: mevcut bir modelin topology ve/veya poligon sayısını değiştirir
• meshy_retexture: mevcut bir modele yeni bir doku uygular
• meshy_rig: 3D insansı bir karaktere iskelet ekler
• meshy_animate: rig'lenmiş bir karaktere animasyon uygular
• meshy_convert: bir modeli başka bir dosya formatına dönüştürür
• meshy_resize: bir modeli gerçek dünya boyutlarına göre yeniden boyutlandırır
• meshy_uv_unwrap: bir model için yeni bir UV yerleşimi oluşturur

Creative Lab

• meshy_creative_lab: bir fotoğrafı tamamlanmış bir Creative Lab ürününe dönüştürür (prototype ve build görevlerini çalıştırır)

Görüntü Oluşturma

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

Görev Yönetimi

• meshy_get_task_status: görev durumunu ve indirme URL'lerini kontrol eder
• meshy_list_tasks: son görevleri listeler, isteğe bağlı olarak türe/duruma göre filtrelenir
• meshy_cancel_task: bir görevi siler. PENDING durumundaki bir görev kaldırılır ve ücreti iade edilir; IN_PROGRESS durumundaki bir görev iptal edilemez (API 409 döndürür); tamamlanmış bir görev silinir.
• meshy_download_model: tamamlanmış bir model dosyasını alır ve yerel olarak kaydeder

Çalışma Alanı

• meshy_list_models: son Metinden 3D'ye modellerinizi listeler (diğer görev türleri için meshy_list_tasks kullanın)

3D Baskı

• meshy_send_to_slicer: kurulu slicer'ları algılar ve modeli bunlardan birinde açmak için bir komut döndürür (yerel olarak çalışır; Meshy API çağrısı yapmaz)
• meshy_analyze_printability: ücretsiz otomatik FDM basılabilirlik kontrolü (su geçirmezlik, hacim, delikler, manifold olmayan kenarlar, bozuk yüzeyler)
• meshy_process_multicolor: dokulu bir modeli baskı için çok renkli bir 3MF dosyasına dönüştürür
• meshy_repair_printability: FDM baskısı için bir modeli onarır

Hesap

• meshy_check_balance: kalan kredileri sorgular

Örnek Promptlar

Bunları başlangıç noktası olarak MCP destekli 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 sınırları, model seçimi, yaygın hatalar).
• llms-full.txt — tek seferlik alım için tüm API sayfalarının tek bir dosyada birleştirilmiş hali.
• Sayfa bazlı Markdown: herhangi bir uç nokta URL'sinin sonuna .md ekleyin. Örnek: https://docs.meshy.ai/api/text-to-3d.md.

Her üçü de dokümantasyon sitesi her derlendiğinde yeniden oluşturulur, bu yüzden HTML dokümanlarından asla sapmazlar.

SSS

MCP server durum bilgisi tutmuyor mu (stateless)?

Evet. MESHY_API_KEY'iniz istek başına kullanılır ve sunucu tarafında asla kalıcı olarak saklanmaz.

MCP, REST API ile aynı maliyete mi sahip?

Evet — her MCP araç çağrısı tek bir REST çağrısına karşılık gelir ve tam olarak aynı oranda kredi 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üzlemini paylaşır. Katman başına sınırlar için Hız Sınırları sayfasına bakın.

MCP hangi Meshy verilerine erişebilir?

Yalnızca MESHY_API_KEY'in REST üzerinden erişebildiği veriler. Kapsamlar ve izinler birebir aynıdır.

Sorunları nasıl bildiririm?

meshy-mcp-server deposunda bir issue açın: https://github.com/meshy-dev/meshy-mcp-server/issues