Integração de IA

A Meshy disponibiliza dois canais para agentes de IA e assistentes de programação: o MCP server da Meshy para chamadas de ferramentas, e llms.txt / llms-full.txt para ingestão de documentação.

Se você está integrando a Meshy a partir do Claude Code, Cursor, Windsurf, Codex ou qualquer outra ferramenta compatível com MCP, instale o MCP server abaixo. Se você está integrando a partir de um agente de chat simples sem suporte a 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 recuperem contexto estruturado. O MCP server da Meshy envolve a API REST da Meshy como um conjunto de ferramentas que seu agente pode invocar — gerar um modelo, verificar uma tarefa, baixar o resultado — sem escrever código HTTP manualmente.

O MCP server é de código aberto e publicado no npm como @meshy-ai/meshy-mcp-server. Código-fonte: github.com/meshy-dev/meshy-mcp-server.

Você precisa de uma chave de API da Meshy. Crie uma na página de Chaves de API na Plataforma de Desenvolvedores. O MCP server a lê a partir da variável de ambiente MESHY_API_KEY.

Instalação Rápida

# 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 uma skill pronta para usar? O pacote de skills de código aberto meshy-3d-agent traz fluxos de trabalho da Meshy pré-escritos (gerar → verificar → baixar) para Claude Code, Cursor e OpenClaw. Ele chama a API REST da Meshy diretamente — nenhum MCP server é necessário.

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

Ferramentas Disponíveis

O MCP server disponibiliza a API REST da Meshy como ferramentas, agrupadas por capacidade.

Geração 3D

  • meshy_text_to_3d — cria um modelo 3D 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 a topology e/ou a contagem de polígonos de um modelo existente
  • meshy_retexture — aplica uma nova textura a um modelo existente
  • meshy_rig — adiciona um esqueleto a um personagem humanoide 3D
  • meshy_animate — aplica uma animação a um personagem com rig

Geração de Imagens

  • meshy_text_to_image — imagem 2D a partir de texto
  • meshy_image_to_image — 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/status
  • meshy_cancel_task — cancela uma tarefa pendente ou em andamento
  • meshy_download_model — busca um arquivo de modelo concluído e salva localmente

Espaço de trabalho

  • meshy_list_models — lista todos os modelos no espaço de trabalho do usuário autenticado

Impressão 3D

  • meshy_send_to_slicer — detecta os slicers instalados e inicia o modelo em um deles (executa localmente na sua máquina; sem chamada à Meshy API)
  • meshy_analyze_printability — atualmente retorna uma checklist manual de prontidão para impressão (espessura de parede, saliências, malha manifold, etc.). Será atualizado para análise automatizada assim que a API de imprimibilidade da Meshy estiver disponível.
  • meshy_process_multicolor — converte um modelo com textura em um arquivo 3MF multicolorido para impressão

Conta

  • meshy_check_balance — consulta os créditos restantes

Os nomes e comportamentos das ferramentas podem evoluir. A lista oficial está disponível no código-fonte do MCP server.

Exemplos de Prompts

Use estes exemplos no seu chat habilitado para MCP como ponto de partida.

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 ingerir a documentação da Meshy diretamente em um prompt, aponte-o para nossas superfícies em texto simples:

  • llms.txt — índice compacto + instruções de integração (o padrão correto de polling assíncrono, regras de autenticação, limites de taxa, escolha de modelo, erros comuns).
  • llms-full.txt — todas as páginas da API concatenadas em um único arquivo para ingestão em uma única busca.
  • Markdown por página: acrescente .md a qualquer URL de endpoint. Exemplo: https://docs.meshy.ai/api/text-to-3d.md.

Os três arquivos são regenerados a cada build do site de documentação, então nunca ficam dessincronizados da documentação em HTML.

Perguntas Frequentes

O MCP server é stateless?
Sim. Sua MESHY_API_KEY é usada por requisição e nunca é persistida no lado do servidor.
O MCP custa o mesmo que a API REST?
Sim — cada chamada de ferramenta MCP corresponde a uma única chamada REST e consome créditos exatamente na mesma taxa. Consulte a página de Preços para a matriz completa.
Quais são os limites de taxa?
O MCP server compartilha o mesmo plano de limite de taxa que a API REST. Consulte a página de Limites de Taxa para os limites por nível.
Quais dados da Meshy o MCP pode acessar?
Apenas o que a MESHY_API_KEY pode acessar via REST. Os escopos e permissões são idênticos.
Como reporto problemas?
Abra uma issue no repositório meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues