lowpoly は 2026/10/30 に廃止されます。 3D 生成モデルとしての meshy-7 は 2026/12/31 に廃止されます。テクスチャモデルとしては引き続き利用できます。 リクエストエラーを避けるため、これらの日付までにモデルを切り替えてください。 非推奨の一覧を見る

AI連携

Meshy CLIやMeshy MCPサーバーを使ってAIエージェントやコーディングアシスタントをMeshyに接続し、モデルを生成しましょう。ドキュメントを読み込ませるにはllms.txtとllms-full.txtを利用できます。

エージェントがClaude Code、Cursor、Codexのようにシェルコマンドを実行できる場合は、CLIまたはMCPサーバーを使ってください。MCP経由でのみツールに接続できる場合は、MCPサーバーをインストールしてください。チャットエージェントがどちらにも対応していない場合は、https://docs.meshy.ai/llms.txtを指定してください。


CLIまたはMCP

どちらも同じMeshy REST APIを同じ価格で呼び出します。違いは、誰が実行するか、そしてどのようにサインインするかです。

Meshy CLIMCPサーバー
実行主体ターミナル上のあなた、スクリプト、CI、シェルコマンドを実行できるエージェントMCP経由でツールに接続するAIアプリ
サインインブラウザで一度だけ。APIキーはCI向けに任意で使用可能。クライアントの設定内のAPIキー
インストールnpm install -g meshy-cliクライアントごとに1つのコマンドまたは設定項目(下記参照)
最適な用途スクリプト、バッチジョブ、CI、ダウンロード、3Dプリント準備Claude Desktopなど、シェルコマンドを実行できないチャットアプリでのチャット形式の利用

CLIを使い始めるには、Meshy CLIを参照してください。このページの残りの部分では、MCPサーバーについて説明します。


MCPとは

モデルコンテキストプロトコル(MCP)は、AIアシスタントが外部ツールを呼び出し、構造化されたコンテキストを取得できるようにするオープンスタンダードです。Meshy MCPサーバーは、Meshy REST APIをエージェントが呼び出せるツールとしてラップします。これにより、エージェントは手書きのHTTPコードを書くことなく、モデルを生成し、タスクを確認し、結果をダウンロードできます。

MCPサーバーはオープンソースです。npmに@meshy-ai/meshy-mcp-serverとして公開されており、ソースコードはGitHubのmeshy-mcp-serverリポジトリにあります。

Meshy APIキーが必要です。Developer PlatformのAPIキーページで作成してください。MCPサーバーは、MESHY_API_KEY環境変数からAPIキーを読み取ります。


MCPサーバーのインストール

サーバーをインストールするには、使用しているAIクライアントのタブを選択してください。msy_YOUR_API_KEYをご自身のAPIキーに置き換えてください。各セットアップでは、キーはプロジェクトの外側にあるユーザーレベルの設定に保存されるため、リポジトリに含まれることはありません。

# macOS / Linux / WSL
claude mcp add -s user meshy --env MESHY_API_KEY=msy_YOUR_API_KEY -- npx -y @meshy-ai/meshy-mcp-server

# Windows (PowerShell or Command Prompt)
claude mcp add -s user meshy --env MESHY_API_KEY=msy_YOUR_API_KEY "--" cmd /c npx -y @meshy-ai/meshy-mcp-server

利用可能なツール

MCPサーバーは、Meshy REST APIを以下のツールとして機能別にグループ化して提供します。

3D生成

  • meshy_text_to_3d: テキストprompt からテクスチャなしのプレビューメッシュを作成
  • meshy_image_to_3d: 1枚の画像から3Dモデルを作成
  • meshy_multi_image_to_3d: 同一オブジェクトの複数画像から3Dモデルを作成
  • meshy_text_to_3d_refine: プレビューメッシュにテクスチャを追加

後処理

  • meshy_remesh: 既存モデルのtopologyやポリゴン数、あるいはその両方を変更
  • meshy_retexture: 既存モデルに新しいテクスチャを適用
  • meshy_rig: 3Dヒューマノイドキャラクターにスケルトンを追加
  • meshy_animate: rig済みキャラクターにアニメーションを適用
  • meshy_convert: モデルを別のファイル形式に変換
  • meshy_resize: モデルを実寸サイズにリサイズ
  • meshy_uv_unwrap: モデルの新しいUVレイアウトを生成
  • meshy_text_to_motion: テキストprompt からアニメーションを生成
  • meshy_list_animations: プリセットアニメーションアクションIDを無料で確認

Creative Lab

  • meshy_creative_lab: 写真を完成したCreative Lab製品に変換(prototypeタスクとbuildタスクを実行)

画像生成

  • meshy_text_to_image: テキストから2D画像を作成
  • meshy_image_to_image: 参照画像から2D画像を作成

タスク管理

  • meshy_get_task_status: タスクのステータスとダウンロードURLを確認
  • meshy_list_tasks: 種類やステータスで絞り込んで最近のタスクを一覧表示
  • meshy_cancel_task: タスクを削除します。MeshyはPENDING状態のタスクを削除して返金し、完了したタスクを削除します。IN_PROGRESS状態のタスクはキャンセルできず、APIは409を返します。
  • meshy_download_model: 完了したモデルファイルをダウンロードしてローカルに保存

ワークスペース

  • meshy_list_models: 最近のテキストから3Dモデルを一覧表示します。その他のタスクタイプについてはmeshy_list_tasksを使用してください。

3Dプリント

  • meshy_send_to_slicer: コンピューターにインストールされているスライサーを検索し、そのいずれかでモデルを開くコマンドを返します。これはローカルで実行され、Meshy APIを呼び出しません。
  • meshy_analyze_printability: 水密性、体積、穴、非多様体の辺、縮退面を含め、モデルのFDMプリント可能性を無料でチェック
  • meshy_process_multicolor: テクスチャ付きモデルをプリント用のマルチカラー3MFファイルに変換
  • meshy_repair_printability: FDMプリント用にモデルを修復
  • meshy_auto_split: モデルを個別にプリント可能なパーツに分割

アカウント

  • meshy_check_balance: 残りのクレジットを確認
  • meshy_list_usage: StudioおよびEnterpriseチーム向けに、チームが完了させたAPIタスクと、それぞれで使用したクレジットを一覧表示

プロンプトの例

まずは、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とllms-full.txt

エージェントがMCPに対応していない場合や、Meshyのドキュメントを直接promptに組み込みたい場合は、ドキュメントのプレーンテキスト版を指定してください。

  • llms.txt: 非同期タスクのポーリング方法、認証、レート制限、モデルの選び方、よくある間違いなど、連携のための指示をまとめたコンパクトな索引です。
  • llms-full.txt: すべてのAPIページを1つのファイルにまとめたもので、エージェントは1回のリクエストでドキュメントを読み込めます。
  • ページ単位のMarkdown: 任意のエンドポイントURLに.mdを追加します。例: https://docs.meshy.ai/api/text-to-3d.md。

Meshyはドキュメントサイトをビルドするたびにこの3つすべてを再生成するため、HTMLドキュメントと内容が一致しています。


FAQ

MCPサーバーはステートレスですか?
認証情報は保存されません。サーバーはMESHY_API_KEYをメモリ内に保持し、ディスクに書き込むことはありません。デフォルトでは、ダウンロードしたモデルをそのメタデータとともに、作業ディレクトリ内のmeshy_outputフォルダに保存します。別の場所にダウンロードを保存するには、ダウンロードツールにsave_toパスを指定してください。
MCPの料金はREST APIと同じですか?
はい。MCPツール呼び出しは同じREST API呼び出しを行い、同じレートでクレジットを使用します。すべての料金については料金ページを参照してください。
レート制限はどうなっていますか?
MCPサーバーの呼び出しは、REST API呼び出しと同じレート制限にカウントされます。各プランの制限についてはレート制限ページを参照してください。
MCPサーバーはMeshyのどのデータにアクセスできますか?
MESHY_API_KEYがREST API経由でアクセスできる範囲のデータのみ、同じ権限でアクセス可能です。
問題はどのように報告すればよいですか?
GitHub上のmeshy-mcp-serverリポジトリでissueを作成してください: https://github.com/meshy-dev/meshy-mcp-server/issues