lowpoly será descontinuado em 30 de out. de 2026. meshy-7 como modelo de geração 3D será descontinuado em 31 de dez. de 2026; como modelo de textura continua disponível. Troque de modelo antes dessas datas para evitar erros nas solicitações. Ver todas as descontinuações

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 CLIMCP server
Quem executaVocê em um terminal, scripts, CI e agentes que conseguem executar comandos de shellAplicativos de IA que se conectam a ferramentas via MCP
LoginUma vez, no seu navegador. Uma chave de API é opcional, para CI.Uma chave de API na configuração do cliente
Instalaçãonpm install -g meshy-cliUm comando ou entrada de configuração por cliente (veja abaixo)
Ideal paraScripts, tarefas em lote, CI, downloads e preparação para impressão 3DUso 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

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 texto
  • meshy_image_to_3d: cria um modelo 3D a partir de uma imagem
  • meshy_multi_image_to_3d: cria um modelo 3D a partir de múltiplas imagens do mesmo objeto
  • meshy_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 ambos
  • meshy_retexture: aplica uma nova textura a um modelo existente
  • meshy_rig: adiciona um esqueleto a um personagem 3D humanoide
  • meshy_animate: aplica uma animação a um personagem com rig
  • meshy_convert: converte um modelo para outro formato de arquivo
  • meshy_resize: redimensiona um modelo para dimensões reais
  • meshy_uv_unwrap: gera um novo layout UV para um modelo
  • meshy_text_to_motion: gera uma animação a partir de um prompt de texto
  • meshy_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 texto
  • meshy_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 download
  • meshy_list_tasks: lista tarefas recentes, opcionalmente filtradas por tipo ou status
  • meshy_cancel_task: exclui uma tarefa. O Meshy remove e reembolsa uma tarefa PENDING, e exclui uma tarefa finalizada. Uma tarefa IN_PROGRESS não pode ser cancelada, e a API retorna 409.
  • 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, use meshy_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 degeneradas
  • meshy_process_multicolor: converte um modelo texturizado em um arquivo 3MF multicolorido para impressão
  • meshy_repair_printability: repara um modelo para impressão FDM
  • meshy_auto_split: divide um modelo em partes imprimíveis separadamente

Conta

  • meshy_check_balance: verifica seus créditos restantes
  • meshy_list_usage: lista as tarefas de API finalizadas da sua equipe e os créditos que cada uma usou, para equipes Studio e Enterprise

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 .md a qualquer URL de endpoint, por exemplo https://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