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 CLI | MCPサーバー | |
|---|---|---|
| 実行主体 | ターミナル上のあなた、スクリプト、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
Windowsでは、上記のJSON設定でcmd /cを介してサーバーを起動してください。"command"を"cmd"に、"args"を["/c", "npx", "-y", "@meshy-ai/meshy-mcp-server"]に設定します。PowerShellはクォートを取り除いてしまうため、PowerShellではJSONをコマンド引数として渡さないでください。
スキルの方がお好みですか? オープンソースのmeshy-3d-agentスキルパックには、モデルの生成、タスクの追跡、結果のダウンロードなど、すぐに使えるMeshyワークフローが用意されています。Claude Code、Cursor、Codex、OpenClaw、Hermes Agentで動作します。これらのスキルはMCPサーバーではなく、Meshy CLI上で実行されます。ブラウザで一度サインインするだけなので、APIキーは不要です。Node.js 22.12以降が必要です。CLIのセットアップについては、Meshy CLIを参照してください。
npx skills add meshy-dev/meshy-3d-agent
利用可能なツール
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サーバーのソースコード内のツールを参照してください。
プロンプトの例
まずは、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