RotoSpiderマニュアル › 共有とサポート

AIアシスタントに尋ねる、またはWebAPIを呼び出す

対象バージョン：RotoSpider Web App 0.8.13とDesktop 0.8.14 · 確認：2026-09-13 D5

RotoSpiderのレイアウト計算エンジンには、RotoSpiderを開かずに問い合わせることができます。MCPを通じてやり取りするAIアシスタントからでも、Web APIを通じて自社のソフトウェアからでもかまいません。どちらも、アプリが答えるのと同じ問い、つまり、ある金型の組み合わせがアームに収まるか、どう収まるかに答えます。現在はどちらも、評価用の公開サービスです。このページでは、それぞれの用途と、詳細がどこにあるかを説明します。接続の手順、スキーマ、サンプルコードはサイトの各ページにあり、サービスに合わせて最新の状態に保たれています。

MCPを通じたAIアシスタント

リモートのMCPサーバー（Model Context Protocol）に対応したアシスタントは、会話の中で金型の寸法、数量、アームの詳細を集め、文章から推測する代わりに、RotoSpiderを呼び出して物理的な答えを得られます。金型が収まるかどうかの判断はRotoSpiderが受け持ち、アシスタントは入力を整理して結果を説明します。

接続先は、Streamable HTTPの1つのカスタムMCPサーバーで、アドレスは次のとおりです。

https://www.rotospider.com/roto/mcp

アシスタントのコネクター設定で名前を「RotoSpider」とし、寸法と単位を付けて質問します。形状、大きさ、数、そしてアームまたは公開のサンプル機です。クリアランスなど足りない情報は、アシスタントが尋ねます。返ってくるのは、確かめられるレイアウトの答えです。要求したすべての金型が配置されたか、金型ごとの要求数と配置数、クリアランスとスパイダー使用率、クランクアーム（L型アーム）で選ばれたかさ上げ台、アームにもとづく配置座標です。

サイトのMCPのページ ENには、接続の3つの手順、質問の例、利用の範囲が載っています。アシスタントは、名前や文章から金型が収まると推論したり、機械の寸法を作り上げたり、公開のサンプル機を自社の工場のデータとして扱ったりしてはいけません。

WebAPIを通じた自社のソフトウェア

このAPIは試用として提供しており、変更されることがあります。特定のバージョンを使い続ける必要がある場合は、サービスが中断しないよう、[email protected]にメールで登録を依頼してください。

レイアウトの確認は、JSONの本文を持つ1回のHTTPSリクエストです。

POST https://www.rotospider.com/roto/api/layout/check

金型は、寸法を付けた直方体か円柱として、または用意した正確な形状をその識別子で指定して送り、公開のサンプル機か、自社のアームの形状（ストレートかクランクか、スパイダー、最大回転径、かさ上げ台）を指定します。返ってくるのは、要求がすべて満たされたか、要求数と配置数、クリアランス、使用率、選ばれたかさ上げ台、使われたアームの形状、配置座標です。長さは、0.001 mm単位の明示的なミリメートルの項目か、名前でインチとわかる項目で指定します。結果の物理的な値は、ミリメートルです。

正確な形状は、一度作成してから参照します。1回のリクエストで、作成する形状（L字柱、三角柱、斜面付き、円すい台、描いた占有外形）を公開するか、用意した.rotogeomまたは.rotoshapeファイルを取り込み、金型とともに送る識別子を受け取ります。サービスは、STEPファイルそのものは受け付けません。STEPファイルは、取り込みのページで説明しているとおりWindows版のデスクトップアプリで準備し、APIが受け取るのは、その持ち運び用のパッケージです。

サイトのWebAPIのページ ENには、仕様、OpenAPIの記述、開発者向けプレビューのサンプル ENがあります。サンプルは、ミリメートルとインチで対応するリクエストと、そのまま実行できるPython、JavaScript、curl、PowerShellのクライアントです。

どちらかを頼りにする前に

どちらのサービスも評価用です。リクエスト数に制限があり、本番用のサービスレベルはなく、スキーマもまだ変わっていきます。連携についてデータの扱いとアクセスの取り決めができるまでは、機密の受注やマスターデータを公開サービスに送らないでください。その相談は、会社情報のページから始まります。工場との連携では、その工場自身の回転成形機、アーム、スパイダーの形状、金型のマスターデータ、計画の決まりを持ち込み、最初にバージョン管理、処理能力、アクセスについて取り決めます。