AI連携

ツール呼び出しにはMeshy MCPサーバーを使い、ドキュメントの読み取りにはllms.txtとllms-full.txtを使って、AIエージェントやコーディングアシスタントをMeshyに接続できます。

Claude Code、Cursor、Windsurf、Codex、またはその他のMCPクライアントを使用している場合は、MCPサーバーをインストールしてください。お使いのチャットエージェントがMCPに対応していない場合は、代わりにhttps://docs.meshy.ai/llms.txtを指定してください。

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環境変数からこれを読み取ります。

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

サーバーをインストールするには、使用しているAIクライアントのタブを選択してください。msy_YOUR_API_KEYをあなたのAPIキーに置き換えてください。

# 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

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

利用可能なツール

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

3D生成

• meshy_text_to_3d：テキストprompterからテクスチャなしのプレビューメッシュを作成します
• 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：リグ済みキャラクターにアニメーションを適用します
• meshy_convert：モデルを別のファイル形式に変換します
• meshy_resize：モデルを実世界の寸法にリサイズします
• meshy_uv_unwrap：モデルの新しいUVレイアウトを生成します
• meshy_text_to_motion：テキストプロンプトからアニメーションを生成します
• meshy_list_animations：無料でプリセットアニメーションのアクションIDを調べます

Creative Lab

• meshy_creative_lab：写真を完成したCreative Lab製品に変換します（プロトタイプタスクとビルドタスクを実行します）

画像生成

• 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のドキュメントを直接プロンプトに組み込みたい場合は、ドキュメントのプレーンテキスト版を指定してください。

• 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