AI Integration

Naglalabas si 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 dokumentasyon.

Kung ika'y nag-i-integrate ng Meshy mula sa Claude Code, Cursor, Windsurf, Codex, o anumang iba pang MCP-compatible na tool, i-install ang MCP server sa ibaba. Kung ika'y nag-i-integrate mula sa isang simpleng chat agent na walang suporta sa MCP, ituro na lamang ito sa https://docs.meshy.ai/llms.txt.

Ano ang MCP

Ang Model Context Protocol (MCP) ay isang open standard na nagbibigay-daan sa mga AI assistant na tumawag sa mga external na tool at kumuha ng structured na context. Ang Meshy MCP server ay binabalot ang Meshy REST API bilang isang set ng mga tool na maaaring gamitin ng iyong agent — mag-generate ng model, mag-check ng task, mag-download ng resulta — nang hindi na kailangang manu-manong sumulat ng HTTP code.

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

Kailangan mo ng Meshy API key. Gumawa ng isa sa API Keys page sa loob ng Developer Platform. Binabasa ito ng MCP server mula sa MESHY_API_KEY na 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 bang gumamit ng handa nang skill? Ang open-source na meshy-3d-agent skill pack ay may kasamang mga naunang-isulat na Meshy workflow (generate → poll → download) para sa Claude Code, Cursor, at OpenClaw. Direkta itong tumatawag sa Meshy REST API — hindi na kailangan ng MCP server.

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

Mga Available na Tool

Inilalabas ng MCP server ang Meshy REST API bilang mga tool, na nakagrupo ayon sa kakayahan.

3D Generation

  • meshy_text_to_3d — gumawa ng 3D model mula sa isang text prompt
  • meshy_image_to_3d — gumawa ng 3D model mula sa isang imahe
  • meshy_multi_image_to_3d — gumawa ng 3D model mula sa maraming imahe ng iisang bagay
  • meshy_text_to_3d_refine — magdagdag ng texture sa isang preview mesh

Post-Processing

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

Image Generation

  • meshy_text_to_image — 2D na imahe mula sa text
  • meshy_image_to_image — 2D na imahe mula sa isang reference na imahe

Task Management

  • meshy_get_task_status — suriin ang status ng task at ang mga download URL
  • meshy_list_tasks — ilista ang mga kamakailang task, opsyonal na naka-filter ayon sa type/status
  • meshy_cancel_task — kanselahin ang isang nakabinbin o kasalukuyang isinasagawang task
  • meshy_download_model — kunin ang isang natapos na model file at i-save ito nang lokal

Workspace

  • meshy_list_models — ilista ang lahat ng model sa workspace ng naka-authenticate na user

3D Printing

  • meshy_send_to_slicer — tuklasin ang mga naka-install na slicer at ilunsad ang model sa isa sa mga ito (tumatakbo nang lokal sa iyong makina; walang tawag sa Meshy API)
  • meshy_analyze_printability — sa kasalukuyan ay nagbabalik ng manual na checklist para sa kahandaan sa pag-print (kapal ng dingding, mga overhang, manifold mesh, atbp.). I-a-upgrade ito sa automated analysis kapag available na ang Meshy printability API.
  • meshy_process_multicolor — i-convert ang isang naka-texture na model sa isang multi-color na 3MF file para sa pag-print

Account

  • meshy_check_balance — tanungin ang natitirang credits

Maaaring magbago ang mga pangalan at gawi ng tool. Ang pangunahing listahan ay matatagpuan sa MCP server source.

Mga Halimbawang Prompt

Idikit ang mga ito sa iyong MCP-enabled na 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 direktang i-ingest ang mga dokumento ng Meshy sa isang prompt, ituro ito sa aming mga plain-text na surface:

  • llms.txt — compact na index + mga tagubilin sa pag-integrate (ang tamang async-polling pattern, mga patakaran sa auth, rate limits, pagpili ng model, karaniwang mga pagkakamali).
  • llms-full.txt — bawat pahina ng API na pinagsama sa iisang file para sa single-fetch na pag-ingest.
  • Markdown bawat pahina: idagdag ang .md sa anumang endpoint URL. Halimbawa: https://docs.meshy.ai/api/text-to-3d.md.

Ang lahat ng tatlo ay muling nabubuo tuwing mag-build ang docs site, kaya hindi sila kailanman lumihis mula 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