Integrace AI

Meshy nabízí dva kanály pro AI agenty a kódovací asistenty: MCP server Meshy pro volání nástrojů (tool-calling) a llms.txt / llms-full.txt pro zpracování dokumentace.

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

Co je MCP

Model Context Protocol (MCP) je otevřený standard, který umožňuje AI asistentům volat externí nástroje a získávat strukturovaný kontext. MCP server Meshy zabaluje Meshy API jako sadu nástrojů, které může váš agent volat — 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. Zdrojový kód: github.com/meshy-dev/meshy-mcp-server.

Potřebujete API klíč Meshy. Vytvořte si jej na stránce API Keys v Developer Platform. MCP server jej 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 hotovou skill sadu? Open-source balíček dovedností meshy-3d-agent obsahuje předpřipravené pracovní postupy Meshy (generovat → dotazovat se na stav → stáhnout) pro Claude Code, Cursor a OpenClaw. Volá přímo Meshy API — MCP server není potřeba.

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

Dostupné nástroje

MCP server zpřístupňuje Meshy API jako nástroje, seskupené podle funkčnosti.

3D Generation

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

Post-Processing

  • meshy_remesh — změní topology a/nebo počet polygonů existujícího modelu
  • meshy_retexture — použije novou texturu na existující model
  • meshy_rig — přidá kostru 3D humanoidní postavě
  • meshy_animate — aplikuje animaci na postavu s kostrou

Image Generation

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

Task Management

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

Workspace

  • meshy_list_models — vypíše všechny modely v pracovním prostoru autentizovaného uživatele

3D Printing

  • meshy_send_to_slicer — rozpozná nainstalované slicery a spustí v nich model (běží lokálně na vašem počítači; bez volání Meshy API)
  • meshy_analyze_printability — momentálně vrací ruční kontrolní seznam připravenosti k tisku (tloušťka stěny, převisy, manifold síť atd.). Jakmile bude k dispozici API pro tisknutelnost Meshy, bude aktualizován na automatizovanou analýzu.
  • meshy_process_multicolor — převede texturovaný model na vícebarevný soubor 3MF pro tisk

Account

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

Názvy nástrojů a jejich chování se mohou měnit. Autoritativní seznam najdete ve zdrojovém kódu MCP serveru.

Příklady promptů

Vložte je do svého 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 and llms-full.txt

Pokud váš agent nepodporuje MCP, nebo chcete dokumentaci Meshy načíst přímo do promptu, nasměrujte jej na naše čistě textové zdroje:

  • llms.txt — kompaktní index + pokyny pro integraci (správný vzor asynchronního dotazování / polling, pravidla autentizace, rate limity, výběr modelu, časté chyby).
  • llms-full.txt — všechny stránky API spojené do jednoho souboru pro načtení jediným požadavkem.
  • Markdown pro jednotlivé stránky: přidejte .md na konec libovolné URL koncového bodu. Příklad: https://docs.meshy.ai/api/text-to-3d.md.

Všechny tři soubory se znovu generují při každém sestavení webu s dokumentací, takže se nikdy neliší od HTML dokumentace.

Časté dotazy

Je MCP server bezstavový?
Ano. Váš MESHY_API_KEY se používá pro jednotlivé požadavky a nikdy se neukládá na straně serveru.
Stojí MCP stejně jako REST API?
Ano — každé volání nástroje MCP odpovídá jednomu volání REST a spotřebovává kredity ve stejné sazbě. Úplnou matici najdete na stránce Ceny.
Jaké jsou rate limity?
MCP server sdílí stejnou úroveň rate limitů jako REST API. Limity podle jednotlivých úrovní najdete na stránce Rate Limits.
Ke kterým datům Meshy může MCP přistupovat?
Pouze k těm, ke kterým má přístup MESHY_API_KEY přes REST. Rozsahy a oprávnění jsou identická.
Jak mám nahlásit problémy?
Vytvořte issue v repozitáři meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues