Integrazione AI

Meshy espone due canali per agenti AI e assistenti di codifica: il server Meshy MCP per chiamate di strumenti, e llms.txt / llms-full.txt per l'ingestione di documenti.

Se stai integrando Meshy da Claude Code, Cursor, Windsurf, Codex, o qualsiasi altro strumento compatibile con MCP, installa il server MCP qui sotto. Se stai integrando da un semplice agente di chat senza supporto MCP, puntalo su https://docs.meshy.ai/llms.txt invece.

Cos'è MCP

Il Model Context Protocol (MCP) è uno standard aperto che permette agli assistenti AI di chiamare strumenti esterni e recuperare contesti strutturati. Il server Meshy MCP avvolge l'API REST di Meshy come un set di strumenti che il tuo agente può invocare — generare un modello, controllare un compito, scaricare il risultato — senza scrivere codice HTTP manualmente.

Il server MCP è open source e pubblicato su npm come @meshy-ai/meshy-mcp-server. Fonte: github.com/meshy-dev/meshy-mcp-server.

Hai bisogno di una chiave API Meshy. Creane una su https://www.meshy.ai/settings/api. Il server MCP la legge dalla variabile d'ambiente MESHY_API_KEY.

Installazione Rapida

# 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 pronta all'uso? Il pacchetto open-source meshy-3d-agent include flussi di lavoro Meshy pre-scritti (genera → controlla → scarica) per Claude Code, Cursor e OpenClaw. Chiama direttamente l'API REST di Meshy — non è richiesto il server MCP.

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

Strumenti Disponibili

Il server MCP espone l'API REST di Meshy come strumenti, raggruppati per capacità.

Generazione 3D

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

Post-Elaborazione

  • meshy_remesh — cambia topology e/o conteggio poligoni di un modello esistente
  • meshy_retexture — applica una nuova texture a un modello esistente
  • meshy_rig — aggiungi uno scheletro a un personaggio umanoide 3D
  • meshy_animate — applica un'animazione a un personaggio riggato

Generazione di Immagini

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

Gestione dei Compiti

  • meshy_get_task_status — controlla lo stato del compito e gli URL di download
  • meshy_list_tasks — elenca i compiti recenti, eventualmente filtrati per tipo/stato
  • meshy_cancel_task — annulla un compito in attesa o in corso
  • meshy_download_model — recupera un file modello completato e salvalo localmente

Spazio di Lavoro

  • meshy_list_models — elenca tutti i modelli nello spazio di lavoro dell'utente autenticato

Stampa 3D

  • meshy_send_to_slicer — rileva i slicer installati e avvia il modello in uno (esegue localmente sulla tua macchina; nessuna chiamata API Meshy)
  • meshy_analyze_printability — attualmente restituisce un elenco di controllo manuale per la prontezza alla stampa (spessore parete, sporgenze, mesh manifold, ecc.). Sarà aggiornato a un'analisi automatizzata una volta che l'API di stampabilità Meshy sarà disponibile.
  • meshy_process_multicolor — converte un modello texturizzato in un file 3MF multicolore per la stampa

Account

  • meshy_check_balance — interroga i crediti rimanenti

I nomi e i comportamenti degli strumenti possono evolvere. L'elenco autorevole si trova nel codice sorgente del server MCP.

Esempi di Prompt

Inserisci questi nel tuo chat abilitato MCP come punto di partenza.

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 ingerire i documenti Meshy direttamente in un prompt, puntalo sulle nostre superfici di testo semplice:

  • llms.txt — indice compatto + istruzioni di integrazione (il corretto pattern di polling asincrono, regole di autenticazione, limiti di velocità, scelta del modello, errori comuni).
  • llms-full.txt — ogni pagina API concatenata in un unico file per l'ingestione in un'unica operazione.
  • Markdown per pagina: aggiungi .md a qualsiasi URL di endpoint. Esempio: https://docs.meshy.ai/api/text-to-3d.md.

Tutti e tre vengono rigenerati ogni volta che il sito di documentazione viene costruito, quindi non si discostano mai dai documenti HTML.

FAQ

Il server MCP è senza stato?
Sì. La tua MESHY_API_KEY viene utilizzata per richiesta e non viene mai memorizzata sul lato server.
MCP costa lo stesso dell'API REST?
Sì — ogni chiamata di strumento MCP mappa a una singola chiamata REST e consuma crediti allo stesso tasso. Vedi la pagina Prezzi per la matrice completa.
Quali sono i limiti di velocità?
Il server MCP condivide lo stesso piano di limiti di velocità dell'API REST. Vedi la pagina Limiti di Velocità per i limiti per livello.
Quali dati Meshy può accedere MCP?
Solo ciò a cui la MESHY_API_KEY può accedere tramite REST. Gli ambiti e i permessi sono identici.
Come posso segnalare problemi?
Segnala un problema nel repository meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues