lowpoly verrà ritirato il 30 ott 2026. Cambia modello prima di queste date per evitare errori nelle richieste. Vedi tutte le deprecazioni

Integrazione AI

Collega agenti AI e assistenti di coding a Meshy, con l'MCP server di Meshy per le chiamate agli strumenti, oppure con llms.txt e llms-full.txt per leggere la documentazione.

Se usi Claude Code, Cursor, Windsurf, Codex o un altro client MCP, installa l'MCP server. Se il tuo agente di chat non supporta MCP, puntalo invece su https://docs.meshy.ai/llms.txt.

Cos'è MCP

Il Model Context Protocol (MCP) è uno standard aperto che permette agli assistenti AI di chiamare strumenti esterni e ottenere contesto strutturato. L'MCP server di Meshy racchiude la Meshy API REST in strumenti che il tuo agente può chiamare. Con questi, l'agente può generare un modello, controllare un task e scaricare il risultato senza scrivere codice HTTP a mano.

L'MCP server è open source. È pubblicato su npm come @meshy-ai/meshy-mcp-server, e il suo codice sorgente si trova nel repository meshy-mcp-server su GitHub.

Hai bisogno di una chiave API di Meshy. Creane una nella pagina API Keys della Developer Platform. L'MCP server la legge dalla variabile d'ambiente MESHY_API_KEY.

Installare l'MCP server

Per installare il server, usa la scheda del tuo client AI. Sostituisci msy_YOUR_API_KEY con la tua chiave API.

# 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

Preferisci una skill? Il pacchetto di skill open source meshy-3d-agent offre workflow Meshy già pronti per Claude Code, Cursor e OpenClaw, come generare un modello, fare polling del task e scaricare il risultato. Chiama direttamente la Meshy API REST, quindi non hai bisogno dell'MCP server.

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

Strumenti disponibili

L'MCP server offre la Meshy API REST come i seguenti strumenti, raggruppati per funzionalità.

Generazione 3D

  • meshy_text_to_3d: crea una mesh di anteprima senza texture da un prompt testuale
  • meshy_image_to_3d: crea un modello 3D da una singola immagine
  • meshy_multi_image_to_3d: crea un modello 3D da più immagini dello stesso oggetto
  • meshy_text_to_3d_refine: aggiunge texture a una mesh di anteprima

Post-elaborazione

  • meshy_remesh: cambia la topology o il conteggio poligoni di un modello esistente, o entrambi
  • meshy_retexture: applica una nuova texture a un modello esistente
  • meshy_rig: aggiunge uno scheletro a un personaggio umanoide 3D
  • meshy_animate: applica un'animazione a un personaggio con rig
  • meshy_convert: converte un modello in un altro formato di file
  • meshy_resize: ridimensiona un modello alle dimensioni reali
  • meshy_uv_unwrap: genera un nuovo layout UV per un modello
  • meshy_text_to_motion: genera un'animazione da un prompt testuale
  • meshy_list_animations: consulta gratuitamente gli ID delle azioni di animazione preimpostate

Creative Lab

  • meshy_creative_lab: trasforma una foto in un prodotto Creative Lab finito (esegue i task di prototipo e build)

Generazione di immagini

  • meshy_text_to_image: crea un'immagine 2D da un testo
  • meshy_image_to_image: crea un'immagine 2D da un'immagine di riferimento

Gestione dei task

  • meshy_get_task_status: controlla lo stato del task e gli URL di download
  • meshy_list_tasks: elenca i task recenti, opzionalmente filtrati per tipo o stato
  • meshy_cancel_task: elimina un task. Meshy rimuove e rimborsa un task PENDING, ed elimina un task completato. Un task IN_PROGRESS non può essere annullato, e l'API restituisce 409.
  • meshy_download_model: scarica un file di modello completato e lo salva localmente

Spazio di lavoro

  • meshy_list_models: elenca i tuoi modelli Testo in 3D recenti. Per altri tipi di task, usa meshy_list_tasks.

Stampa 3D

  • meshy_send_to_slicer: trova gli slicer installati sul tuo computer e restituisce un comando che apre il modello in uno di essi. Viene eseguito localmente e non chiama la Meshy API.
  • meshy_analyze_printability: controlla gratuitamente la stampabilità FDM di un modello, inclusi tenuta stagna, volume, fori, spigoli non manifold e facce degenerate
  • meshy_process_multicolor: converte un modello con texture in un file 3MF multicolore per la stampa
  • meshy_repair_printability: ripara un modello per la stampa FDM
  • meshy_auto_split: suddivide un modello in parti stampabili separatamente

Account

  • meshy_check_balance: controlla i crediti rimanenti
  • meshy_list_usage: elenca i task API completati del tuo team e i crediti usati da ciascuno, per i team Studio ed Enterprise

I nomi e il comportamento degli strumenti possono cambiare. Per l'elenco completo, consulta gli strumenti nel codice sorgente dell'MCP server.

Esempi di prompt

Per iniziare, prova questi prompt nella tua chat abilitata a MCP:

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

Se il tuo agente non supporta MCP, o vuoi inserire direttamente la documentazione di Meshy in un prompt, puntalo alle versioni in testo semplice della documentazione:

  • llms.txt: un indice compatto con istruzioni di integrazione, come il polling dei task asincroni, l'autenticazione, i limiti di frequenza, la scelta del modello e gli errori comuni.
  • llms-full.txt: ogni pagina API in un unico file, così un agente può leggere la documentazione con una sola richiesta.
  • Markdown per singola pagina: aggiungi .md a qualsiasi URL di endpoint, ad esempio https://docs.meshy.ai/api/text-to-3d.md.

Meshy rigenera tutti e tre i file ogni volta che il sito della documentazione viene ricompilato, in modo che corrispondano alla documentazione HTML.

FAQ

L'MCP server è stateless?
Non memorizza le tue credenziali. Il server conserva la tua MESHY_API_KEY in memoria e non la scrive mai su disco. Per impostazione predefinita, salva i modelli scaricati, con i relativi metadati, in una cartella meshy_output nella sua directory di lavoro. Per salvare un download altrove, fornisci allo strumento di download un percorso save_to.
MCP costa come la API REST?
Sì. Le chiamate agli strumenti MCP effettuano le stesse chiamate REST e usano i crediti allo stesso tasso. Consulta la pagina Prezzi per tutti i prezzi.
Quali sono i limiti di frequenza?
Le chiamate dell'MCP server contano verso gli stessi limiti di frequenza delle tue chiamate API REST. Consulta la pagina Rate limits per i limiti di ciascun piano.
A quali dati di Meshy può accedere l'MCP server?
Solo a quelli a cui la tua MESHY_API_KEY può accedere tramite la API REST, con gli stessi permessi.
Come posso segnalare un problema?
Apri una issue nel repository meshy-mcp-server su GitHub: https://github.com/meshy-dev/meshy-mcp-server/issues