AI-integratie

Meshy biedt twee kanalen voor AI-agenten en codeerassistenten: de Meshy MCP server voor tool-calling, en llms.txt / llms-full.txt voor het verwerken van documentatie.

Als je Meshy integreert vanuit Claude Code, Cursor, Windsurf, Codex of een andere MCP-compatibele tool, installeer dan hieronder de MCP server. Als je integreert vanuit een gewone chatagent zonder MCP-ondersteuning, verwijs deze 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 ophalen. De Meshy MCP server verpakt de Meshy REST API als een set tools die je agent kan aanroepen — een model genereren, een taak controleren, het resultaat downloaden — zonder dat je zelf HTTP-code hoeft te schrijven.

De MCP server is open source en gepubliceerd op npm als @meshy-ai/meshy-mcp-server. Bron: github.com/meshy-dev/meshy-mcp-server.

Snelle installatie

# 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

Beschikbare tools

De MCP server biedt de Meshy REST API aan als tools, gegroepeerd per functionaliteit.

3D-generatie

• meshy_text_to_3d: maakt een niet-getextureerde 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

Nabewerking

• meshy_remesh: wijzigt de topology en/of het polygonaantal van een bestaand model
• meshy_retexture: past een nieuwe textuur toe op een bestaand model
• meshy_rig: voegt een skelet toe aan een 3D-humanoid 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 reële afmetingen
• meshy_uv_unwrap: genereert een nieuwe UV-layout voor een model

Creative Lab

• meshy_creative_lab: maakt van een foto een afgewerkt Creative Lab-product (voert de prototype- en build-taken uit)

Afbeeldingsgeneratie

• meshy_text_to_image: 2D-afbeelding op basis van tekst
• meshy_image_to_image: 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/status
• meshy_cancel_task: verwijdert een taak. Een taak met status PENDING wordt verwijderd en terugbetaald; een taak met status IN_PROGRESS kan niet worden geannuleerd (de API retourneert 409); een voltooide taak wordt verwijderd.
• meshy_download_model: haalt een voltooid modelbestand op en slaat het lokaal op

Werkruimte

• meshy_list_models: toont je recente Tekst naar 3D-modellen (gebruik meshy_list_tasks voor andere taaktypen)

3D-printen

• meshy_send_to_slicer: detecteert geïnstalleerde slicers en geeft een commando om het model erin te openen (draait lokaal; geen Meshy API-aanroep)
• meshy_analyze_printability: gratis geautomatiseerde FDM-printbaarheidscontrole (waterdichtheid, volume, gaten, niet-manifold randen, gedegenereerde vlakken)
• meshy_process_multicolor: converteert een getextureerd model naar een meerkleurig 3MF-bestand voor printen
• meshy_repair_printability: repareert een model voor FDM-printen

Account

• meshy_check_balance: vraagt het resterende aantal credits op

Voorbeeldprompts

Gebruik deze als uitgangspunt in je MCP-compatibele 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 geen MCP ondersteunt, of als je de Meshy-documentatie direct in een prompt wilt verwerken, verwijs deze dan naar onze platte-tekstbronnen:

• llms.txt — compacte index + integratie-instructies (het juiste asynchrone pollingpatroon, authenticatieregels, rate limits, modelkeuze, veelgemaakte fouten).
• llms-full.txt — alle API-pagina's samengevoegd in één bestand voor ingestie met één enkele fetch.
• Markdown per pagina: voeg .md toe aan elke endpoint-URL. Voorbeeld: https://docs.meshy.ai/api/text-to-3d.md.

Alle drie worden opnieuw gegenereerd telkens wanneer de documentatiesite wordt gebouwd, zodat ze nooit afwijken van de HTML-documentatie.

FAQ

Is de MCP server stateless?

Ja. Je MESHY_API_KEY wordt per verzoek gebruikt en nooit serverzijdig opgeslagen.

Kost MCP hetzelfde als de REST API?

Ja — elke MCP tool-aanroep komt overeen met één enkele REST-aanroep en verbruikt credits tegen exact hetzelfde tarief. Zie de Prijzen-pagina voor de volledige matrix.

Wat zijn de rate limits?

De MCP server deelt hetzelfde rate-limitniveau als de REST API. Zie de Rate Limits-pagina voor limieten per tier.

Tot welke Meshy-gegevens heeft de MCP toegang?

Alleen tot wat de MESHY_API_KEY via REST kan benaderen. Scopes en machtigingen zijn identiek.

Hoe meld ik problemen?

Dien een issue in bij de meshy-mcp-server-repository: https://github.com/meshy-dev/meshy-mcp-server/issues