AI entegrasyonu

Araç çağrıları için Meshy MCP server'ı veya dokümanları okumak için llms.txt ve llms-full.txt kullanarak AI ajanlarını ve kodlama asistanlarını Meshy'ye bağlayın.

Claude Code, Cursor, Windsurf, Codex veya başka bir MCP istemcisi kullanıyorsanız MCP server'ı yükleyin. Sohbet ajanınız MCP'yi desteklemiyorsa, onu bunun yerine 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 araçlar olarak sarmalar. Bu araçlarla ajan, elle yazılmış HTTP kodu olmadan bir model oluşturabilir, bir görevi kontrol edebilir ve sonucu indirebilir.

MCP server'ı açık kaynaktır. npm üzerinde @meshy-ai/meshy-mcp-server olarak yayınlanmıştır ve kaynak kodu GitHub'daki meshy-mcp-server deposunda bulunur.

Bir Meshy API anahtarına ihtiyacınız var. Developer Platform'ın API Keys sayfasında bir tane oluşturun. MCP server'ı bunu MESHY_API_KEY ortam değişkeninden okur.

MCP server'ı yükleyin

Server'ı yüklemek için AI istemciniz için olan sekmeyi kullanın. msy_YOUR_API_KEY yerine kendi API anahtarınızı yazın.

# 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 yetenekle gruplandırılmış şu 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

İşlem sonrası

• meshy_remesh: mevcut bir modelin topology'sini veya poligon sayısını ya da her ikisini 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
• meshy_text_to_motion: bir metin promptundan animasyon oluşturur
• meshy_list_animations: ön tanımlı animasyon eylem kimliklerini ücretsiz olarak sorgular

Creative Lab

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

Görüntü oluşturma

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

Görev yönetimi

• meshy_get_task_status: görev durumunu ve indirme URL'lerini kontrol eder
• meshy_list_tasks: isteğe bağlı olarak türe veya duruma göre filtrelenmiş şekilde son görevleri listeler
• meshy_cancel_task: bir görevi siler. Meshy, PENDING durumundaki bir görevi kaldırır ve ücretini iade eder, tamamlanmış bir görevi ise siler. IN_PROGRESS durumundaki bir görev iptal edilemez ve API 409 döndürür.
• meshy_download_model: tamamlanmış bir model dosyasını indirir 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: bilgisayarınızda yüklü slicer'ları bulur ve modeli bunlardan birinde açan bir komut döndürür. Yerel olarak çalışır ve Meshy API'sini çağırmaz.
• meshy_analyze_printability: su geçirmezlik, hacim, delikler, manifold olmayan kenarlar ve bozuk yüzeyler dahil olmak üzere bir modelin FDM basılabilirliğini ücretsiz olarak kontrol eder
• meshy_process_multicolor: dokulu bir modeli baskı için çok renkli bir 3MF dosyasına dönüştürür
• meshy_repair_printability: bir modeli FDM baskısı için onarır
• meshy_auto_split: bir modeli ayrı ayrı basılabilir parçalara böler

Hesap

• meshy_check_balance: kalan kredilerinizi kontrol eder
• meshy_list_usage: Studio ve Enterprise takımları için, ekibinizin tamamlanmış API görevlerini ve her birinin kullandığı kredileri listeler

Örnek promptlar

Başlamak için, MCP destekli sohbetinizde şu promptları deneyin:

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 eklemek istiyorsanız, onu dokümanların düz metin sürümlerine yönlendirin:

• llms.txt: asenkron görevlerin nasıl yoklanacağı, kimlik doğrulama, hız limitleri, model seçimi ve sık yapılan hatalar gibi entegrasyon talimatlarını içeren kompakt bir dizin.
• llms-full.txt: tüm API sayfalarının tek bir dosyada toplanmış hali, böylece bir ajan dokümanları tek bir istekte okuyabilir.
• Sayfa başına Markdown: herhangi bir uç nokta URL'sine .md ekleyin, örneğin https://docs.meshy.ai/api/text-to-3d.md.

Meshy, dokümantasyon sitesi her derlendiğinde bu üçünü yeniden oluşturur, böylece HTML dokümanlarla eşleşirler.

SSS

MCP server'ı durumsuz (stateless) mıdır?

Kimlik bilgilerinizi saklamaz. Server, MESHY_API_KEY'inizi bellekte tutar ve asla diske yazmaz. Varsayılan olarak, indirdiği modelleri meta verileriyle birlikte çalışma dizinindeki bir meshy_output klasörüne kaydeder. Bir indirmeyi başka bir yere kaydetmek için indirme aracına bir save_to yolu verin.

MCP, REST API ile aynı maliyete mi sahiptir?

Evet. MCP araç çağrıları aynı REST çağrılarını yapar ve kredileri aynı oranda kullanır. Her fiyat için Fiyatlandırma sayfasına bakın.

Hız limitleri nelerdir?

MCP server'ının çağrıları, REST API çağrılarınızla aynı hız limitlerine dahildir. Her planın limitleri için Rate limits sayfasına bakın.

MCP server'ı hangi Meshy verilerine erişebilir?

Yalnızca MESHY_API_KEY'inizin REST API üzerinden, aynı izinlerle erişebildiği verilere.

Sorunları nasıl bildiririm?

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