AI Integration

Nagbibigay ang Meshy ng dalawang channel para sa mga AI agent at coding assistant: ang Meshy MCP server para sa tool-calling, at llms.txt / llms-full.txt para sa pag-ingest ng docs.

Kung ini-integrate mo ang Meshy mula sa Claude Code, Cursor, Windsurf, Codex, o anumang iba pang MCP-compatible na tool, i-install ang MCP server sa ibaba. Kung ini-integrate mo ito mula sa isang plain chat agent na walang suporta sa MCP, ituro ito sa https://docs.meshy.ai/llms.txt sa halip.

Ano ang MCP

Ang Model Context Protocol (MCP) ay isang open standard na nagpapahintulot sa mga AI assistant na tumawag ng external tools at kumuha ng structured context. Binabalot ng Meshy MCP server ang Meshy REST API bilang isang set ng tools na maaaring i-invoke ng iyong agent — mag-generate ng model, mag-check ng task, i-download ang resulta — nang hindi nagsusulat ng HTTP code nang mano-mano.

Ang MCP server ay open source at naka-publish sa npm bilang @meshy-ai/meshy-mcp-server. Source: github.com/meshy-dev/meshy-mcp-server.

Kailangan mo ng Meshy API key. Gumawa ng isa sa https://www.meshy.ai/settings/api. Binabasa ito ng MCP server mula sa MESHY_API_KEY environment variable.

Mabilisang Pag-install

# 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

Mas gusto mo ba ng drop-in skill sa halip? Ang open-source na meshy-3d-agent skill pack ay may kasamang pre-written Meshy workflows (generate → poll → download) para sa Claude Code, Cursor, at OpenClaw. Direkta nitong tinatawag ang Meshy REST API — hindi kailangan ang MCP server.

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

Mga Available na Tool

Inilalantad ng MCP server ang Meshy REST API bilang tools, na naka-grupo ayon sa capability.

3D Generation

  • meshy_text_to_3d — lumikha ng 3D model mula sa text prompt
  • meshy_image_to_3d — lumikha ng 3D model mula sa isang image
  • meshy_multi_image_to_3d — lumikha ng 3D model mula sa maraming image ng parehong object
  • meshy_text_to_3d_refine — magdagdag ng texture sa preview mesh

Post-Processing

  • meshy_remesh — baguhin ang topology at/o polycount ng umiiral na model
  • meshy_retexture — mag-apply ng bagong texture sa umiiral na model
  • meshy_rig — magdagdag ng skeleton sa isang 3D humanoid character
  • meshy_animate — mag-apply ng Animation sa character na may rig

Image Generation

  • meshy_text_to_image — 2D image mula sa text
  • meshy_image_to_image — 2D image mula sa reference image

Task Management

  • meshy_get_task_status — suriin ang status ng task at mga download URL
  • meshy_list_tasks — ilista ang mga kamakailang task, na opsyonal na na-filter ayon sa type/status
  • meshy_cancel_task — i-cancel ang pending o in-progress na task
  • meshy_download_model — kunin ang completed na model file at i-save nang locally

Workspace

  • meshy_list_models — ilista ang lahat ng model sa workspace ng authenticated user

3D Printing

  • meshy_send_to_slicer — i-detect ang installed slicers at i-launch ang model sa isa sa mga ito (tumatakbo locally sa iyong machine; walang Meshy API call)
  • meshy_analyze_printability — kasalukuyang nagbabalik ng manual print-readiness checklist (kapal ng dingding, overhangs, manifold mesh, atbp.). Ia-upgrade ito sa automated analysis kapag available na ang Meshy printability API.
  • meshy_process_multicolor — i-convert ang textured model sa isang multi-color na 3MF file para sa printing

Account

  • meshy_check_balance — i-query ang natitirang credits

Maaaring magbago ang mga pangalan at behavior ng tool. Ang authoritative list ay nasa MCP server source.

Mga Halimbawang prompt

Ilagay ang mga ito sa iyong MCP-enabled chat bilang panimulang punto.

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 at llms-full.txt

Kung hindi sinusuportahan ng iyong agent ang MCP, o gusto mong i-ingest ang Meshy docs direkta sa isang prompt, ituro ito sa aming plain-text surfaces:

  • llms.txt — compact na index + instructions sa integration (ang tamang async-polling pattern, auth rules, rate limits, model choice, common mistakes).
  • llms-full.txt — bawat API page na pinagsama-sama sa iisang file para sa single-fetch ingestion.
  • Per-page Markdown: idagdag ang .md sa anumang endpoint URL. Halimbawa: https://docs.meshy.ai/api/text-to-3d.md.

Nire-regenerate ang tatlo tuwing nagbu-build ang docs site, kaya hindi sila kailanman lumalayo sa HTML docs.

FAQ

Is the MCP server stateless?
Yes. Your MESHY_API_KEY is used per request and never persisted on the server side.
Does MCP cost the same as the REST API?
Yes — every MCP tool call maps to a single REST call and consumes credits at the exact same rate. See the Pricing page for the full matrix.
What are the rate limits?
The MCP server shares the same rate-limit plane as the REST API. See the Rate Limits page for per-tier limits.
What Meshy data can the MCP access?
Only what the MESHY_API_KEY can access via REST. Scopes and permissions are identical.
How do I report issues?
File an issue at the meshy-mcp-server repository: https://github.com/meshy-dev/meshy-mcp-server/issues