AI-integration

Meshy erbjuder två kanaler för AI-agenter och kodassistenter: Meshy MCP server för verktygsanrop, samt llms.txt / llms-full.txt för inhämtning av dokumentation.

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

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 omsluter Meshy REST API som en uppsättning verktyg din agent kan anropa — generera en modell, kontrollera en uppgift, 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.

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

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 ett texturlöst förhandsgranskningsnät utifrå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örhandsgranskningsnät

Efterbehandling

• meshy_remesh: ändra topologin och/eller polygonantalet för en befintlig modell
• meshy_retexture: applicera en ny textur på en befintlig modell
• meshy_rig: lägg till ett skelett på en humanoid 3D-karaktär
• meshy_animate: applicera en animation på en riggad karaktär
• meshy_convert: konvertera en modell till ett annat filformat
• meshy_resize: ändra storlek på en modell till verkliga dimensioner
• meshy_uv_unwrap: generera en ny UV-layout för en modell

Creative Lab

• meshy_creative_lab: omvandla ett foto till en färdig Creative Lab-produkt (kör uppgifterna för prototyp och bygge)

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 filtrerat efter typ/status
• meshy_cancel_task: ta bort en uppgift. En PENDING-uppgift tas bort och återbetalas; en IN_PROGRESS-uppgift kan inte avbrytas (API:et returnerar 409); en avslutad uppgift tas bort.
• meshy_download_model: hämta en färdig modellfil och spara lokalt

Arbetsyta

• meshy_list_models: lista dina senaste Text till 3D-modeller (använd meshy_list_tasks för andra uppgiftstyper)

3D-utskrift

• meshy_send_to_slicer: upptäck installerade slicers och returnera ett kommando för att öppna modellen i en av dem (körs lokalt; inget anrop till Meshy API)
• meshy_analyze_printability: kostnadsfri automatisk kontroll av FDM-utskrivbarhet (täthet, volym, hål, non-manifold-kanter, degenererade ytor)
• meshy_process_multicolor: konvertera en texturerad modell till en flerfärgad 3MF-fil för utskrift
• meshy_repair_printability: reparera en modell för FDM-utskrift

Konto

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

Exempel på prompter

Använd dessa som utgångspunkt i din MCP-aktiverade chatt.

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, peka den mot våra textbaserade ytor:

• llms.txt — kompakt index + integrationsinstruktioner (rätt mönster för asynkron avfrågning, autentiseringsregler, hastighetsgränser, modellval, vanliga misstag).
• llms-full.txt — varje API-sida sammanslagen i en enda fil för inhämtning med en enda hämtning.
• Markdown per sida: lägg till .md efter valfri endpoint-URL. Exempel: https://docs.meshy.ai/api/text-to-3d.md.

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

Vanliga frågor

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