Integrace AI

Meshy nabízí dva kanály pro AI agenty a asistenty pro psaní kódu: MCP server Meshy 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 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 obaluje Meshy REST API do sady nástrojů, které může váš agent volat — vygenerovat model, zkontrolovat úlohu, 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. Zdrojový kód: github.com/meshy-dev/meshy-mcp-server.

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

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

Dostupné nástroje

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

Generování 3D

• meshy_text_to_3d: vytvoří netexturovanou náhledovou síť 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ů téhož objektu
• meshy_text_to_3d_refine: přidá texturu k náhledové síti

Následné zpracování

• meshy_remesh: změní topologii a/nebo počet polygonů existujícího modelu
• meshy_retexture: aplikuje novou texturu na existující model
• meshy_rig: přidá kostru 3D humanoidní postavě
• meshy_animate: aplikuje animaci na postavu s kostrou
• meshy_convert: převede model do jiného formátu souboru
• meshy_resize: změní velikost modelu na reálné rozměry
• meshy_uv_unwrap: vygeneruje nové UV rozvržení pro model

Creative Lab

• meshy_creative_lab: přemění fotografii na hotový produkt Creative Lab (spustí úlohy prototype a build)

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: kontrola stavu úlohy a adres URL pro stažení
• meshy_list_tasks: seznam nedávných úloh, volitelně filtrovaný podle typu/stavu
• meshy_cancel_task: smaže úlohu. Úloha ve stavu PENDING je odstraněna a kredity jsou vráceny; úlohu ve stavu IN_PROGRESS nelze zrušit (API vrátí 409); dokončená úloha je smazána.
• meshy_download_model: stáhne dokončený soubor modelu a uloží jej lokálně

Pracovní prostor

• meshy_list_models: vypíše vaše nedávné modely Text na 3D (pro ostatní typy úloh použijte meshy_list_tasks)

3D tisk

• meshy_send_to_slicer: detekuje nainstalované slicery a vrátí příkaz pro otevření modelu v jednom z nich (spouští se lokálně; nevolá Meshy API)
• meshy_analyze_printability: bezplatná automatizovaná kontrola tisknutelnosti pro FDM (vodotěsnost, objem, díry, non-manifold hrany, degenerované plochy)
• meshy_process_multicolor: převede texturovaný model na vícebarevný soubor 3MF pro tisk
• meshy_repair_printability: opraví model pro FDM tisk

Účet

• meshy_check_balance: zjistí zbývající kredity

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 a 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í, pravidla autentizace, limity rychlosti, výběr modelu, časté chyby).
• llms-full.txt — všechny stránky API spojené do jednoho souboru pro jednorázové načtení.
• Markdown pro jednotlivé stránky: připojte .md k libovolné URL koncového bodu. Příklad: https://docs.meshy.ai/api/text-to-3d.md.

Všechny tři jsou znovu generovány při každém sestavení webu s dokumentací, 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 není uchováván 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 přesně stejnou sazbou. Úplný přehled najdete na stránce Ceny.

Jaké jsou limity rychlosti?

MCP server sdílí stejnou úroveň limitů rychlosti jako REST API. Limity podle jednotlivých úrovní najdete na stránce Rate Limits.

K jakým datům Meshy má MCP přístup?

Pouze k těm, ke kterým má přístup MESHY_API_KEY přes REST. Rozsahy a oprávnění jsou totožné.

Jak mám nahlásit problém?

Založte issue v repozitáři meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues