AI-integratie
Verbind AI-agents en codeerassistenten met Meshy, met de Meshy MCP server voor tool calls, of met llms.txt en llms-full.txt voor het lezen van de documentatie.
Als je Claude Code, Cursor, Windsurf, Codex of een andere MCP-client gebruikt, installeer dan de MCP server. Als je chatagent MCP niet ondersteunt, verwijs er dan naar https://docs.meshy.ai/llms.txt.
Wat is MCP
Het Model Context Protocol (MCP) is een open standaard waarmee AI-assistenten externe tools kunnen aanroepen en gestructureerde context kunnen ontvangen. De Meshy MCP server verpakt de Meshy REST API als tools die je agent kan aanroepen. Hiermee kan de agent een model genereren, een taak controleren en het resultaat downloaden, zonder handgeschreven HTTP-code.
De MCP server is open source. Hij is gepubliceerd op npm als @meshy-ai/meshy-mcp-server, en de broncode staat in de meshy-mcp-server repository op GitHub.
Je hebt een Meshy API-sleutel nodig. Maak er een aan op de API Keys-pagina van het Developer Platform. De MCP server leest deze uit de omgevingsvariabele MESHY_API_KEY.
De MCP server installeren
Gebruik het tabblad voor jouw AI-client om de server te installeren. Vervang msy_YOUR_API_KEY door je API-sleutel.
# 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
Heb je liever een skill? De open-source meshy-3d-agent skill pack bevat kant-en-klare Meshy-workflows voor Claude Code, Cursor en OpenClaw, zoals het genereren van een model, het pollen van de taak en het downloaden van het resultaat. Deze roept de Meshy REST API rechtstreeks aan, dus je hebt de MCP server niet nodig.
npx skills add meshy-dev/meshy-3d-agent
Beschikbare tools
De MCP server biedt de Meshy REST API aan als de volgende tools, gegroepeerd per functie.
3D-generatie
meshy_text_to_3d: maakt een ongetextureerde preview-mesh op basis van een tekstpromptmeshy_image_to_3d: maakt een 3D-model op basis van één afbeeldingmeshy_multi_image_to_3d: maakt een 3D-model op basis van meerdere afbeeldingen van hetzelfde objectmeshy_text_to_3d_refine: voegt textuur toe aan een preview-mesh
Post-processing
meshy_remesh: verandert de topology of het polygonaantal van een bestaand model, of beidemeshy_retexture: past een nieuwe textuur toe op een bestaand modelmeshy_rig: voegt een skelet toe aan een 3D-humanoïde personagemeshy_animate: past een animatie toe op een gerigd personagemeshy_convert: converteert een model naar een ander bestandsformaatmeshy_resize: wijzigt het formaat van een model naar werkelijke afmetingenmeshy_uv_unwrap: genereert een nieuwe UV-layout voor een modelmeshy_text_to_motion: genereert een animatie op basis van een tekstpromptmeshy_list_animations: zoekt de ID's van de vooraf ingestelde animatieacties op, gratis
Creative Lab
meshy_creative_lab: zet een foto om in een afgewerkt Creative Lab-product (voert de prototype- en build-taken uit)
Afbeeldingsgeneratie
meshy_text_to_image: maakt een 2D-afbeelding op basis van tekstmeshy_image_to_image: maakt een 2D-afbeelding op basis van een referentieafbeelding
Taakbeheer
meshy_get_task_status: controleert de taakstatus en download-URL'smeshy_list_tasks: toont recente taken, optioneel gefilterd op type of statusmeshy_cancel_task: verwijdert een taak. Meshy verwijdert en vergoedt eenPENDING-taak, en verwijdert een afgeronde taak. EenIN_PROGRESS-taak kan niet worden geannuleerd, en de API retourneert409.meshy_download_model: downloadt een afgerond modelbestand en slaat het lokaal op
Werkruimte
meshy_list_models: toont je recente Tekst naar 3D-modellen. Gebruik voor andere taaktypenmeshy_list_tasks.
3D-printen
meshy_send_to_slicer: zoekt de slicers die op je computer zijn geïnstalleerd en geeft een opdracht terug waarmee het model in een ervan wordt geopend. Dit gebeurt lokaal en roept de Meshy API niet aan.meshy_analyze_printability: controleert gratis de FDM-printbaarheid van een model, inclusief waterdichtheid, volume, gaten, niet-manifold randen en gedegenereerde vlakkenmeshy_process_multicolor: converteert een getextureerd model naar een multicolor 3MF-bestand om te printenmeshy_repair_printability: repareert een model voor FDM-printenmeshy_auto_split: splitst een model op in afzonderlijk printbare onderdelen
Account
meshy_check_balance: controleert je resterende creditsmeshy_list_usage: toont de afgeronde API-taken van je team en het aantal gebruikte credits per taak, voor Studio- en Enterprise-teams
Toolnamen en gedrag kunnen veranderen. Voor de volledige lijst, zie de tools in de MCP server-broncode.
Voorbeeldprompts
Probeer om te beginnen deze prompts in je MCP-ondersteunde chat:
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 en llms-full.txt
Als je agent MCP niet ondersteunt, of als je de Meshy-documentatie rechtstreeks in een prompt wilt plaatsen, verwijs er dan naar de platte-tekstversies van de documentatie:
llms.txt: een compacte index met integratie-instructies, zoals hoe je asynchrone taken polt, authenticatie, rate limits, modelkeuze en veelvoorkomende fouten.llms-full.txt: elke API-pagina in één bestand, zodat een agent de documentatie in één verzoek kan lezen.- Markdown per pagina: voeg
.mdtoe aan elke endpoint-URL, bijvoorbeeldhttps://docs.meshy.ai/api/text-to-3d.md.
Meshy genereert alle drie opnieuw telkens wanneer de documentatiesite wordt gebouwd, zodat ze overeenkomen met de HTML-documentatie.
Veelgestelde vragen
- Is de MCP server stateless?
- Hij slaat je inloggegevens niet op. De server bewaart je MESHY_API_KEY in het geheugen en schrijft deze nooit naar schijf. Standaard worden de gedownloade modellen, samen met hun metadata, opgeslagen in een map meshy_output in de werkmap. Geef het downloadtool een save_to-pad om een download ergens anders op te slaan.
- Kost MCP hetzelfde als de REST API?
- Ja. MCP-tool calls doen dezelfde REST-aanroepen en gebruiken credits tegen hetzelfde tarief. Zie de Prijzen-pagina voor alle prijzen.
- Wat zijn de rate limits?
- De aanroepen van de MCP server tellen mee voor dezelfde rate limits als je REST API-aanroepen. Zie de pagina Rate limits voor de limieten van elk plan.
- Welke Meshy-gegevens kan de MCP server benaderen?
- Alleen wat je MESHY_API_KEY via de REST API kan benaderen, met dezelfde rechten.
- Hoe meld ik problemen?
- Open een issue in de meshy-mcp-server repository op GitHub: https://github.com/meshy-dev/meshy-mcp-server/issues