Quady3D MCP

Quady3D MCP 0.1.2

公式セットアップ · API ドキュメント · モデル · ソース

Quady3D AI による公式のローカル MCP サーバーです。Node.js 22+ が必要です。テキストまたは選択した画像 1 枚から 3D アセットを作成し、元のタスクを再開して、許可されたプロジェクトフォルダー内にファイルを保存できます。クライアントは MIT ライセンスですが、クラウドの利用には Quady3D アカウント、クレジット、モデルのダウンロードアクセスが必要です。

インストール

npm install --global --ignore-scripts @quady3d/[email protected]
quady3d-mcp --version
quady3d-mcp connect

バージョンコマンドは 0.1.2 を出力します。接続済みアプリでアクセスキーを作成します。その際、生成とダウンロードの権限、およびジョブごとと 1 日あたりの少額の上限を設定してください。非表示のターミナルプロンプトにキーを貼り付けます。キーは非公開のローカルファイル ~/.config/quady3d/connection.json に保存されます（POSIX 権限 600）。暗号化されたキーチェーンストレージではありません。コマンドやチャットにキーを入力しないでください。サーバー環境の QUADY3D_API_KEY が優先されます。QUADY3D_API_KEY_FILE を使うと、別の絶対パスの接続ファイルを指定できます。保存済みのキーを明示的に置き換えるには connect --replace を使用します。connect --stdin は、パスワードマネージャーの標準出力からキーを受け取ります。

このパッケージは公式の @quady3d npm 組織を通じて配布されています。npm のグローバルインストールには、書き込み可能な npm プレフィックスが必要です。Node のバージョンマネージャーを使用するか、npm install --ignore-scripts @quady3d/[email protected] を使って別のローカルディレクトリにインストールし、command = "node" とともに node_modules/@quady3d/mcp/dist/cli.mjs を使用してください。バージョン付きアーカイブとチェックサムは、Quady3D のダウンロードからも入手できます。

Codex に接続する

command -v quady3d-mcp を実行して、実行ファイルを確認します。~/.codex/config.toml に次のセクションを追加し、2 つの絶対パスを置き換えてください。既存の無関係な設定はそのままにします。

[mcp_servers.quady3d]
command = "/absolute/path/to/quady3d-mcp"
args = ["--root", "/absolute/path/to/project"]
tool_timeout_sec = 180
default_tools_approval_mode = "writes"

MCP 接続を再起動するか、新しい Codex セッションを開始してください。エージェントに Quady3D アカウント、モデル、書き込み可能なプロジェクトディレクトリを確認するよう依頼します。これによって生成やクレジットの請求が行われることはありません。管理対象のホストでは、管理者ポリシーによって承認が必要になったり、接続がブロックされたりする場合があります。求められたら、ホスト上でファイル操作または生成操作を承認してください。サンドボックスや承認ポリシーを無効にしないでください。macOS 上の Codex CLI 0.163.0-alpha.11 では、スタンドアロン MCP と Skill の動作が確認されています。このリリースでは Claude Code と Claude Desktop は未検証です。

読み取りまたは書き込みができるのは、明示的に設定された既存のプロジェクトフォルダーのみです。複数のフォルダーを指定するには --root を繰り返します。QUADY3D_ALLOWED_ROOTS は、絶対パスの JSON 配列を指定する代替手段です。非公開の復旧データは、これらのルートの外部に保管してください。API の既定値は https://quady3d.com/api/v1 です。別の信頼できる接続を使う場合に限り、QUADY3D_API_URL を設定してください。

最初のタスク

付属の Skill をインストールしてから、次のように依頼してください。

$quady3d を使って、木製のチェストを作成してください。ダウンロードアクセス、利用可能なモデル、見積もりを確認してください。クレジット上限の承認を求めてください。このプロジェクト内に新しい GLB を保存し、中断した場合は元のタスクを復旧してください。

8 つのツールは quady3d_list_models、quady3d_get_account、quady3d_upload_file、quady3d_quote、quady3d_create_job、quady3d_get_job、quady3d_list_jobs、quady3d_download_asset です。見積もりによって生成が行われることはありません。タスクを作成するとクレジットが確保されます。残高、キーの利用上限、ダウンロードアクセスはそれぞれ別です。画像入力は 8 MiB 以下の PNG／JPEG／WebP 画像 1 枚です。アップロードは 30 分後、見積もりは 5 分後に期限切れになります。

復旧とファイル

送信結果が不明な場合は、元のアクション、引用、本文、クレジット上限を維持してください。代わりのタスクを作成せず、既存のジョブ ID を照会してください。再度待機したりダウンロードしたりしても、生成は行われません。ダウンロードでは既存のファイルが保持され、許可されたルート内に保存されます。保存先のファイルシステムはハードリンクをサポートしている必要があります。3D ツールで、受け取ったジオメトリ、テクスチャ、スケールを確認してください。

プライベートな復旧状態は、デフォルトでプラットフォームのユーザー状態ディレクトリ内の quady3d/mcp に保存されます。QUADY3D_STATE_DIR を設定すると、プロジェクトルート外の別の絶対パスを指定できます。ここにはプロンプトとタスク識別子が含まれますが、アクセスキーは含まれません。確定済みのターミナル記録と配信記録は、使用中に7日後にクリーンアップされます。未解決の送信は保持されます。

更新または削除

明示的に選択した新しいパッケージバージョンをインストールし、接続を再起動してください。接続を解除するには、Quady3D MCP のセクションだけを削除し、Connected apps でキーを失効させてください。npm uninstall --global @quady3d/mcp を実行すると、グローバルパッケージが削除されます。保存済みの接続ファイルを削除すると、そのファイルを使用しているローカルのコンシューマーの接続が解除されます。元のタスクがすべて解決するまで、復旧記録は保持してください。これらの操作によって、受け付け済みのクラウドタスクがキャンセルされたり、保存済みのモデルファイルが削除されたりすることはありません。

セットアップとトラブルシューティング、チェックサムとソース、同梱の LICENSE とサードパーティ通知をご覧ください。

ローカルのアーカイブサーバーを使用する場合は、QUADY3D_PACKAGE_ORIGIN にそのループバックオリジンを設定し、上記のアーカイブ URL にも同じオリジンを使用してください。パッケージオリジンと API オリジンは別々です。QUADY3D_API_URL は、呼び出す信頼できるサービスだけに設定してください。

ダウンロードはプライベートな一時ファイルにストリーミングされ、完全なファイルのみが既存の出力を上書きせずに公開されます。転送が中断された場合は、同じアセット ID で再試行してください。バイト範囲による再開には対応していません。