lowpoly zostanie wycofany 30 paź 2026. Zmień model przed tymi datami, aby uniknąć błędów żądań.

Integracja z AI

Meshy udostępnia dwa kanały dla agentów AI i asystentów programistycznych: 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 się z prostym agentem czatu bez obsługi MCP, skieruj go zamiast tego na https://docs.meshy.ai/llms.txt.

What is 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 REST API Meshy w 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 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 stronie kluczy API w Developer Platform. MCP server odczytuje go ze zmiennej środowiskowej MESHY_API_KEY.

Quick Install

# 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 zestaw umiejętności? Open-source'owy pakiet meshy-3d-agent zawiera gotowe przepływy pracy Meshy (generuj → sprawdzaj → pobierz) dla Claude Code, Cursor i OpenClaw. Wywołuje on bezpośrednio REST API Meshy — bez konieczności użycia MCP server.

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

Available Tools

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

Generowanie 3D

  • meshy_text_to_3d: tworzy niewyteksturowaną siatkę podglądu na podstawie promptu tekstowego
  • meshy_image_to_3d: tworzy model 3D z jednego obrazu
  • meshy_multi_image_to_3d: tworzy model 3D z wielu obrazów tego samego obiektu
  • meshy_text_to_3d_refine: dodaje teksturę do siatki podglądu

Przetwarzanie końcowe

  • meshy_remesh: zmienia topology i/lub liczbę wielokątów istniejącego modelu
  • meshy_retexture: nakłada nową teksturę na istniejący model
  • meshy_rig: dodaje szkielet do humanoidalnej postaci 3D
  • meshy_animate: nakłada animację na postać z rig
  • meshy_convert: konwertuje model do innego formatu pliku
  • meshy_resize: zmienia rozmiar modelu na rzeczywiste wymiary
  • meshy_uv_unwrap: generuje nowy układ UV dla modelu

Creative Lab

  • meshy_creative_lab: zamienia zdjęcie w gotowy produkt Creative Lab (uruchamia zadania prototypu i budowy)

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: sprawdza status zadania i adresy URL do pobrania
  • meshy_list_tasks: wyświetla listę ostatnich zadań, opcjonalnie filtrowaną według typu/statusu
  • meshy_cancel_task: usuwa zadanie. Zadanie PENDING jest usuwane i zwracane jest saldo; zadania IN_PROGRESS nie można anulować (API zwraca 409); ukończone zadanie zostaje usunięte.
  • meshy_download_model: pobiera ukończony plik modelu i zapisuje go lokalnie

Obszar roboczy

  • meshy_list_models: wyświetla listę ostatnich modeli Tekst na 3D (do innych typów zadań użyj meshy_list_tasks)

Druk 3D

  • meshy_send_to_slicer: wykrywa zainstalowane slicery i zwraca polecenie otwarcia modelu w jednym z nich (działa lokalnie; brak wywołania API Meshy)
  • meshy_analyze_printability: darmowe automatyczne sprawdzenie drukowalności FDM (szczelność, objętość, otwory, krawędzie non-manifold, zdegenerowane ściany)
  • meshy_process_multicolor: konwertuje wyteksturowany model na wielokolorowy plik 3MF do druku
  • meshy_repair_printability: naprawia model pod kątem druku FDM

Konto

  • meshy_check_balance: sprawdza pozostałe kredyty

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

Example Prompts

Wklej je do swojego czatu obsługującego 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 and llms-full.txt

Jeśli Twój agent nie obsługuje MCP lub chcesz wprowadzić dokumentację Meshy bezpośrednio do promptu, skieruj go na nasze zwykłe strony tekstowe:

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

Wszystkie trzy są regenerowane przy każdym budowaniu strony dokumentacji, więc nigdy nie rozmijają się z dokumentacją HTML.

FAQ

Is the MCP server stateless?
Yes. Your MESHY_API_KEY is used per request and never persisted on the server side.
Does MCP cost the same as the REST API?
Yes — every MCP tool call maps to a single REST call and consumes credits at the exact same rate. See the Pricing page for the full matrix.
What are the rate limits?
The MCP server shares the same rate-limit plane as the REST API. See the Rate Limits page for per-tier limits.
What Meshy data can the MCP access?
Only what the MESHY_API_KEY can access via REST. Scopes and permissions are identical.
How do I report issues?
File an issue at the meshy-mcp-server repository: https://github.com/meshy-dev/meshy-mcp-server/issues