[クイックスタート] MCP AIツールの接続と最初の呼び出し (dsdx.start)
MCP接続クイックスタート ·
DSDX-MCP/1.0(2025-11-25&2025-06-18対応)コーディング・デスクトップAIクライアントから
https://dualsoft.ai/mcpへ接続し、最初の検証済みds2 v2;ワークフローを実行する手順です。
1. 公開・ローカルMCPエンドポイント一覧
トラック · エンドポイント / バイナリ · 公開ツール数 · 主な用途
Stable 公開 Web MCP · https://dualsoft.ai/mcp · 公開読み取り専用10ツール {{詳細::公開ツール一覧: dsdx.start, dsdx.ping, docs_search, docs_read, dsdx.examples.list, dsdx.examples.get, dsdx.library.search, dsdx.library.get, dsdx.scene.catalog, dsdx.plc.formats // デスクトップ連携: キーレス DS Studio Desktop --local-agent は 73 ツールを提供}} · 文法仕様、公式.ds2サンプル、3D設備カタログを顧客ソース送信なしで安全に参照します。 {{詳細::カタログ規模: 1,345種 モデル (1,258種 .ds2 連携 · 927種 プレビュー · 418種 下書き) + 10ライン例 (01 スマートフォン ~ 10 水素エネルギープラント) // Zero-Exposure: 顧客ソースや本番評価をサーバへ送信・保存しない設計}}
Experimental 公開 Web MCP · https://dualsoft.ai/mcp-exp · 公開読み取り専用10ツール · PLAY Experimental と連動し、新機能をキー入力なしのコードエディタとクリップボード経由で試せます。
ローカル Zero-Exposure エンジン · Dsdx.Authoring.exe --stdio (/download/dsdx-vscode-latest.vsix v2.2.3 内包) または DS Studio Desktop --local-agent · 全89ローカルツール · 顧客データを外部へ送らず、自分のPC内で作成・コンパイル・実行検証・出力を完結できます。 {{詳細::ローカル範囲: dsdx.compile、3ラウンド/VENDOR_PLC SILS 検証、PLC/SequenceControlData.Edges AASX/showcase-html 生成、dsdx.dsd.* 診断 // 判定形式: PASS, FAIL, NOT_RUN, UNSUPPORTED, INCONCLUSIVE // 予定: DS2-LSP/DS2-DAP Phase 3計画}}
2. 推奨4ステップ検証フロー(ローカルstdio / Web PLAYブリッジ)
dsdx.start({}または{"goal": "author_ds2"}) —ds2 v2;文法カード (AI-ST-KIT)、演算子一覧、必須チェックリストを取得します。docs_search/docs_read— 必要に応じて公式仕様 (DS2-SPEC-V2.0) の詳細セクションを参照します。dsdx.compile({"source": "ds2 v2; ..."}) —.ds2原文(UTF-8 BOM無し・LF)をローカルで封印済みSDFへコンパイルし、静的診断 (DS2-E001..E029・DS2-W002・DS2-I002) を確認します。 {{詳細::制限・入力: 上限1,048,576バイト(1 MiB)、BOM無しUTF-8/LF専用 // 出力: 封印済みdsdx-sdf/1.1、sourceSha256、sealDigest、静的診断}}dsdx.verify.run({"source": "ds2 v2; ...", "scans": 200}) — ランタイム検証をローカル実行し、判定結果とビューア出力を取得します。 {{詳細::検証: 反復製品APIの既定3ラウンド検証、CALL-TOKEN-BOUNDARY-1トークン隔離/借用、FiredEdgeIndices因果帰属、VENDOR_PLCSILS(未対応Call・開ループ経路はGUARD-E422_UNSUPPORTED_OR_UNMEASURED/HOST-E422_CALL_EXECUTION_UNSUPPORTEDで拒否、未復旧故障FAIL封印) // 正本判定:PASS,FAIL,NOT_RUN,UNSUPPORTED,INCONCLUSIVE// ビュー・安全: 8種ビュー、ASCIIidempotency_key必須}}- PLC・成果物出力 (
dsdx.artifact.export): 7大PLCパッケージ、showcase-html(7タブ)、システム単位SequenceControlData.Edges(Sources/Targets) AAS/DPP を出力し、事前点検勧告preflightAdvisories(PREFLIGHT-W001..W005)およびbundleStatus(CAPABILITY_UNSUPPORTED)を返します。
2.1 顧客情報保護方針・単一 .vsix 配布・VS Code不要の1クリック導入
顧客情報保護方針に基づき、公開Web MCP(/mcp)には顧客の.ds2原文を一切送信しません。Web /play の [DS2コードエディタ] + クリップボード/プロンプトブリッジを使うか、単一 .vsix からローカルMCPを導入してください:
- VS Code なしで専用AI IDEへ1クリック導入 (
Antigravity·Claude·Gemini·OpenAI Codex·Cursor·Windsurf): /download/dsdx-mcp-setup.cmd?dl=1または PowerShell 1行irm https://dualsoft.ai/download/install-local-mcp.ps1 | iexで、単一/download/dsdx-vscode-latest.vsixからDsdx.Authoring.exe --stdioのみを抽出し各IDE設定へ自動登録します(.zip2重管理なし)。- 6タブ導入ガイド & VS Code (
DualSoftDev.ds2):.vsixを導入しdsdx.registerLocalMcpを実行すると外部AI IDEにも一括登録できます。全体構成は 6タブの AI接続ガイド (/mcp-guide) (Quickstart · Tools, ダウンロード, AI IDE設定, VS Code,Photo · MC · Factory, ツールカタログ) をご覧ください。
3. 最小検証テンプレート (ds2 v2;)
ds2 v2;
project "Mcpクイックスタートセル" {
active "セルメイン";
system "グリッパ" {
flow "動作" {
work "把持" { duration 150ms; }
work "解放" finished { duration 150ms; }
"把持" <|> "解放";
}
api "把持" = "動作"."把持";
api "解放" = "動作"."解放";
}
system "セルメイン" {
origin flow "原点" {
work "グリッパ開放" {
"グリッパ"."解放" reuse completed;
}
}
flow "サイクル" {
work "ピックアンドプレース" {
"グリッパ"."把持" > "グリッパ"."解放";
}
}
api "サイクル開始" = "サイクル"."ピックアンドプレース";
}
}