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 CLI | MCP server | |
|---|---|---|
| Chi lo esegue | Tu in un terminale, script, CI e agenti in grado di eseguire comandi shell | App AI che si collegano agli strumenti tramite MCP |
| Accesso | Una sola volta, nel browser. Una chiave API è facoltativa, per la CI. | Una chiave API nella configurazione del client |
| Installazione | npm install -g meshy-cli | Un comando o una voce di configurazione per ciascun client (vedi sotto) |
| Ideale per | Script, job batch, CI, download e preparazione per la stampa 3D | Uso 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
Su Windows, avvia il server tramite cmd /c nelle configurazioni JSON sopra: imposta "command" su "cmd" e "args" su ["/c", "npx", "-y", "@meshy-ai/meshy-mcp-server"]. Non passare JSON come argomento di un comando in PowerShell, perché PowerShell rimuove le virgolette.
Preferisci una skill? Il pacchetto di skill open source meshy-3d-agent offre workflow Meshy già pronti, come generare un modello, tenere traccia del task e scaricare il risultato. Funziona in Claude Code, Cursor, Codex, OpenClaw e Hermes Agent. Le skill si basano sulla Meshy CLI invece che sull'MCP server. Effettui l'accesso una sola volta nel browser, quindi non ti serve una chiave API. Richiedono Node.js 22.12 o versioni successive. Per configurare la CLI, consulta Meshy CLI.
npx skills add meshy-dev/meshy-3d-agent
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 testualemeshy_image_to_3d: crea un modello 3D a partire da un'immaginemeshy_multi_image_to_3d: crea un modello 3D a partire da più immagini dello stesso oggettomeshy_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 entrambimeshy_retexture: applica una nuova texture a un modello esistentemeshy_rig: aggiunge uno scheletro a un personaggio umanoide 3Dmeshy_animate: applica un'animazione a un personaggio dotato di rigmeshy_convert: converte un modello in un altro formato di filemeshy_resize: ridimensiona un modello secondo dimensioni realimeshy_uv_unwrap: genera un nuovo layout UV per un modellomeshy_text_to_motion: genera un'animazione a partire da un prompt testualemeshy_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 testomeshy_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 downloadmeshy_list_tasks: elenca i task recenti, opzionalmente filtrati per tipo o statomeshy_cancel_task: elimina un task. Meshy rimuove e rimborsa un taskPENDING, ed elimina un task completato. Un taskIN_PROGRESSnon può essere annullato, e l'API restituisce409.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, usameshy_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 degeneratemeshy_process_multicolor: converte un modello con texture in un file 3MF multicolore per la stampameshy_repair_printability: ripara un modello per la stampa FDMmeshy_auto_split: suddivide un modello in parti stampabili separatamente
Account
meshy_check_balance: controlla i crediti rimanentimeshy_list_usage: elenca i task API completati del tuo team e i crediti utilizzati 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 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
.mdall'URL di un qualsiasi endpoint, ad esempiohttps://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