Integrace AI

Meshy poskytuje dva kanály pro agenty AI a asistenty pro programování: Meshy MCP server pro volání nástrojů a llms.txt / llms-full.txt pro ingestaci dokumentace.

Pokud integrujete Meshy z Claude Code, Cursor, Windsurf, Codex nebo jakéhokoli jiného nástroje kompatibilního s MCP, nainstalujte níže uvedený MCP server. Pokud integrujete z běžného chatovacího agenta bez podpory MCP, nasměrujte ho místo toho na https://docs.meshy.ai/llms.txt.

Co je MCP

Model Context Protocol (MCP) je otevřený standard, který umožňuje asistentům AI volat externí nástroje a načítat strukturovaný kontext. Meshy MCP server obaluje Meshy REST API jako sadu nástrojů, které může váš agent vyvolat — vygenerovat model, zkontrolovat úlohu, stáhnout výsledek — bez ručního psaní HTTP kódu.

MCP server je open source a je publikován na npm jako @meshy-ai/meshy-mcp-server. Zdroj: github.com/meshy-dev/meshy-mcp-server.

Potřebujete Meshy API klíč. Vytvořte si ho na https://www.meshy.ai/settings/api. MCP server ho načítá z proměnné prostředí MESHY_API_KEY.

Rychlá instalace

# 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

Preferujete raději hotový skill? Open-source balíček skillů meshy-3d-agent obsahuje předpřipravené pracovní postupy Meshy (generovat → dotazovat → stáhnout) pro Claude Code, Cursor a OpenClaw. Volá Meshy REST API přímo — MCP server není vyžadován.

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

Dostupné nástroje

MCP server zpřístupňuje Meshy REST API jako nástroje seskupené podle schopností.

Generování 3D

  • meshy_text_to_3d — vytvořit 3D model z textového promptu
  • meshy_image_to_3d — vytvořit 3D model z jednoho obrázku
  • meshy_multi_image_to_3d — vytvořit 3D model z více obrázků stejného objektu
  • meshy_text_to_3d_refine — přidat texturu k náhledové síti

Post-processing

  • meshy_remesh — změnit topology a/nebo počet polygonů existujícího modelu
  • meshy_retexture — aplikovat novou texturu na existující model
  • meshy_rig — přidat kostru 3D humanoidní postavě
  • meshy_animate — aplikovat animaci na postavu s rigem

Generování obrázků

  • meshy_text_to_image — 2D obrázek z textu
  • meshy_image_to_image — 2D obrázek z referenčního obrázku

Správa úloh

  • meshy_get_task_status — zkontrolovat stav úlohy a URL ke stažení
  • meshy_list_tasks — vypsat nedávné úlohy, volitelně filtrované podle typu/stavu
  • meshy_cancel_task — zrušit čekající nebo probíhající úlohu
  • meshy_download_model — načíst dokončený soubor modelu a uložit ho lokálně

Pracovní prostor

  • meshy_list_models — vypsat všechny modely v pracovním prostoru ověřeného uživatele

3D tisk

  • meshy_send_to_slicer — detekovat nainstalované slicery a spustit model v jednom z nich (běží lokálně na vašem počítači; bez volání Meshy API)
  • meshy_analyze_printability — aktuálně vrací ruční kontrolní seznam připravenosti k tisku (tloušťka stěny, převisy, manifold síť atd.). Bude upgradováno na automatizovanou analýzu, jakmile bude k dispozici Meshy printability API.
  • meshy_process_multicolor — převést model s texturou na vícebarevný soubor 3MF pro tisk

Účet

  • meshy_check_balance — dotázat se na zbývající kredity

Názvy a chování nástrojů se mohou vyvíjet. Autoritativní seznam se nachází ve zdrojovém kódu MCP serveru.

Ukázkové prompty

Vložte je do chatu s podporou MCP jako výchozí bod.

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

Pokud váš agent nepodporuje MCP nebo chcete dokumentaci Meshy ingestovat přímo do promptu, nasměrujte ho na naše prosté textové výstupy:

  • llms.txt — kompaktní index + pokyny k integraci (správný vzor asynchronního dotazování, pravidla ověřování, limity rychlosti, volba modelu, běžné chyby).
  • llms-full.txt — každá stránka API sloučená do jednoho souboru pro ingestaci jedním načtením.
  • Markdown pro jednotlivé stránky: připojte .md k URL libovolného koncového bodu. Příklad: https://docs.meshy.ai/api/text-to-3d.md.

Všechny tři se znovu generují pokaždé, když se web dokumentace sestaví, takže se nikdy neodchýlí od HTML dokumentace.

FAQ

Je MCP server bezstavový?
Ano. Váš MESHY_API_KEY se používá pro každý požadavek a nikdy se neukládá na straně serveru.
Stojí MCP stejně jako REST API?
Ano — každé volání nástroje MCP se mapuje na jedno volání REST a spotřebovává kredity přesně stejnou sazbou. Úplnou matici najdete na stránce Ceny.
Jaké jsou limity rychlosti?
MCP server sdílí stejnou rovinu limitů rychlosti jako REST API. Limity pro jednotlivé úrovně najdete na stránce Limity rychlosti.
K jakým datům Meshy má MCP přístup?
Pouze k tomu, k čemu má MESHY_API_KEY přístup přes REST. Rozsahy a oprávnění jsou identické.
Jak nahlásím problémy?
Založte issue v repozitáři meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues