Integração de IA
Conecte agentes de IA e assistentes de código ao Meshy, com o Meshy CLI ou o MCP server do Meshy para gerar modelos, ou com llms.txt e llms-full.txt para ler a documentação.
Se o seu agente consegue executar comandos de shell, como Claude Code, Cursor e Codex conseguem, use o CLI ou o MCP server. Se ele só se conecta a ferramentas via MCP, instale o MCP server. Se o seu agente de chat não suporta nenhum dos dois, aponte-o para https://docs.meshy.ai/llms.txt.
CLI ou MCP
Ambos chamam a mesma Meshy API REST, com os mesmos preços. Eles diferem em quem os executa e como se autenticam.
| Meshy CLI | MCP server | |
|---|---|---|
| Quem executa | Você em um terminal, scripts, CI e agentes que conseguem executar comandos de shell | Aplicativos de IA que se conectam a ferramentas via MCP |
| Login | Uma vez, no seu navegador. Uma chave de API é opcional, para CI. | Uma chave de API na configuração do cliente |
| Instalação | npm install -g meshy-cli | Um comando ou entrada de configuração por cliente (veja abaixo) |
| Ideal para | Scripts, tarefas em lote, CI, downloads e preparação para impressão 3D | Uso em estilo chat em um app de chat que não consegue executar comandos de shell, como o Claude Desktop |
Para começar com o CLI, veja Meshy CLI. O restante desta página aborda o MCP server.
O que é MCP
O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA chamem ferramentas externas e obtenham contexto estruturado. O MCP server do Meshy encapsula a Meshy API REST como ferramentas que seu agente pode chamar. Com elas, o agente pode gerar um modelo, verificar uma tarefa e baixar o resultado sem código HTTP escrito manualmente.
O MCP server é open source. Ele é publicado no npm como @meshy-ai/meshy-mcp-server, e seu código-fonte está no repositório meshy-mcp-server no GitHub.
Você precisa de uma chave de API do Meshy. Crie uma na página de API Keys da Developer Platform. O MCP server a lê a partir da variável de ambiente MESHY_API_KEY.
Instalar o MCP server
Para instalar o servidor, use a aba do seu cliente de IA. Substitua msy_YOUR_API_KEY pela sua chave de API. Cada configuração salva a chave na configuração em nível de usuário, fora de qualquer projeto, para que ela não acabe em um repositório.
# 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
No Windows, inicie o servidor através de cmd /c nas configurações JSON acima: defina "command" como "cmd" e "args" como ["/c", "npx", "-y", "@meshy-ai/meshy-mcp-server"]. Não passe JSON como argumento de comando no PowerShell, porque o PowerShell remove suas aspas.
Prefere uma skill? O pacote de skills open-source meshy-3d-agent tem fluxos de trabalho prontos do Meshy, como gerar um modelo, acompanhar a tarefa e baixar o resultado. Funciona no Claude Code, Cursor, Codex, OpenClaw e Hermes Agent. As skills são executadas no Meshy CLI em vez do MCP server. Você faz login uma vez no seu navegador, então não precisa de uma chave de API. Elas exigem Node.js 22.12 ou posterior. Para configurar o CLI, veja Meshy CLI.
npx skills add meshy-dev/meshy-3d-agent
Ferramentas disponíveis
O MCP server oferece a Meshy API REST como as seguintes ferramentas, agrupadas por capacidade.
Geração 3D
meshy_text_to_3d: cria uma malha de preview sem textura a partir de um prompt de textomeshy_image_to_3d: cria um modelo 3D a partir de uma imagemmeshy_multi_image_to_3d: cria um modelo 3D a partir de múltiplas imagens do mesmo objetomeshy_text_to_3d_refine: adiciona textura a uma malha de preview
Pós-processamento
meshy_remesh: altera o topology ou a contagem de polígonos de um modelo existente, ou ambosmeshy_retexture: aplica uma nova textura a um modelo existentemeshy_rig: adiciona um esqueleto a um personagem 3D humanoidemeshy_animate: aplica uma animação a um personagem com rigmeshy_convert: converte um modelo para outro formato de arquivomeshy_resize: redimensiona um modelo para dimensões reaismeshy_uv_unwrap: gera um novo layout UV para um modelomeshy_text_to_motion: gera uma animação a partir de um prompt de textomeshy_list_animations: consulta os IDs de ação de animação pré-definidas, gratuitamente
Creative Lab
meshy_creative_lab: transforma uma foto em um produto finalizado do Creative Lab (executa as tarefas de prototype e build)
Geração de imagens
meshy_text_to_image: cria uma imagem 2D a partir de textomeshy_image_to_image: cria uma imagem 2D a partir de uma imagem de referência
Gerenciamento de tarefas
meshy_get_task_status: verifica o status da tarefa e as URLs de downloadmeshy_list_tasks: lista tarefas recentes, opcionalmente filtradas por tipo ou statusmeshy_cancel_task: exclui uma tarefa. O Meshy remove e reembolsa uma tarefaPENDING, e exclui uma tarefa finalizada. Uma tarefaIN_PROGRESSnão pode ser cancelada, e a API retorna409.meshy_download_model: baixa um arquivo de modelo finalizado e o salva localmente
Workspace
meshy_list_models: lista seus modelos recentes de Texto para 3D. Para outros tipos de tarefa, usemeshy_list_tasks.
Impressão 3D
meshy_send_to_slicer: encontra os slicers instalados no seu computador e retorna um comando que abre o modelo em um deles. Executa localmente e não chama a Meshy API.meshy_analyze_printability: verifica a imprimibilidade FDM de um modelo gratuitamente, incluindo estanqueidade, volume, buracos, arestas non-manifold e faces degeneradasmeshy_process_multicolor: converte um modelo texturizado em um arquivo 3MF multicolorido para impressãomeshy_repair_printability: repara um modelo para impressão FDMmeshy_auto_split: divide um modelo em partes imprimíveis separadamente
Conta
meshy_check_balance: verifica seus créditos restantesmeshy_list_usage: lista as tarefas de API finalizadas da sua equipe e os créditos que cada uma usou, para equipes Studio e Enterprise
Os nomes e comportamentos das ferramentas podem mudar. Para a lista completa, veja as ferramentas no código-fonte do MCP server.
Exemplos de prompts
Para começar, experimente estes prompts no seu chat com MCP habilitado:
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 o seu agente não suportar MCP, ou se você quiser colocar a documentação do Meshy diretamente em um prompt, aponte-o para as versões em texto simples da documentação:
llms.txt: um índice compacto com instruções de integração, como fazer polling de tarefas assíncronas, autenticação, limites de taxa, escolha de modelo e erros comuns.llms-full.txt: todas as páginas da API em um único arquivo, para que um agente possa ler a documentação em uma única requisição.- Markdown por página: adicione
.mda qualquer URL de endpoint, por exemplohttps://docs.meshy.ai/api/text-to-3d.md.
O Meshy regenera os três a cada build do site de documentação, para que correspondam à documentação em HTML.
FAQ
- O MCP server é stateless?
- Ele não armazena suas credenciais. O servidor mantém sua MESHY_API_KEY em memória e nunca a grava em disco. Por padrão, ele salva os modelos que baixa, com seus metadados, em uma pasta meshy_output no seu diretório de trabalho. Para salvar um download em outro lugar, informe à ferramenta de download um caminho save_to.
- O MCP custa o mesmo que a API REST?
- Sim. As chamadas de ferramentas MCP fazem as mesmas chamadas REST e usam créditos na mesma taxa. Veja a página de Preços para todos os valores.
- Quais são os limites de taxa?
- As chamadas do MCP server contam para os mesmos limites de taxa que suas chamadas de API REST. Veja a página de Limites de taxa para os limites de cada plano.
- Quais dados do Meshy o MCP server pode acessar?
- Apenas o que sua MESHY_API_KEY pode acessar através da API REST, com as mesmas permissões.
- Como eu reporto problemas?
- Abra uma issue no repositório meshy-mcp-server no GitHub: https://github.com/meshy-dev/meshy-mcp-server/issues