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キーが必要です。Developer Platform 内の API Keysページ で作成してください。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ワークフロー（生成 → ポーリング → ダウンロード）が同梱されています。MCPサーバーを必要とせず、Meshy REST APIを直接呼び出します。

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

利用可能なツール

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

3D生成

  • meshy_text_to_3d — テキストのpromptから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のドキュメントを直接promptに取り込みたい場合は、以下のプレーンテキストの窓口を利用してください。

  • llms.txt — コンパクトな索引 + 連携方法の説明（正しい非同期ポーリングのパターン、認証ルール、レート制限、モデルの選び方、よくある間違い）。
  • llms-full.txt — すべてのAPIページを1つのファイルに連結したもので、一括取得に適しています。
  • ページ単位のMarkdown: 任意のエンドポイントURLの末尾に .md を付加します。例: https://docs.meshy.ai/api/text-to-3d.md。

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

よくある質問

MCPサーバーはステートレスですか？
はい。MESHY_API_KEYはリクエストごとに使用され、サーバー側で永続化されることはありません。
MCPのコストはREST APIと同じですか？
はい — すべてのMCPツール呼び出しは1回のREST呼び出しに対応し、まったく同じレートでクレジットを消費します。全体のマトリクスは料金ページをご覧ください。
レート制限はどうなっていますか？
MCPサーバーはREST APIと同じレート制限の枠組みを共有しています。ティアごとの制限についてはレート制限ページをご覧ください。
MCPはMeshyのどのデータにアクセスできますか？
MESHY_API_KEYがRESTを通じてアクセスできる範囲のみです。スコープと権限は同一です。
問題はどのように報告すればよいですか？
meshy-mcp-serverリポジトリでissueを作成してください: https://github.com/meshy-dev/meshy-mcp-server/issues