lowpoly wordt op 30 okt 2026 uitgefaseerd. Stap vóór deze datums over op een ander model om fouten bij verzoeken te voorkomen. Alle afschaffingen bekijken

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

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 tekstprompt
  • meshy_image_to_3d: maakt een 3D-model op basis van één afbeelding
  • meshy_multi_image_to_3d: maakt een 3D-model op basis van meerdere afbeeldingen van hetzelfde object
  • meshy_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 beide
  • meshy_retexture: past een nieuwe textuur toe op een bestaand model
  • meshy_rig: voegt een skelet toe aan een 3D-humanoïde personage
  • meshy_animate: past een animatie toe op een gerigd personage
  • meshy_convert: converteert een model naar een ander bestandsformaat
  • meshy_resize: wijzigt het formaat van een model naar werkelijke afmetingen
  • meshy_uv_unwrap: genereert een nieuwe UV-layout voor een model
  • meshy_text_to_motion: genereert een animatie op basis van een tekstprompt
  • meshy_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 tekst
  • meshy_image_to_image: maakt een 2D-afbeelding op basis van een referentieafbeelding

Taakbeheer

  • meshy_get_task_status: controleert de taakstatus en download-URL's
  • meshy_list_tasks: toont recente taken, optioneel gefilterd op type of status
  • meshy_cancel_task: verwijdert een taak. Meshy verwijdert en vergoedt een PENDING-taak, en verwijdert een afgeronde taak. Een IN_PROGRESS-taak kan niet worden geannuleerd, en de API retourneert 409.
  • 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 taaktypen meshy_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 vlakken
  • meshy_process_multicolor: converteert een getextureerd model naar een multicolor 3MF-bestand om te printen
  • meshy_repair_printability: repareert een model voor FDM-printen
  • meshy_auto_split: splitst een model op in afzonderlijk printbare onderdelen

Account

  • meshy_check_balance: controleert je resterende credits
  • meshy_list_usage: toont de afgeronde API-taken van je team en het aantal gebruikte credits per taak, voor Studio- en Enterprise-teams

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 .md toe aan elke endpoint-URL, bijvoorbeeld https://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