Integrazione AI

Meshy espone due canali per agenti AI e assistenti di programmazione: 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 invece stai integrando da un semplice agente di chat senza supporto MCP, puntalo su 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 incapsula la Meshy API REST come un insieme di strumenti che il tuo agente può invocare — generare un modello, controllare un task, scaricare il risultato — senza scrivere manualmente codice HTTP.

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

È necessaria una chiave API Meshy. Creane una nella pagina API Keys nella Developer Platform. 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 una skill pronta all'uso? Il pacchetto di skill open source meshy-3d-agent fornisce flussi di lavoro Meshy già pronti (genera → controlla → scarica) per Claude Code, Cursor e OpenClaw. Chiama direttamente la Meshy API REST — nessun MCP server richiesto.

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 a partire da un prompt testuale
  • meshy_image_to_3d — crea un modello 3D a partire da una singola immagine
  • meshy_multi_image_to_3d — crea un modello 3D a partire da più immagini dello stesso oggetto
  • meshy_text_to_3d_refine — aggiunge la 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 — aggiunge uno scheletro a un personaggio 3D umanoide
  • meshy_animate — applica un'animazione a un personaggio con rig

Generazione di immagini

  • meshy_text_to_image — immagine 2D a partire da testo
  • meshy_image_to_image — 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, filtrabili opzionalmente per tipo/stato
  • meshy_cancel_task — annulla un task in attesa o in corso
  • meshy_download_model — scarica un file di modello completato e lo salva 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 (viene eseguito localmente sulla tua macchina; nessuna chiamata alla Meshy API)
  • meshy_analyze_printability — attualmente restituisce una checklist manuale di preparazione alla stampa (spessore parete, sbalzi, mesh manifold, ecc.). Verrà aggiornato con l'analisi automatizzata non appena sarà disponibile la Meshy API per la stampabilità.
  • meshy_process_multicolor — converte un modello con texture in un file 3MF multicolore per la stampa

Account

  • meshy_check_balance — interroga i crediti rimanenti

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

Esempi di prompt

Inseriscili nella tua chat abilitata a 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 importare la documentazione Meshy direttamente in un prompt, puntalo sulle 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 — tutte le pagine API concatenate in un unico file per l'ingestione con una sola richiesta.
  • Markdown per singola pagina: aggiungi .md a qualsiasi URL di endpoint. Esempio: https://docs.meshy.ai/api/text-to-3d.md.

Tutti e tre vengono rigenerati a ogni build del sito della documentazione, quindi non si discostano mai dalla documentazione HTML.

FAQ

L'MCP server è stateless?
Sì. La tua MESHY_API_KEY viene utilizzata per ogni richiesta e non viene mai memorizzata lato server.
MCP costa come la API REST?
Sì — ogni chiamata a uno strumento MCP corrisponde a un'unica chiamata REST e consuma crediti esattamente allo stesso tasso. Consulta la pagina Prezzi per la matrice completa.
Quali sono i limiti di frequenza?
L'MCP server condivide lo stesso livello di limite di frequenza della API REST. Consulta la pagina Rate Limits per i limiti per livello.
A quali dati Meshy può accedere l'MCP?
Solo a ciò a cui la MESHY_API_KEY può accedere tramite REST. Ambiti e permessi sono identici.
Come segnalo dei problemi?
Apri una issue nel repository meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues