lowpoly verrà ritirato il 30 ott 2026. meshy-7 come modello di generazione 3D verrà ritirato il 31 dic 2026; come modello di texture resta disponibile. Cambia modello prima di queste date per evitare errori nelle richieste. Vedi tutte le deprecazioni

Integrazione AI

Collega agenti AI e assistenti di codifica a Meshy, con Meshy CLI o con l'MCP server di Meshy per generare modelli, oppure con llms.txt e llms-full.txt per leggere la documentazione.

Se il tuo agente può eseguire comandi shell, come Claude Code, Cursor e Codex, usa la CLI o l'MCP server. Se si collega agli strumenti solo tramite MCP, installa l'MCP server. Se il tuo agente di chat non supporta nessuno dei due, puntalo a https://docs.meshy.ai/llms.txt.


CLI o MCP

Entrambi chiamano la stessa API REST di Meshy, agli stessi prezzi. Differiscono per chi li esegue e per come effettua l'accesso.

Meshy CLIMCP server
Chi lo esegueTu in un terminale, script, CI e agenti in grado di eseguire comandi shellApp AI che si collegano agli strumenti tramite MCP
AccessoUna sola volta, nel browser. Una chiave API è facoltativa, per la CI.Una chiave API nella configurazione del client
Installazionenpm install -g meshy-cliUn comando o una voce di configurazione per ciascun client (vedi sotto)
Ideale perScript, job batch, CI, download e preparazione per la stampa 3DUso in stile chat in un'app di chat che non può eseguire comandi shell, come Claude Desktop

Per iniziare con la CLI, consulta Meshy CLI. Il resto di questa pagina tratta l'MCP server.


Cos'è MCP

Il Model Context Protocol (MCP) è uno standard aperto che consente agli assistenti AI di chiamare strumenti esterni e ottenere contesto strutturato. L'MCP server di Meshy racchiude l'API REST di Meshy sotto forma di 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.

Ti serve 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 relativa al tuo client AI. Sostituisci msy_YOUR_API_KEY con la tua chiave API. Ogni configurazione salva la chiave nella configurazione a livello utente, al di fuori di qualsiasi progetto, in modo che non finisca in un repository.

# macOS / Linux / WSL
claude mcp add -s user meshy --env MESHY_API_KEY=msy_YOUR_API_KEY -- npx -y @meshy-ai/meshy-mcp-server

# Windows (PowerShell or Command Prompt)
claude mcp add -s user meshy --env MESHY_API_KEY=msy_YOUR_API_KEY "--" cmd /c npx -y @meshy-ai/meshy-mcp-server

Strumenti disponibili

L'MCP server offre l'API REST di Meshy sotto forma dei seguenti strumenti, raggruppati per funzionalità.

Generazione 3D

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

Post-elaborazione

  • meshy_remesh: modifica 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 dotato di rig
  • meshy_convert: converte un modello in un altro formato di file
  • meshy_resize: ridimensiona un modello secondo dimensioni reali
  • meshy_uv_unwrap: genera un nuovo layout UV per un modello
  • meshy_text_to_motion: genera un'animazione a partire 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 prototype e build)

Generazione immagini

  • meshy_text_to_image: crea un'immagine 2D a partire da testo
  • meshy_image_to_image: crea un'immagine 2D a partire 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: individua gli slicer installati sul tuo computer e restituisce un comando per aprire il modello in uno di essi. Viene eseguito localmente e non chiama l'API Meshy.
  • 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 utilizzati da ciascuno, per i team Studio ed Enterprise

Esempi di prompt

Per iniziare, prova questi prompt nella tua chat con MCP abilitato:

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 la documentazione di Meshy direttamente in un prompt, puntalo alle versioni in testo semplice della documentazione:

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

Meshy rigenera tutti e tre i file a ogni build del sito di documentazione, in modo che corrispondano alla documentazione HTML.


FAQ

L'MCP server è stateless?
Non memorizza le tue credenziali. Il server mantiene 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 l'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 ogni prezzo.
Quali sono i limiti di frequenza?
Le chiamate dell'MCP server rientrano negli stessi limiti di frequenza delle tue chiamate API REST. Consulta la pagina sui limiti di frequenza per i limiti di ciascun piano.
A quali dati Meshy può accedere l'MCP server?
Solo a ciò a cui la tua MESHY_API_KEY può accedere tramite l'API REST, con le stesse autorizzazioni.
Come posso segnalare problemi?
Apri una issue nel repository meshy-mcp-server su GitHub: https://github.com/meshy-dev/meshy-mcp-server/issues