AI-integratie

Meshy biedt twee kanalen voor AI-agenten en code-assistenten: de Meshy MCP server voor tool-aanroepen, en llms.txt / llms-full.txt voor documentatie-invoer.

Als je Meshy integreert vanuit Claude Code, Cursor, Windsurf, Codex, of een andere MCP-compatibele tool, installeer dan de MCP server hieronder. Als je integreert vanuit een eenvoudige chatagent zonder MCP-ondersteuning, richt het dan op https://docs.meshy.cn/llms.txt.

Wat is MCP

Het Model Context Protocol (MCP) is een open standaard die AI-assistenten in staat stelt externe tools aan te roepen en gestructureerde context op te halen. De Meshy MCP server verpakt de Meshy REST API als een set tools die je agent kan aanroepen — genereer een model, controleer een taak, download het resultaat — 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 MESHY_API_KEY omgevingsvariabele.

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 vaardigheid? Het open-source meshy-3d-agent vaardigheidspakket levert vooraf geschreven Meshy-workflows (genereren → poll → downloaden) voor Claude Code, Cursor en OpenClaw. Het roept de Meshy REST API direct aan — geen MCP server vereist.

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

Beschikbare Tools

De MCP server stelt de Meshy REST API bloot als tools, gegroepeerd op capaciteit.

3D Generatie

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

Post-Processing

  • meshy_remesh — verander de topology en/of 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 karakter
  • meshy_animate — pas een animatie toe op een geskeletteerd karakter

Afbeelding Generatie

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

Taakbeheer

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

Werkruimte

  • meshy_list_models — lijst alle modellen in de geauthenticeerde gebruiker zijn werkruimte

3D-printen

  • meshy_send_to_slicer — detecteer geïnstalleerde slicers en start het model in één (draait lokaal op je machine; geen Meshy API-aanroep)
  • meshy_analyze_printability — geeft momenteel een handmatige print-gereedheidschecklist terug (wanddikte, overhangs, manifold mesh, etc.). Wordt geüpgraded naar geautomatiseerde analyse zodra de Meshy printbaarheid API beschikbaar is.
  • meshy_process_multicolor — converteer een getextureerd model naar een multi-color 3MF-bestand voor printen

Account

  • meshy_check_balance — vraag resterende credits op

Toolnamen en gedragingen kunnen evolueren. De gezaghebbende lijst bevindt zich in de MCP server bron.

Voorbeeld Prompts

Plaats deze in je MCP-compatibele 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 je wilt de Meshy documentatie direct in een prompt invoeren, richt het dan op onze platte-tekst oppervlakken:

  • llms.txt — compacte index + integratie-instructies (het correcte async-polling patroon, auth regels, snelheidslimieten, modelkeuze, veelgemaakte fouten).
  • llms-full.txt — elke API-pagina samengevoegd in één bestand voor eenmalige invoer.
  • Per-pagina Markdown: voeg .md toe aan elke endpoint URL. Voorbeeld: https://docs.meshy.cn/api/text-to-3d.md.

Alle drie worden elke keer opnieuw gegenereerd wanneer de documentatiesite wordt opgebouwd, 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 aan de serverzijde opgeslagen.
Kost MCP hetzelfde als de REST API?
Ja — elke MCP tool-aanroep komt overeen met een enkele REST-aanroep en verbruikt credits tegen exact hetzelfde tarief. Zie de Prijzen pagina voor de volledige matrix.
Wat zijn de snelheidslimieten?
De MCP server deelt hetzelfde snelheidslimietvlak als de REST API. Zie de Snelheidslimieten pagina voor limieten per niveau.
Welke Meshy-gegevens kan de MCP benaderen?
Alleen wat de MESHY_API_KEY kan benaderen via REST. Reikwijdten en permissies zijn identiek.
Hoe rapporteer ik problemen?
Dien een probleem in bij de meshy-mcp-server repository: https://github.com/meshy-dev/meshy-mcp-server/issues