AI-integratie

Meshy biedt twee kanalen voor AI-agents 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 reeks 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.

Je hebt een Meshy API-sleutel nodig. Maak er een aan op de API Keys-pagina in het Developer Platform. 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 opensource meshy-3d-agent skillpakket levert kant-en-klare Meshy-workflows (genereren → pollen → downloaden) voor Claude Code, Cursor en OpenClaw. Het roept de Meshy REST API rechtstreeks aan — er is geen MCP server nodig.

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 — maak een 3D-model op basis van een tekstprompt
  • meshy_image_to_3d — maak een 3D-model op basis van één afbeelding
  • meshy_multi_image_to_3d — maak een 3D-model op basis van 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 gerigd personage

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 — controleer de taakstatus en downloadlinks
  • meshy_list_tasks — geef recente taken weer, optioneel gefilterd op type/status
  • meshy_cancel_task — annuleer een taak die in behandeling is of wordt uitgevoerd
  • meshy_download_model — haal een voltooid modelbestand op en sla het lokaal op

Werkruimte

  • meshy_list_models — geef alle modellen weer in de werkruimte van de geauthenticeerde gebruiker

3D-printen

  • meshy_send_to_slicer — detecteert geïnstalleerde slicers en start het model in een daarvan (draait lokaal op je machine; geen Meshy API-aanroep)
  • meshy_analyze_printability — geeft momenteel een handmatige printgereedheidschecklist terug (wanddikte, overhangen, manifold mesh, enz.). Wordt geüpgraded naar geautomatiseerde analyse zodra de Meshy printbaarheids-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 veranderen. De meest actuele lijst is te vinden in de MCP server-broncode.

Voorbeeldprompts

Gebruik deze als startpunt 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 geen MCP ondersteunt, of je wilt de Meshy-documentatie rechtstreeks in een prompt verwerken, verwijs dan naar onze platte-tekst-bronnen:

  • 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 in één keer.
  • Markdown per pagina: voeg .md toe aan elke endpoint-URL. Voorbeeld: https://docs.meshy.ai/api/text-to-3d.md.

Alle drie worden bij elke build van de documentatiesite opnieuw gegenereerd, zodat ze nooit afwijken van de HTML-documentatie.

Veelgestelde vragen

Is de MCP server stateless?
Ja. Je MESHY_API_KEY wordt per verzoek gebruikt en nooit aan de serverzijde bewaard.
Kost MCP evenveel als de REST API?
Ja — elke MCP tool-aanroep komt overeen met één REST-aanroep en verbruikt credits tegen exact hetzelfde tarief. Bekijk de Prijzen-pagina voor het volledige overzicht.
Wat zijn de rate limits?
De MCP server deelt hetzelfde rate-limitniveau als de REST API. Zie de pagina Rate Limits voor de limieten per tier.
Tot welke Meshy-gegevens heeft de MCP toegang?
Alleen tot wat de MESHY_API_KEY kan benaderen via REST. Scopes en rechten 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