Integrace AI

Propojte AI agenty a kódovací asistenty s Meshy pomocí MCP serveru Meshy pro volání nástrojů, nebo pomocí llms.txt a llms-full.txt pro čtení dokumentace.

Pokud používáte Claude Code, Cursor, Windsurf, Codex nebo jiného MCP klienta, nainstalujte MCP server. Pokud váš chatovací agent MCP nepodporuje, 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 AI asistentům volat externí nástroje a získávat strukturovaný kontext. MCP server Meshy obaluje Meshy REST API jako nástroje, které může váš agent volat. Díky nim může agent vygenerovat model, zkontrolovat úlohu a stáhnout výsledek bez ručně psaného HTTP kódu.

MCP server je open source. Je publikován na npm jako @meshy-ai/meshy-mcp-server a jeho zdrojový kód je v repozitáři meshy-mcp-server na GitHubu.

Potřebujete API klíč Meshy. Vytvořte si ho na stránce API Keys na Developer Platform. MCP server ho načítá z proměnné prostředí MESHY_API_KEY.

Instalace MCP serveru

Pro instalaci serveru použijte záložku odpovídající vašemu AI klientovi. Nahraďte msy_YOUR_API_KEY svým API klíčem.

# 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 nabízí Meshy REST API ve formě následujících nástrojů, seskupených podle funkce.

3D generování

• 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í topology nebo počet polygonů existujícího modelu, nebo obojí
• meshy_retexture: aplikuje novou texturu na existující model
• meshy_rig: přidá kostru 3D humanoidní postavě
• meshy_animate: aplikuje animaci na riggovanou postavu
• 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
• meshy_text_to_motion: vygeneruje animaci z textového promptu
• meshy_list_animations: zdarma vyhledá ID předpřipravených animačních akcí

Creative Lab

• meshy_creative_lab: promění fotografii v hotový produkt Creative Lab (spustí úlohy prototype a build)

Generování obrázků

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

Správa úloh

• meshy_get_task_status: zkontroluje stav úlohy a adresy URL ke stažení
• meshy_list_tasks: vypíše nedávné úlohy, volitelně filtrované podle typu nebo stavu
• meshy_cancel_task: smaže úlohu. Meshy odstraní a vrátí kredity za úlohu ve stavu PENDING a smaže dokončenou úlohu. Úlohu ve stavu IN_PROGRESS nelze zrušit a API vrátí 409.
• meshy_download_model: stáhne hotový soubor modelu a uloží ho 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: najde slicery nainstalované na vašem počítači a vrátí příkaz, který v jednom z nich model otevře. Běží lokálně a nevolá Meshy API.
• meshy_analyze_printability: zdarma zkontroluje tisknutelnost modelu pro FDM, včetně vodotěsnosti, objemu, otvorů, non-manifold hran a degenerovaných ploch
• meshy_process_multicolor: převede texturovaný model na vícebarevný soubor 3MF určený k tisku
• meshy_repair_printability: opraví model pro FDM tisk
• meshy_auto_split: rozdělí model na samostatně tisknutelné části

Účet

• meshy_check_balance: zkontroluje vaše zbývající kredity
• meshy_list_usage: vypíše dokončené API úlohy vašeho týmu a kredity, které každá z nich spotřebovala, pro týmy Studio a Enterprise

Ukázkové prompty

Pro začátek vyzkoušejte tyto prompty ve svém chatu s podporou MCP:

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 vložit dokumentaci Meshy přímo do promptu, nasměrujte ho na čistě textové verze dokumentace:

• llms.txt: kompaktní index s instrukcemi pro integraci, například jak dotazovat asynchronní úlohy, autentizace, limity rychlosti, výběr modelu a časté chyby.
• llms-full.txt: všechny stránky API v jediném souboru, takže agent může přečíst dokumentaci na jeden požadavek.
• Markdown pro jednotlivé stránky: přidejte .md k libovolné URL koncového bodu, například https://docs.meshy.ai/api/text-to-3d.md.

Meshy všechny tři soubory znovu generuje při každém sestavení webu s dokumentací, takže vždy odpovídají HTML dokumentaci.

FAQ

Je MCP server bezstavový?

Neukládá vaše přihlašovací údaje. Server uchovává váš MESHY_API_KEY pouze v paměti a nikdy ho nezapisuje na disk. Ve výchozím nastavení ukládá stažené modely spolu s jejich metadaty do složky meshy_output ve svém pracovním adresáři. Chcete-li uložit stažený soubor jinam, zadejte nástroji pro stahování cestu save_to.

Stojí MCP stejně jako REST API?

Ano. Volání nástrojů MCP provádějí stejná volání REST a spotřebovávají kredity stejnou sazbou. Všechny ceny najdete na stránce Ceny.

Jaké jsou limity rychlosti?

Volání MCP serveru se počítají do stejných limitů rychlosti jako vaše volání REST API. Limity jednotlivých plánů najdete na stránce Rate limits.

Ke kterým datům Meshy má MCP server přístup?

Pouze k těm, ke kterým má přístup váš MESHY_API_KEY přes REST API, se stejnými oprávněními.

Jak mám nahlásit problém?

Otevřete issue v repozitáři meshy-mcp-server na GitHubu: https://github.com/meshy-dev/meshy-mcp-server/issues