AI-integration

Meshy erbjuder två kanaler för AI-agenter och kodningsassistenter: Meshy MCP server för tool-calling, samt llms.txt / llms-full.txt för dokumentationsinhämtning.

Om du integrerar Meshy från Claude Code, Cursor, Windsurf, Codex eller något annat MCP-kompatibelt verktyg installerar du MCP servern nedan. Om du integrerar från en vanlig chattagent utan MCP-stöd pekar du istället mot https://docs.meshy.ai/llms.txt.

Vad är MCP

Model Context Protocol (MCP) är en öppen standard som gör det möjligt för AI-assistenter att anropa externa verktyg och hämta strukturerad kontext. Meshy MCP server kapslar in Meshy REST API som en uppsättning verktyg som din agent kan anropa — generera en modell, kontrollera en task, ladda ner resultatet — utan att behöva skriva HTTP-kod för hand.

MCP servern är öppen källkod och publicerad på npm som @meshy-ai/meshy-mcp-server. Källkod: github.com/meshy-dev/meshy-mcp-server.

Du behöver en Meshy API-nyckel. Skapa en på sidan API Keys i Developer Platform. MCP servern läser den från miljövariabeln MESHY_API_KEY.

Snabbinstallation

# 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

Föredrar du en färdig skill istället? Det öppna källkodspaketet meshy-3d-agent levererar färdigskrivna Meshy-arbetsflöden (generera → poll → ladda ner) för Claude Code, Cursor och OpenClaw. Det anropar Meshy REST API direkt — ingen MCP server krävs.

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

Tillgängliga verktyg

MCP servern exponerar Meshy REST API som verktyg, grupperade efter funktion.

3D-generering

  • meshy_text_to_3d — skapa en 3D-modell från en text-prompt
  • meshy_image_to_3d — skapa en 3D-modell från en bild
  • meshy_multi_image_to_3d — skapa en 3D-modell från flera bilder av samma objekt
  • meshy_text_to_3d_refine — lägg till textur på ett preview-nät

Efterbehandling

  • meshy_remesh — ändra topology och/eller polygonantal för en befintlig modell
  • meshy_retexture — applicera en ny textur på en befintlig modell
  • meshy_rig — lägg till ett skelett på en 3D-humanoidkaraktär
  • meshy_animate — applicera en animation på en riggad karaktär

Bildgenerering

  • meshy_text_to_image — 2D-bild från text
  • meshy_image_to_image — 2D-bild från en referensbild

Task-hantering

  • meshy_get_task_status — kontrollera taskstatus och nedladdnings-URL:er
  • meshy_list_tasks — lista senaste tasks, valfritt filtrerade efter typ/status
  • meshy_cancel_task — avbryt en väntande eller pågående task
  • meshy_download_model — hämta en slutförd modellfil och spara lokalt

Arbetsyta

  • meshy_list_models — lista alla modeller i den autentiserade användarens arbetsyta

3D-utskrift

  • meshy_send_to_slicer — upptäck installerade slicers och starta modellen i en av dem (körs lokalt på din dator; inget Meshy API-anrop)
  • meshy_analyze_printability — returnerar för närvarande en manuell checklista för utskriftsberedskap (väggtjocklek, överhäng, manifold-nät, etc.). Kommer att uppgraderas till automatiserad analys när Meshys utskrivbarhets-API blir tillgängligt.
  • meshy_process_multicolor — konvertera en texturerad modell till en flerfärgad 3MF-fil för utskrift

Konto

  • meshy_check_balance — fråga efter återstående credits

Verktygsnamn och beteenden kan komma att ändras. Den auktoritativa listan finns i MCP server-källkoden.

Exempel på prompter

Klistra in dessa i din MCP-aktiverade chatt som en utgångspunkt.

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 och llms-full.txt

Om din agent inte stöder MCP, eller om du vill hämta in Meshy-dokumentationen direkt i en prompt, pekar du den mot våra vanliga textytor:

  • llms.txt — kompakt index + integrationsinstruktioner (det korrekta mönstret för asynkron polling, autentiseringsregler, rate limits, modellval, vanliga misstag).
  • llms-full.txt — varje API-sida sammanslagen i en enda fil för hämtning i ett svep.
  • Markdown per sida: lägg till .md efter valfri endpoint-URL. Exempel: https://docs.meshy.ai/api/text-to-3d.md.

Alla tre genereras om varje gång dokumentationssajten byggs, så de avviker aldrig från HTML-dokumentationen.

FAQ

Är MCP servern stateless?
Ja. Din MESHY_API_KEY används per förfrågan och sparas aldrig på serversidan.
Kostar MCP samma sak som REST API:et?
Ja — varje MCP-verktygsanrop motsvarar ett enskilt REST-anrop och förbrukar credits i exakt samma takt. Se sidan Priser för hela matrisen.
Vilka är rate limits?
MCP servern delar samma rate-limit-nivå som REST API:et. Se sidan Rate Limits för gränser per nivå.
Vilken Meshy-data kan MCP komma åt?
Endast det som MESHY_API_KEY kan komma åt via REST. Scopes och behörigheter är identiska.
Hur rapporterar jag problem?
Skapa ett ärende i repot meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues