lowpoly será descontinuado em 30 de out. de 2026. 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 codificação à Meshy, com o Meshy MCP server para chamadas de ferramentas, ou com llms.txt e llms-full.txt para ler a documentação.

Se você usa Claude Code, Cursor, Windsurf, Codex ou outro cliente MCP, instale o MCP server. Se o seu agente de chat não suportar MCP, aponte-o para https://docs.meshy.ai/llms.txt.

O que é o MCP

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA chamem ferramentas externas e obtenham contexto estruturado. O Meshy MCP server 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 é de código aberto. 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 da 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.

# 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

Prefere um skill? O pacote de skills de código aberto meshy-3d-agent tem fluxos de trabalho prontos da Meshy para Claude Code, Cursor e OpenClaw, como gerar um modelo, consultar a tarefa periodicamente e baixar o resultado. Ele chama a Meshy API REST diretamente, então você não precisa do MCP server.

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 pré-visualização 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 pré-visualização

Pós-processamento

  • meshy_remesh: altera a 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 do mundo real
  • 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ções de animação predefinidas, gratuitamente

Creative Lab

  • meshy_creative_lab: transforma uma foto em um produto Creative Lab finalizado (executa as tarefas de protótipo e de build)

Geração de imagem

  • 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. A 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

Espaço de trabalho

  • 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 fatiadores (slicers) instalados no seu computador e retorna um comando que abre o modelo em um deles. Ele é executado localmente e não chama a Meshy API.
  • meshy_analyze_printability: verifica a imprimibilidade FDM de um modelo gratuitamente, incluindo estanqueidade à água, volume, furos, 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

Os nomes e o comportamento das ferramentas podem mudar. Para a lista completa, consulte as ferramentas no código-fonte do MCP server.

Exemplos de prompts

Para começar, experimente estes prompts no seu chat com suporte a MCP:

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 da 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 consultar tarefas assíncronas periodicamente, 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 à URL de qualquer endpoint, por exemplo https://docs.meshy.ai/api/text-to-3d.md.

A Meshy regenera os três arquivos sempre que o site de documentação é compilado, 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. Consulte a página de Preços para ver todos os valores.
Quais são os limites de taxa?
As chamadas do MCP server contam para os mesmos limites de taxa das suas chamadas à API REST. Consulte a página de limites de taxa para os limites de cada plano.
A quais dados da Meshy o MCP server pode acessar?
Apenas o que sua MESHY_API_KEY pode acessar pela 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