AI 連携

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

Claude Code、Cursor、Windsurf、Codex、またはその他の MCP 互換ツールから Meshy を連携する場合は、以下の MCP サーバーをインストールしてください。MCP に対応していない通常のチャットエージェントから連携する場合は、代わりに https://docs.meshy.ai/llms.txt を参照させてください。

MCPとは

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

MCP サーバーはオープンソースで、npm では @meshy-ai/meshy-mcp-server として公開されています。ソース: github.com/meshy-dev/meshy-mcp-server。

Meshy API key が必要です。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 — 既存モデルのトポロジーやポリゴン数を変更
  • 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 — 1 回の取得で取り込めるよう、すべての API ページを 1 つのファイルに連結したもの。
  • ページごとの Markdown: 任意の endpoint URL に .md を追加します。例: https://docs.meshy.ai/api/text-to-3d.md。

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

FAQ

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

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

MCP のコストは REST API と同じですか？

はい — すべての MCP ツール呼び出しは 1 回の REST 呼び出しに対応し、まったく同じレートでクレジットを消費します。完全な一覧は Pricing を参照してください。

レート制限はどのようになっていますか？

MCP サーバーは REST API と同じレート制限の仕組みを共有しています。階層ごとの制限については Rate Limits を参照してください。

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

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

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

github.com/meshy-dev/meshy-mcp-server で issue を作成してください。