AI-integration

Anslut AI-agenter och kodassistenter till Meshy, med Meshy MCP server för anrop av verktyg, eller med llms.txt och llms-full.txt för att läsa dokumentationen.

Om du använder Claude Code, Cursor, Windsurf, Codex eller en annan MCP-klient, installera MCP-servern. Om din chattagent inte stödjer MCP, 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 få strukturerad kontext. Meshy MCP server omsluter Meshy REST API som verktyg som din agent kan anropa. Med dem kan agenten generera en modell, kontrollera en uppgift och ladda ner resultatet utan handskriven HTTP-kod.

MCP-servern är öppen källkod. Den publiceras på npm som @meshy-ai/meshy-mcp-server, och dess källkod finns i meshy-mcp-server-repositoriet på GitHub.

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

Installera MCP-servern

För att installera servern, använd fliken för din AI-klient. Ersätt msy_YOUR_API_KEY med din API-nyckel.

# 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 erbjuder Meshy REST API som följande verktyg, grupperade efter funktion.

3D-generering

• meshy_text_to_3d: skapa ett otexturerat förhandsgranskningsnät 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örhandsgranskningsnät

Efterbearbetning

• meshy_remesh: ändra topology eller polygonantal för en befintlig modell, eller båda
• 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
• 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
• meshy_text_to_motion: generera en animation från en textprompt
• meshy_list_animations: slå upp de förinställda animationsåtgärds-ID:na, gratis

Creative Lab

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

Bildgenerering

• meshy_text_to_image: skapa en 2D-bild från text
• meshy_image_to_image: skapa en 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 eller status
• meshy_cancel_task: ta bort en uppgift. Meshy tar bort och återbetalar en PENDING-uppgift, och tar bort en avslutad uppgift. En IN_PROGRESS-uppgift kan inte avbrytas, och API:et returnerar 409.
• meshy_download_model: ladda ner en avslutad modellfil och spara den lokalt

Arbetsyta

• meshy_list_models: lista dina senaste Text till 3D-modeller. För andra uppgiftstyper, använd meshy_list_tasks.

3D-utskrift

• meshy_send_to_slicer: hitta slicers installerade på din dator, och returnera ett kommando som öppnar modellen i en av dem. Det körs lokalt och anropar inte Meshy API.
• meshy_analyze_printability: kontrollera en modells FDM-utskrivbarhet gratis, inklusive vattentäthet, volym, hål, non-manifold-kanter och 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
• meshy_auto_split: dela upp en modell i separat utskrivbara delar

Konto

• meshy_check_balance: kontrollera dina återstående credits
• meshy_list_usage: lista ditt teams avslutade API-uppgifter och de credits var och en använde, för Studio- och Enterprise-team

Exempel på prompter

För att komma igång, prova dessa prompter 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ödjer MCP, eller om du vill lägga in Meshy-dokumentationen direkt i en prompt, peka den mot textversionerna av dokumentationen:

• llms.txt: ett kompakt index med integrationsinstruktioner, till exempel hur man avfrågar asynkrona uppgifter, autentisering, hastighetsgränser, modellval och vanliga misstag.
• llms-full.txt: varje API-sida i en enda fil, så att en agent kan läsa dokumentationen i en enda förfrågan.
• Markdown per sida: lägg till .md till valfri endpoint-URL, till exempel https://docs.meshy.ai/api/text-to-3d.md.

Meshy återskapar alla tre varje gång dokumentationssajten byggs, så att de matchar HTML-dokumentationen.

FAQ

Är MCP-servern tillståndslös?

Den lagrar inte dina autentiseringsuppgifter. Servern behåller din MESHY_API_KEY i minnet och skriver aldrig den till disk. Som standard sparar den de modeller den laddar ner, med deras metadata, i en meshy_output-mapp i sin arbetskatalog. För att spara en nedladdning någon annanstans, ange en save_to-sökväg till nedladdningsverktyget.

Kostar MCP samma som REST API:et?

Ja. MCP-verktygsanrop gör samma REST-anrop och använder credits i samma takt. Se sidan Priser för alla priser.

Vilka är hastighetsgränserna?

MCP-serverns anrop räknas mot samma hastighetsgränser som dina REST API-anrop. Se sidan Rate limits för gränserna för varje plan.

Vilken Meshy-data kan MCP-servern komma åt?

Endast det som din MESHY_API_KEY kan komma åt via REST API:et, med samma behörigheter.

Hur rapporterar jag problem?

Öppna ett ärende i meshy-mcp-server-repositoriet på GitHub: https://github.com/meshy-dev/meshy-mcp-server/issues