Integracja z AI

Meshy udostępnia dwa kanały dla agentów AI i asystentów kodowania: MCP server Meshy do wywoływania narzędzi oraz llms.txt / llms-full.txt do pobierania dokumentacji.

Jeśli integrujesz Meshy z Claude Code, Cursor, Windsurf, Codex lub innym narzędziem kompatybilnym z MCP, zainstaluj poniższy MCP server. Jeśli integrujesz z prostym agentem czatu bez obsługi MCP, wskaż mu zamiast tego https://docs.meshy.ai/llms.txt.

Czym jest MCP

Model Context Protocol (MCP) to otwarty standard, który pozwala asystentom AI wywoływać zewnętrzne narzędzia i pobierać ustrukturyzowany kontekst. MCP server Meshy opakowuje Meshy API jako zestaw narzędzi, które Twój agent może wywoływać — wygenerować model, sprawdzić zadanie, pobrać wynik — bez ręcznego pisania kodu HTTP.

MCP server jest open source i opublikowany w npm jako @meshy-ai/meshy-mcp-server. Kod źródłowy: github.com/meshy-dev/meshy-mcp-server.

Potrzebujesz klucza API Meshy. Utwórz go na stronie kluczy API w Developer Platform. MCP server odczytuje go ze zmiennej środowiskowej MESHY_API_KEY.

Szybka instalacja

# 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

Wolisz gotowy pakiet umiejętności? Open-source'owy pakiet umiejętności meshy-3d-agent zawiera gotowe przepływy pracy Meshy (generowanie → odpytywanie → pobieranie) dla Claude Code, Cursor i OpenClaw. Wywołuje bezpośrednio Meshy REST API — bez potrzeby MCP server.

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

Dostępne narzędzia

MCP server udostępnia Meshy REST API jako narzędzia, pogrupowane według funkcjonalności.

Generowanie 3D

  • meshy_text_to_3d — utwórz model 3D na podstawie promptu tekstowego
  • meshy_image_to_3d — utwórz model 3D na podstawie jednego obrazu
  • meshy_multi_image_to_3d — utwórz model 3D na podstawie wielu obrazów tego samego obiektu
  • meshy_text_to_3d_refine — dodaj teksturę do siatki podglądowej

Przetwarzanie końcowe

  • meshy_remesh — zmień topology i/lub liczbę wielokątów istniejącego modelu
  • meshy_retexture — zastosuj nową teksturę do istniejącego modelu
  • meshy_rig — dodaj szkielet do humanoidalnej postaci 3D
  • meshy_animate — zastosuj animację do postaci z riggiem

Generowanie obrazów

  • meshy_text_to_image — obraz 2D na podstawie tekstu
  • meshy_image_to_image — obraz 2D na podstawie obrazu referencyjnego

Zarządzanie zadaniami

  • meshy_get_task_status — sprawdź status zadania i adresy URL do pobrania
  • meshy_list_tasks — wyświetl listę ostatnich zadań, opcjonalnie filtrowanych według typu/statusu
  • meshy_cancel_task — anuluj oczekujące lub trwające zadanie
  • meshy_download_model — pobierz plik ukończonego modelu i zapisz lokalnie

Obszar roboczy

  • meshy_list_models — wyświetl listę wszystkich modeli w obszarze roboczym uwierzytelnionego użytkownika

Druk 3D

  • meshy_send_to_slicer — wykryj zainstalowane slicery i uruchom w nich model (działa lokalnie na Twoim komputerze; bez wywołania Meshy API)
  • meshy_analyze_printability — obecnie zwraca ręczną listę kontrolną gotowości do druku (grubość ścianki, nawisy, rozmaitość siatki itd.). Zostanie zaktualizowane do automatycznej analizy, gdy dostępne będzie Meshy API do drukowalności.
  • meshy_process_multicolor — konwertuj teksturowany model na wielokolorowy plik 3MF do druku

Konto

  • meshy_check_balance — sprawdź pozostałe kredyty

Nazwy i zachowania narzędzi mogą ulec zmianie. Autorytatywna lista znajduje się w kodzie źródłowym MCP server.

Przykładowe prompty

Wklej je do swojego czatu z obsługą MCP jako punkt wyjścia.

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

Jeśli Twój agent nie obsługuje MCP lub chcesz bezpośrednio wczytać dokumentację Meshy do promptu, wskaż mu nasze zasoby w postaci zwykłego tekstu:

  • llms.txt — zwięzły indeks + instrukcje integracji (poprawny wzorzec asynchronicznego odpytywania, zasady uwierzytelniania, limity zapytań, wybór modelu, typowe błędy).
  • llms-full.txt — wszystkie strony API połączone w jeden plik do pobrania za jednym razem.
  • Markdown dla poszczególnych stron: dodaj .md do dowolnego adresu URL punktu końcowego. Przykład: https://docs.meshy.ai/api/text-to-3d.md.

Wszystkie trzy są regenerowane przy każdej kompilacji witryny dokumentacji, więc nigdy nie odbiegają od dokumentacji HTML.

FAQ

Czy MCP server jest bezstanowy?
Tak. Twój MESHY_API_KEY jest używany dla każdego żądania i nigdy nie jest przechowywany po stronie serwera.
Czy MCP kosztuje tyle samo co REST API?
Tak — każde wywołanie narzędzia MCP odpowiada pojedynczemu wywołaniu REST i zużywa kredyty dokładnie w tym samym tempie. Pełną matrycę cen znajdziesz na stronie Cennik.
Jakie są limity zapytań?
MCP server dzieli te same limity zapytań co REST API. Limity dla poszczególnych planów znajdziesz na stronie Limity zapytań.
Do jakich danych Meshy ma dostęp MCP?
Tylko do tych, do których dostęp ma MESHY_API_KEY przez REST. Zakresy i uprawnienia są identyczne.
Jak zgłosić problemy?
Zgłoś problem w repozytorium meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues