AI Integration

Naglalantad 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 dokumentasyon.

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 mula sa isang plain chat agent na walang suporta sa MCP, ituro 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 tawagin ang mga external na tool at kumuha ng structured context. Binabalot ng Meshy MCP server ang Meshy REST API bilang isang set ng mga tool na maaaring i-invoke ng iyong agent — gumawa ng model, suriin ang isang task, i-download ang resulta — nang hindi na kailangang magsulat ng HTTP code nang manu-mano.

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

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

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

Mga Available na Tool

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

Paggawa ng 3D

• meshy_text_to_3d: gumawa ng untextured na preview mesh 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 parehong 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: mag-apply ng bagong texture sa isang umiiral na model
• meshy_rig: magdagdag ng skeleton sa isang 3D humanoid na karakter
• meshy_animate: mag-apply ng animation sa isang na-rig na karakter
• meshy_convert: i-convert ang isang model sa ibang file format
• meshy_resize: i-resize ang isang model sa aktwal na mga sukat sa totoong mundo
• meshy_uv_unwrap: bumuo ng bagong UV layout para sa isang model

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: 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 na-filter ayon sa type/status
• meshy_cancel_task: burahin ang isang task. Ang isang PENDING na task ay tinatanggal at nire-refund; ang isang IN_PROGRESS na task ay hindi maaaring kanselahin (ibinabalik ng API ang 409); ang isang tapos na task ay binubura.
• meshy_download_model: kunin ang isang kumpletong file ng model at i-save nang lokal

Workspace

• meshy_list_models: ilista ang iyong mga kamakailang Text to 3D na model (gamitin ang meshy_list_tasks para sa ibang uri ng task)

3D Printing

• meshy_send_to_slicer: tuklasin ang mga naka-install na slicer at magbalik ng command para buksan ang model sa isa sa mga ito (tumatakbo nang lokal; walang Meshy API call)
• meshy_analyze_printability: libreng awtomatikong pagsusuri ng FDM printability (watertightness, volume, mga butas, non-manifold edges, degenerate faces)
• meshy_process_multicolor: i-convert ang isang textured na model sa isang multi-color na 3MF file para sa pag-print
• meshy_repair_printability: ayusin ang isang model para sa FDM printing

Account

• meshy_check_balance: tanungin ang natitirang credits

Mga Halimbawang Prompt

I-drop 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 integration (ang tamang async-polling pattern, mga patakaran sa auth, rate limits, pagpili ng model, karaniwang mga pagkakamali).
• llms-full.txt — lahat ng API page na pinagsama-sama sa isang file para sa single-fetch na pag-ingest.
• Per-page Markdown: idagdag ang .md sa anumang endpoint URL. Halimbawa: https://docs.meshy.ai/api/text-to-3d.md.

Ang lahat ng tatlo ay binubuo muli tuwing nagbi-build ang docs site, kaya hindi ito nagiging hindi magkasabay sa mga HTML docs.

FAQ

Stateless ba ang MCP server?

Oo. Ginagamit ang iyong MESHY_API_KEY sa bawat request at hindi kailanman pino-persist sa server side.

Pareho ba ang gastos ng MCP at ng REST API?

Oo — ang bawat MCP tool call ay tumutugma sa iisang REST call at gumagamit ng credits sa eksaktong parehong rate. Tingnan ang Pricing page para sa buong matrix.

Ano ang mga rate limit?

Nakikibahagi ang MCP server sa parehong rate-limit plane ng REST API. Tingnan ang Rate Limits page para sa mga limitasyon kada tier.

Anong data ng Meshy ang maaaring ma-access ng MCP?

Yaon lamang na maaaring ma-access ng MESHY_API_KEY sa pamamagitan ng REST. Magkapareho ang mga scope at permission.

Paano ako mag-report ng mga isyu?

Mag-file ng isyu sa meshy-mcp-server repository: https://github.com/meshy-dev/meshy-mcp-server/issues