AI entegrasyonu

Meshy, AI ajanları ve kodlama asistanları için iki kanal sunar: araç çağırma (tool-calling) için Meshy MCP server ve dokümantasyonu almak 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 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 (context) 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şturmak, bir görevi kontrol etmek, sonucu indirmek — bunları elle HTTP kodu yazmadan yapabilirsiniz.

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

Bir Meshy API anahtarına ihtiyacınız var. Developer Platform içindeki API Keys sayfasında 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 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ını (oluştur → sorgula → indir) sunar. Meshy REST API'sini 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'sini yetenekle gruplanmış araçlar olarak sunar.

3D Oluşturma

  • meshy_text_to_3d — bir metin promptundan 3D model 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 preview ağına doku ekler

İşlem Sonrası

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

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 — türe/duruma göre isteğe bağlı filtrelenmiş son görevleri listeler
  • meshy_cancel_task — bekleyen veya devam eden bir görevi iptal eder
  • meshy_download_model — tamamlanmış bir model dosyasını getirir ve yerel olarak kaydeder

Çalışma Alanı

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

3D Baskı

  • meshy_send_to_slicer — kurulu slicer'ları tespit eder ve modeli bunlardan birinde başlatır (yerel makinenizde çalışır; Meshy API çağrısı yapılmaz)
  • meshy_analyze_printability — şu anda manuel bir baskıya hazırlık 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 baskı için çok renkli bir 3MF dosyasına dönüştürür

Hesap

  • meshy_check_balance — kalan kredileri sorgular

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

Ö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ümantasyonunu doğrudan bir prompta almak istiyorsanız, ajanı düz metin arayüzlerimize yönlendirin:

  • llms.txt — kompakt indeks + entegrasyon talimatları (doğru asenkron sorgulama (polling) deseni, kimlik doğrulama kuralları, hız sınırları, model seçimi, yaygın hatalar).
  • llms-full.txt — tek seferlik alma (single-fetch) için tek bir dosyada birleştirilmiş tüm API sayfaları.
  • Sayfa başına Markdown: herhangi bir uç nokta URL'sinin sonuna .md ekleyin. Örnek: https://docs.meshy.ai/api/text-to-3d.md.

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

SSS

Is the MCP server stateless?
Yes. Your MESHY_API_KEY is used per request and never persisted on the server side.
Does MCP cost the same as the REST API?
Yes — every MCP tool call maps to a single REST call and consumes credits at the exact same rate. See the Pricing page for the full matrix.
What are the rate limits?
The MCP server shares the same rate-limit plane as the REST API. See the Rate Limits page for per-tier limits.
What Meshy data can the MCP access?
Only what the MESHY_API_KEY can access via REST. Scopes and permissions are identical.
How do I report issues?
File an issue at the meshy-mcp-server repository: https://github.com/meshy-dev/meshy-mcp-server/issues