AI integration
Ikonekta ang mga AI agent at coding assistant sa Meshy, gamit ang Meshy MCP server para sa tool calls, o gamit ang llms.txt at llms-full.txt para sa pagbabasa ng mga dokumento.
Kung gumagamit ka ng Claude Code, Cursor, Windsurf, Codex, o ibang MCP client, i-install ang MCP server. Kung hindi sinusuportahan ng iyong chat agent ang MCP, i-point na lang 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 ng mga external tool at makakuha ng structured context. Binabalot ng Meshy MCP server ang Meshy REST API bilang mga tool na pwedeng tawagin ng iyong agent. Sa tulong ng mga ito, kaya ng agent na mag-generate ng model, suriin ang isang task, at i-download ang resulta nang walang hand-written HTTP code.
Open source ang MCP server. Nai-publish ito sa npm bilang @meshy-ai/meshy-mcp-server, at ang source nito ay nasa meshy-mcp-server repository sa GitHub.
Kailangan mo ng Meshy API key. Gumawa ng isa sa API Keys page ng Developer Platform. Binabasa ito ng MCP server mula sa MESHY_API_KEY environment variable.
I-install ang MCP server
Para i-install ang server, gamitin ang tab para sa iyong AI client. Palitan ang msy_YOUR_API_KEY ng iyong API key.
# 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 skill? Ang open-source na meshy-3d-agent skill pack ay may mga handa nang Meshy workflow para sa Claude Code, Cursor, at OpenClaw, gaya ng pag-generate ng model, pag-poll sa task, at pag-download ng resulta. Direkta nitong tinatawag ang Meshy REST API, kaya hindi mo na kailangan ang MCP server.
npx skills add meshy-dev/meshy-3d-agent
Mga available na tool
Inaalok ng MCP server ang Meshy REST API bilang mga sumusunod na tool, nakapangkat ayon sa kakayahan.
3D generation
meshy_text_to_3d: gumawa ng untextured na preview mesh mula sa isang text promptmeshy_image_to_3d: gumawa ng 3D model mula sa isang larawanmeshy_multi_image_to_3d: gumawa ng 3D model mula sa maraming larawan ng parehong bagaymeshy_text_to_3d_refine: magdagdag ng texture sa isang preview mesh
Post-processing
meshy_remesh: baguhin ang topology o polycount ng isang umiiral na model, o parehomeshy_retexture: maglagay ng bagong texture sa isang umiiral na modelmeshy_rig: magdagdag ng skeleton sa isang 3D humanoid charactermeshy_animate: maglapat ng animation sa isang rigged charactermeshy_convert: i-convert ang isang model sa ibang file formatmeshy_resize: i-resize ang isang model sa real-world na dimensyonmeshy_uv_unwrap: bumuo ng bagong UV layout para sa isang modelmeshy_text_to_motion: bumuo ng animation mula sa isang text promptmeshy_list_animations: hanapin ang mga preset animation action ID, nang libre
Creative Lab
meshy_creative_lab: gawing tapos na Creative Lab product ang isang larawan (pinapatakbo ang prototype at build na mga task)
Image generation
meshy_text_to_image: gumawa ng 2D na larawan mula sa textmeshy_image_to_image: gumawa ng 2D na larawan mula sa isang reference image
Task management
meshy_get_task_status: suriin ang status ng task at mga download URLmeshy_list_tasks: ilista ang mga kamakailang task, opsyonal na naka-filter ayon sa type o statusmeshy_cancel_task: burahin ang isang task. Inaalis at ibinabalik ng Meshy ang halaga ng isangPENDINGna task, at binubura ang isang tapos nang task. Hindi puwedeng kanselahin ang isangIN_PROGRESSna task, at ibabalik ng API ang409.meshy_download_model: i-download ang isang tapos nang model file at i-save ito nang lokal
Workspace
meshy_list_models: ilista ang iyong mga kamakailang Text to 3D model. Para sa ibang uri ng task, gamitin angmeshy_list_tasks.
3D printing
meshy_send_to_slicer: hanapin ang mga slicer na naka-install sa iyong computer, at magbalik ng command na magbubukas ng model sa isa sa mga ito. Tumatakbo ito nang lokal at hindi tumatawag sa Meshy API.meshy_analyze_printability: suriin ang FDM printability ng isang model nang libre, kasama ang watertightness, volume, mga butas, non-manifold edges, at degenerate facesmeshy_process_multicolor: i-convert ang isang textured na model sa isang multi-color na 3MF file para sa pag-printmeshy_repair_printability: ayusin ang isang model para sa FDM printingmeshy_auto_split: hatiin ang isang model sa mga bahaging maaaring i-print nang hiwalay
Account
meshy_check_balance: suriin ang natitira mong creditsmeshy_list_usage: ilista ang mga tapos nang API task ng iyong team at ang credits na ginamit ng bawat isa, para sa mga Studio at Enterprise na team
Puwedeng magbago ang mga pangalan at behavior ng tool. Para sa kumpletong listahan, tingnan ang mga tool sa MCP server source.
Mga halimbawang prompt
Para magsimula, subukan ang mga prompt na ito sa iyong MCP-enabled na 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 at llms-full.txt
Kung hindi sinusuportahan ng iyong agent ang MCP, o gusto mong ilagay nang direkta ang mga dokumento ng Meshy sa isang prompt, i-point ito sa plain-text na bersyon ng mga dokumento:
llms.txt: isang compact na index na may mga tagubilin sa integration, gaya ng kung paano mag-poll ng async na mga task, authentication, rate limits, pagpili ng model, at mga karaniwang pagkakamali.llms-full.txt: bawat API page sa isang file, para mabasa ng isang agent ang mga dokumento sa isang request lamang.- Per-page na Markdown: magdagdag ng
.mdsa anumang endpoint URL, halimbawahttps://docs.meshy.ai/api/text-to-3d.md.
Binubuo muli ng Meshy ang tatlong ito tuwing mag-build ang docs site, para tumugma ang mga ito sa HTML docs.
FAQ
- Stateless ba ang MCP server?
- Hindi nito iniimbak ang iyong mga kredensyal. Pinapanatili ng server ang iyong MESHY_API_KEY sa memory at hindi ito kailanman isinusulat sa disk. Bilang default, sine-save nito ang mga model na dina-download, kasama ang kanilang metadata, sa isang meshy_output folder sa working directory nito. Para i-save ang isang download sa ibang lugar, bigyan ang download tool ng save_to path.
- Pareho ba ng gastos ang MCP sa REST API?
- Oo. Ang mga MCP tool call ay gumagawa ng parehong REST calls at gumagamit ng credits sa parehong rate. Tingnan ang Pricing page para sa bawat presyo.
- Ano ang mga rate limit?
- Ang mga tawag ng MCP server ay bumibilang sa parehong rate limits gaya ng iyong mga REST API call. Tingnan ang Rate limits page para sa mga limitasyon ng bawat plano.
- Anong data ng Meshy ang maa-access ng MCP server?
- Ang kaya lang i-access ng iyong MESHY_API_KEY sa pamamagitan ng REST API, na may parehong mga pahintulot.
- Paano ako mag-report ng mga isyu?
- Magbukas ng issue sa meshy-mcp-server repository sa GitHub: https://github.com/meshy-dev/meshy-mcp-server/issues