Integrace AI

Meshy poskytuje dva kanály pro AI agenty a asistenty pro kódování: Meshy MCP server pro volání nástrojů 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 níže uvedený MCP server. Pokud integrujete z běžného chatovacího agenta bez podpory MCP, nasměrujte ho na https://docs.meshy.cn/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. Meshy MCP server obaluje Meshy REST API jako sadu nástrojů, které váš agent může vyvolat — generovat model, zkontrolovat úkol, stáhnout výsledek — bez nutnosti ručně psát HTTP kód.

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 čte 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 dovednost? Open-source balíček dovedností meshy-3d-agent obsahuje předem napsané pracovní postupy Meshy (generovat → dotazovat → stáhnout) pro Claude Code, Cursor a OpenClaw. Volá přímo Meshy REST API — není potřeba MCP server.

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

Dostupné nástroje

MCP server vystavuje Meshy REST API jako nástroje, seskupené podle schopností.

3D Generace

  • 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 topologii a/nebo počet polygonů existujícího modelu
  • meshy_retexture — aplikovat novou texturu na existující model
  • meshy_rig — přidat kostru k 3D humanoidní postavě
  • meshy_animate — aplikovat animaci na postavu s kostrou

Generace 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 úkolů

  • meshy_get_task_status — zkontrolovat stav úkolu a URL ke stažení
  • meshy_list_tasks — vypsat nedávné úkoly, volitelně filtrované podle typu/stavu
  • meshy_cancel_task — zrušit čekající nebo probíhající úkol
  • meshy_download_model — stáhnout dokončený modelový soubor a uložit 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; žádné volání Meshy API)
  • meshy_analyze_printability — aktuálně vrací manuální kontrolní seznam připravenosti k tisku (tloušťka stěny, převisy, manifold síť, atd.). Bude upgradováno na automatizovanou analýzu, jakmile bude dostupné Meshy tisknutelnost API.
  • meshy_process_multicolor — převést texturovaný model do vícebarevného 3MF souboru pro tisk

Účet

  • meshy_check_balance — dotaz na zbývající kredity

Názvy nástrojů a jejich chování se mohou vyvíjet. Autoritativní seznam je k dispozici ve zdroji MCP serveru.

Příklady promptů

Vložte tyto příklady do vašeho MCP-podporovaného chatu 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 přímo zpracovat dokumentaci Meshy do promptu, nasměrujte ho na naše textové povrchy:

  • llms.txt — kompaktní index + instrukce pro integraci (správný asynchronní vzor dotazování, pravidla autentizace, limity rychlosti, výběr modelu, běžné chyby).
  • llms-full.txt — každá stránka API sloučená do jednoho souboru pro jednorázové zpracování.
  • Markdown po stránkách: přidejte .md k jakékoli URL koncového bodu. Příklad: https://docs.meshy.cn/api/text-to-3d.md.

Všechny tři jsou regenerovány pokaždé, když se sestavuje dokumentační web, takže nikdy neodchylují od HTML dokumentace.

FAQ

Je MCP server bezstavový?
Ano. Váš MESHY_API_KEY je používán na každou žádost a nikdy není uchováván na straně serveru.
Stojí MCP stejně jako REST API?
Ano — každé volání nástroje MCP odpovídá jednomu REST volání a spotřebovává kredity stejnou rychlostí. Podívejte se na stránku Ceny pro úplnou matici.
Jaké jsou limity rychlosti?
MCP server sdílí stejnou rovinu limitů rychlosti jako REST API. Podívejte se na stránku Limity rychlosti pro limity na úrovni.
Jaká data Meshy může MCP přistupovat?
Pouze ta, ke kterým má MESHY_API_KEY přístup přes REST. Rozsahy a oprávnění jsou identické.
Jak nahlásím problémy?
Podání problému v repozitáři meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues