Integrazione AI

Meshy espone due canali per agenti AI e assistenti di coding: il Meshy MCP server per il tool-calling, e llms.txt / llms-full.txt per l'ingestione della documentazione.

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

Cos'è MCP

Il Model Context Protocol (MCP) è uno standard aperto che consente agli assistenti AI di chiamare strumenti esterni e recuperare contesto strutturato. Il Meshy MCP server racchiude la Meshy API REST come un set di strumenti che il tuo agente può invocare — generare un modello, controllare un'attività, scaricare il risultato — senza scrivere manualmente codice HTTP.

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

Ti serve una chiave API Meshy. Creane una su https://www.meshy.ai/settings/api. L'MCP server 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 invece una skill pronta all'uso? Il pacchetto di skill open source meshy-3d-agent include workflow Meshy pre-scritti (genera → esegui polling → scarica) per Claude Code, Cursor e OpenClaw. Chiama direttamente la Meshy API REST — non è richiesto alcun MCP server.

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

Strumenti disponibili

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

Generazione 3D

  • meshy_text_to_3d — crea un modello 3D da un prompt di testo
  • 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 — modifica la topology e/o il 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 delle attività

  • meshy_get_task_status — controlla lo stato dell'attività e gli URL di download
  • meshy_list_tasks — elenca le attività recenti, facoltativamente filtrate per tipo/stato
  • meshy_cancel_task — annulla un'attività in sospeso o in progress
  • 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 gli slicer installati e avvia il modello in uno di essi (eseguito localmente sulla tua macchina; nessuna chiamata alla Meshy API)
  • meshy_analyze_printability — attualmente restituisce una checklist manuale di idoneità alla stampa (spessore parete, sporgenze, mesh manifold, ecc.). Verrà aggiornato ad analisi automatizzata non appena la API di stampabilità Meshy sarà disponibile.
  • meshy_process_multicolor — converti 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 sorgente dell'MCP server.

Prompt di esempio

Inseriscili nella tua chat abilitata per 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 direttamente la documentazione Meshy in un prompt, indirizzalo alle nostre superfici in testo semplice:

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

Tutti e tre vengono rigenerati ogni volta che il sito della documentazione viene compilato, quindi non divergono mai dalla documentazione HTML.

FAQ

L'MCP server è stateless?

Sì. La tua MESHY_API_KEY viene usata per ogni richiesta e non viene mai persistita lato server.

MCP costa come la REST API?

Sì — ogni chiamata a uno strumento MCP corrisponde a una singola chiamata REST e consuma crediti esattamente alla stessa frequenza. Consulta Prezzi per la matrice completa.

Quali sono i limiti di frequenza?

L'MCP server condivide lo stesso piano di limiti di frequenza della REST API. Consulta Limiti di frequenza per i limiti per livello.

A quali dati Meshy può accedere MCP?

Solo a ciò a cui MESHY_API_KEY può accedere tramite REST. Scope e autorizzazioni sono identici.

Come segnalo i problemi?

Apri una issue su github.com/meshy-dev/meshy-mcp-server.