AI-integration

Meshy tillhandahåller två kanaler för AI-agenter och kodningsassistenter: Meshy MCP server för verktygsanrop, och llms.txt / llms-full.txt för inläsning av dokumentation.

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

Vad är MCP

Model Context Protocol (MCP) är en öppen standard som låter AI-assistenter anropa externa verktyg och hämta strukturerad kontext. Meshy MCP server paketerar Meshy REST API som en uppsättning verktyg som din agent kan anropa — generera en modell, kontrollera en uppgift, ladda ner resultatet — utan att behöva handskriva HTTP-kod.

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

Du behöver en Meshy API-nyckel. Skapa en på https://www.meshy.ai/settings/api. MCP server 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 direkt användbar skill istället? Det öppna meshy-3d-agent skill-paketet levereras med förskrivna Meshy-arbetsflöden (generera → polla → 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 server exponerar Meshy REST API som verktyg, grupperade efter funktion.

3D-generering

  • meshy_text_to_3d — skapa en 3D-modell från en textprompt
  • 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 förhandsvisningsnä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

Uppgiftshantering

  • meshy_get_task_status — kontrollera uppgiftsstatus och nedladdnings-URL:er
  • meshy_list_tasks — lista senaste uppgifter, valfritt filtrerade efter typ/status
  • meshy_cancel_task — avbryt en väntande eller pågående uppgift
  • 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 — identifiera 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, osv.). Kommer att uppgraderas till automatiserad analys när Meshy API för utskrivbarhet är 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 utvecklas. Den auktoritativa listan finns i MCP server source.

Exempelprompter

Klistra in dessa i din MCP-aktiverade chatt som en startpunkt.

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 läsa in Meshy-dokumentationen direkt i en prompt, peka den mot våra ytor i klartext:

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

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

FAQ

Is the MCP server stateless?
Yes. Your MESHY_API_KEY is used per request and never persisted on the server side.
Does MCP cost the same as the REST API?
Yes — every MCP tool call maps to a single REST call and consumes credits at the exact same rate. See the Pricing page for the full matrix.
What are the rate limits?
The MCP server shares the same rate-limit plane as the REST API. See the Rate Limits page for per-tier limits.
What Meshy data can the MCP access?
Only what the MESHY_API_KEY can access via REST. Scopes and permissions are identical.
How do I report issues?
File an issue at the meshy-mcp-server repository: https://github.com/meshy-dev/meshy-mcp-server/issues