Integracja z AI

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

Jeśli integrujesz Meshy z Claude Code, Cursor, Windsurf, Codex lub innym narzędziem zgodnym z MCP, zainstaluj poniżej MCP server. Jeśli integrujesz z prostym agentem czatu bez wsparcia MCP, skieruj go na https://docs.meshy.cn/llms.txt.

Co to jest MCP

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

MCP server jest open source i opublikowany na npm jako @meshy-ai/meshy-mcp-server. Źródło: github.com/meshy-dev/meshy-mcp-server.

Potrzebujesz klucza API Meshy. Utwórz go na https://www.meshy.ai/settings/api. MCP server odczytuje go z 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

Preferujesz gotową umiejętność? Otwartoźródłowy pakiet umiejętności meshy-3d-agent zawiera gotowe przepływy pracy Meshy (generowanie → sprawdzanie → pobieranie) dla Claude Code, Cursor i OpenClaw. Wywołuje bezpośrednio Meshy REST API — nie wymaga 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 możliwości.

Generowanie 3D

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

Post-processing

  • 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 postaci humanoidalnej 3D
  • meshy_animate — zastosuj animację do postaci z szkieletu

Generowanie obrazów

  • meshy_text_to_image — obraz 2D z tekstu
  • meshy_image_to_image — obraz 2D z obrazu referencyjnego

Zarządzanie zadaniami

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

Obszar roboczy

  • meshy_list_models — wyświetl wszystkie modele w obszarze roboczym uwierzytelnionego użytkownika

Druk 3D

  • meshy_send_to_slicer — wykryj zainstalowane slicery i uruchom model w jednym z nich (działa lokalnie na twoim komputerze; nie wymaga wywołania Meshy API)
  • meshy_analyze_printability — obecnie zwraca ręczną listę kontrolną gotowości do druku (grubość ścianki, nawisy, rozmaitość siatki, itp.). Zostanie zaktualizowane do automatycznej analizy, gdy tylko Meshy printability API będzie dostępne.
  • meshy_process_multicolor — konwertuj model z teksturą na plik 3MF w wielu kolorach do druku

Konto

  • meshy_check_balance — sprawdź pozostałe kredyty

Nazwy narzędzi i ich zachowania mogą się zmieniać. Autorytatywna lista znajduje się w źródle MCP server.

Przykładowe prompty

Wrzuć 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, skieruj go na nasze powierzchnie tekstowe:

  • llms.txt — kompaktowy indeks + instrukcje integracji (poprawny wzorzec asynchronicznego sprawdzania, zasady autoryzacji, limity szybkości, wybór modelu, typowe błędy).
  • llms-full.txt — każda strona API połączona w jeden plik do jednorazowego wczytania.
  • Markdown na stronę: dodaj .md do dowolnego URL-a endpointu. Przykład: https://docs.meshy.cn/api/text-to-3d.md.

Wszystkie trzy są regenerowane za każdym razem, gdy strona dokumentacji jest budowana, więc nigdy nie odbiegają od dokumentacji HTML.

FAQ

Czy MCP server jest bezstanowy?
Tak. Twój MESHY_API_KEY jest używany na żądanie 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 w dokładnie tym samym tempie. Zobacz stronę Cennik dla pełnej matrycy.
Jakie są limity szybkości?
MCP server dzieli tę samą płaszczyznę limitów szybkości co REST API. Zobacz stronę Limity szybkości dla limitów na poziomie.
Do jakich danych Meshy ma dostęp MCP?
Tylko do tych, do których MESHY_API_KEY ma dostęp 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