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 documentatie-inname.

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 in plaats daarvan 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 handmatig HTTP-code 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.

Je hebt een Meshy API-sleutel nodig. Maak er een aan op https://www.meshy.ai/settings/api. De MCP server leest deze uit de omgevingsvariabele MESHY_API_KEY.

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

Liever een kant-en-klare skill? Het open-source meshy-3d-agent skillpakket bevat vooraf geschreven Meshy-workflows (genereren → pollen → downloaden) voor Claude Code, Cursor en OpenClaw. Het roept de Meshy REST API rechtstreeks aan — geen MCP server vereist.

npx skills add meshy-dev/meshy-3d-agent

Beschikbare tools

De MCP server stelt de Meshy REST API beschikbaar als tools, gegroepeerd op mogelijkheid.

3D-generatie

  • meshy_text_to_3d — maak een 3D-model vanuit een tekstprompt
  • meshy_image_to_3d — maak een 3D-model vanuit één afbeelding
  • meshy_multi_image_to_3d — maak een 3D-model vanuit meerdere afbeeldingen van hetzelfde object
  • meshy_text_to_3d_refine — voeg textuur toe aan een preview-mesh

Nabewerking

  • meshy_remesh — wijzig de topology en/of het polygonaantal van een bestaand model
  • meshy_retexture — pas een nieuwe textuur toe op een bestaand model
  • meshy_rig — voeg een skelet toe aan een 3D humanoïde personage
  • meshy_animate — pas een animatie toe op een gerigged personage

Afbeeldingsgeneratie

  • meshy_text_to_image — 2D-afbeelding vanuit tekst
  • meshy_image_to_image — 2D-afbeelding vanuit een referentieafbeelding

Taakbeheer

  • meshy_get_task_status — controleer taakstatus en download-URL's
  • meshy_list_tasks — lijst recente taken op, optioneel gefilterd op type/status
  • meshy_cancel_task — annuleer een wachtende of lopende taak
  • meshy_download_model — haal een voltooid modelbestand op en sla het lokaal op

Werkruimte

  • meshy_list_models — lijst alle modellen op in de werkruimte van de geauthenticeerde gebruiker

3D-printen

  • meshy_send_to_slicer — detecteer geïnstalleerde slicers en open het model in één daarvan (wordt lokaal op je machine uitgevoerd; geen Meshy API-aanroep)
  • meshy_analyze_printability — retourneert momenteel een handmatige checklist voor printgereedheid (wanddikte, overhangen, manifold mesh, enz.). Wordt geüpgraded naar geautomatiseerde analyse zodra de Meshy printbaarheid API beschikbaar is.
  • meshy_process_multicolor — converteer een getextureerd model naar een meerkleurig 3MF-bestand om te printen

Account

  • meshy_check_balance — vraag resterende credits op

Toolnamen en gedrag kunnen evolueren. De gezaghebbende lijst staat in de MCP server-broncode.

Voorbeeldprompts

Plaats deze in je MCP-ingeschakelde chat als startpunt.

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-docs rechtstreeks in een prompt wilt opnemen, verwijs hem dan naar onze platte-tekstoppervlakken:

  • llms.txt — compacte index + integratie-instructies (het juiste async-pollingpatroon, auth-regels, rate limits, modelkeuze, veelgemaakte fouten).
  • llms-full.txt — elke API-pagina samengevoegd in één bestand voor single-fetch-inname.
  • 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 docs-site wordt gebouwd, zodat ze nooit afwijken van de HTML-docs.

FAQ

Is de MCP server stateless?
Ja. Je MESHY_API_KEY wordt per aanvraag gebruikt en wordt nooit op de serverzijde opgeslagen.
Kost MCP hetzelfde als de REST API?
Ja — elke MCP-toolaanroep wordt gekoppeld aan één REST-aanroep en verbruikt credits tegen exact hetzelfde tarief. Zie de pagina Prijzen voor de volledige matrix.
Wat zijn de rate limits?
De MCP server deelt hetzelfde rate-limit-vlak als de REST API. Zie de pagina Rate Limits voor limieten per tier.
Tot welke Meshy-gegevens heeft MCP toegang?
Alleen tot wat de MESHY_API_KEY via REST kan openen. Scopes en machtigingen zijn identiek.
Hoe rapporteer ik problemen?
Dien een issue in bij de meshy-mcp-server-repository: https://github.com/meshy-dev/meshy-mcp-server/issues