MCPサーバーはステートレスですか？

はい。MESHY_API_KEYはリクエストごとに使用され、サーバー側に保存されることはありません。

MCPはREST APIと同じ料金ですか？

はい — 各MCPツール呼び出しは単一のREST呼び出しにマッピングされ、同じレートでクレジットを消費します。料金ページで完全なマトリックスを確認してください。

レート制限は何ですか？

MCPサーバーはREST APIと同じレート制限プレーンを共有しています。レート制限ページで各ティアの制限を確認してください。

MCPはどのMeshyデータにアクセスできますか？

RESTを介してMESHY_API_KEYがアクセスできるもののみです。スコープと権限は同一です。

問題を報告するにはどうすればよいですか？

meshy-mcp-serverリポジトリで問題を報告してください: https://github.com/meshy-dev/meshy-mcp-server/issues

AI連携

MeshyはAIエージェントとコーディングアシスタントのために2つのチャネルを提供しています。ツール呼び出し用のMeshy MCPサーバーと、ドキュメント取り込み用のllms.txt / llms-full.txtです。

Claude Code、Cursor、Windsurf、Codex、または他のMCP互換ツールからMeshyを連携する場合は、以下の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.com/meshy-dev/meshy-mcp-serverで確認できます。

Meshy APIキーが必要です。https://www.meshy.ai/settings/apiで作成してください。MCPサーバーはMESHY_API_KEY環境変数から読み取ります。

クイックインストール

# 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

ドロップインスキルをお探しですか？ オープンソースのmeshy-3d-agentスキルパックは、Claude Code、Cursor、OpenClaw用に事前に書かれたMeshyワークフロー（生成→ポーリング→ダウンロード）を提供します。Meshy REST APIを直接呼び出しますので、MCPサーバーは不要です。

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

利用可能なツール

MCPサーバーは、Meshy REST APIを機能ごとにグループ化したツールとして公開しています。

3D生成

meshy_text_to_3d — テキストプロンプトから3Dモデルを作成
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_text_to_image — テキストから2D画像を生成
meshy_image_to_image — 参照画像から2D画像を生成

タスク管理

meshy_get_task_status — タスクのステータスとダウンロードURLを確認
meshy_list_tasks — 最近のタスクを一覧表示し、タイプ/ステータスでフィルタリング可能
meshy_cancel_task — 保留中または進行中のタスクをキャンセル
meshy_download_model — 完了したモデルファイルを取得し、ローカルに保存

ワークスペース

meshy_list_models — 認証済みユーザーのワークスペース内のすべてのモデルを一覧表示

3Dプリント

meshy_send_to_slicer — インストール済みのスライサーを検出し、モデルを起動（ローカルで実行; Meshy API呼び出しなし）
meshy_analyze_printability — 現在は手動のプリント準備チェックリストを返します（肉厚、オーバーハング、多様体メッシュなど）。Meshyプリント可能性APIが利用可能になり次第、自動分析にアップグレードされます。
meshy_process_multicolor — テクスチャ付きモデルをマルチカラー3MFファイルに変換し、プリント用に準備

アカウント

meshy_check_balance — 残りのクレジットを照会

ツール名と動作は進化する可能性があります。権威あるリストは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ドキュメントを直接プロンプトに取り込みたい場合は、以下のプレーンテキストサーフェスを指してください。

llms.txt — コンパクトなインデックス + 連携手順（正しい非同期ポーリングパターン、認証ルール、レート制限、モデル選択、一般的なミス）。
llms-full.txt — すべてのAPIページを1つのファイルに連結して、1回のフェッチで取り込み可能。
ページごとのMarkdown: 任意のエンドポイントURLに.mdを追加。例: https://docs.meshy.ai/api/text-to-3d.md。

これら3つは、ドキュメントサイトがビルドされるたびに再生成されるため、HTMLドキュメントからずれることはありません。

FAQ

MCPサーバーはステートレスですか？: はい。MESHY_API_KEYはリクエストごとに使用され、サーバー側に保存されることはありません。
MCPはREST APIと同じ料金ですか？: はい — 各MCPツール呼び出しは単一のREST呼び出しにマッピングされ、同じレートでクレジットを消費します。料金ページで完全なマトリックスを確認してください。
レート制限は何ですか？: MCPサーバーはREST APIと同じレート制限プレーンを共有しています。レート制限ページで各ティアの制限を確認してください。
MCPはどのMeshyデータにアクセスできますか？: RESTを介してMESHY_API_KEYがアクセスできるもののみです。スコープと権限は同一です。
問題を報告するにはどうすればよいですか？: meshy-mcp-serverリポジトリで問題を報告してください: https://github.com/meshy-dev/meshy-mcp-server/issues