[Quickstart] Connecting MCP AI Tools & First Call (dsdx.start)
MCP Connection Quickstart ·
DSDX-MCP/1.0(2025-11-25&2025-06-18)Connect your AI coding or desktop client to
https://dualsoft.ai/mcpand run your first verifiedds2 v2;workflow.
1. Public & Local MCP Endpoints
Track · Endpoint / Binary · Exposed Tools · Purpose
Stable Public Web MCP · https://dualsoft.ai/mcp · 10 Read-Only Zero-Exposure Tools (Compat HTTP & keyless DS Studio Desktop --local-agent: 73) · Official docs, .ds2 examples, 1,345 public 3D models (1,258 .ds2-linked, 10 line templates), and PLC format lookup with zero customer code sent remotely.
Experimental Public Web MCP · https://dualsoft.ai/mcp-exp · 10 Read-Only Zero-Exposure Tools · Preview channel paired with PLAY Experimental keyless [DS2 Code Editor] + Clipboard Bridge (HTTP gzip).
Local Zero-Exposure Engine · Dsdx.Authoring.exe --stdio (from /download/dsdx-vscode-latest.vsix v2.2.3) or DS Studio Desktop --local-agent · All 89 Local Tools (Compile, 3-round / VENDOR_PLC SILS verify, CAD/PLC/SequenceControlData.Edges AASX/7-Tab export & DSD diagnostics) · Full client-local authoring, canonical `PASS \ · FAIL \ · NOT_RUN \ · UNSUPPORTED \ · INCONCLUSIVE` checks, and diagnostics on your PC.
2. 4-Call Verification Sequence (Local Stdio / Web Play Bridge)
When using the local Zero-Exposure MCP (Dsdx.Authoring --stdio), agents execute these 4 calls in order (while Web /play runs keyless [DS2 Code Editor] + client WASM + Clipboard/Prompt Bridge without model API keys):
dsdx.start({}or{"goal": "author_ds2"}) — Loads theds2 v2;grammar card (AI-ST-KIT), operator table, and official reference receipt (examples/st-expression/st-conditions-v2.ds2).docs_search/docs_read— Reads the canonical specification (DS2-SPEC-V2.0) whenever specific rules (origin flow,interlock,Call DAG) are needed.dsdx.compile({"source": "ds2 v2; ..."}) — Compiles your.ds2source locally (up to1 MiB/1,048,576UTF-8 bytes, UTF-8 without BOM + LF) and returnssourceSha256,sealDigest, and static diagnostics (DS2-E001..E029,DS2-W002,DS2-I002).dsdx.verify.run({"source": "ds2 v2; ...", "scans": 200}) — Runs the zero-allocation verification kernel locally (defaulting to 3-round repeating verification withCALL-TOKEN-BOUNDARY-1token isolation/borrowing,FiredEdgeIndicescausal attribution, post-seed checks, andVENDOR_PLCSILS; unsupported calls/open-loop paths are rejected withGUARD-E422_UNSUPPORTED_OR_UNMEASURED/HOST-E422_CALL_EXECUTION_UNSUPPORTED, and unrecovered faults sealFAIL), returning canonical verdict (PASS | FAIL | NOT_RUN | UNSUPPORTED | INCONCLUSIVE), scan traces, and 8 Studio views (ds_studio_views.html). (Command ops use an ASCIIidempotency_keyfor safe retries.)- PLC / Artifact Export (
dsdx.artifact.export): Generates 7-vendor PLC packages, 7-Tab showcase (showcase-html), and system-levelSequenceControlData.Edges(Sources/Targets) AAS/DPP bundles, returning commissioningpreflightAdvisories(PREFLIGHT-W001..W005) andbundleStatus(CAPABILITY_UNSUPPORTEDwhen unsupported PLC calls exist).
2.1 Privacy Policy, Single-Artifact .vsix, and Non-VS Code 1-Click Setup
In accordance with the Customer Information Protection Policy, customer .ds2 sources are never transmitted to public Web MCP (/mcp). Choose either Web /play ([DS2 Code Editor] + [Copy Prompt] / [Apply Clipboard DS2]) or local installation from the single .vsix product package:
- One-Click Setup Without VS Code (
Antigravity·Claude·Gemini·OpenAI Codex·Cursor·Windsurf): - Run
/download/dsdx-mcp-setup.cmd?dl=1or PowerShell:irm https://dualsoft.ai/download/install-local-mcp.ps1 | iex(extractsDsdx.Authoring.exe --stdiofrom the single/download/dsdx-vscode-latest.vsixand registers"dsdx"across all 7 AI IDEs with zero duplicate.zipartifacts). - Full 6-Tab Setup Guide & VS Code (
DualSoftDev.ds2): Install/download/dsdx-vscode-latest.vsixand rundsdx.registerLocalMcpin the Command Palette. Explore all 6 tabs in the AI Connection Guide (/mcp-guide) (Quickstart · Tools, Downloads, AI IDE Setup, VS Code Guide,Photo · MC · Factory, Tool Catalog).
3. Minimal Verification Template (ds2 v2;)
ds2 v2;
project McpQuickstartCell {
active CellMain;
system Gripper {
flow Act {
work Grip { duration 150ms; }
work Release finished { duration 150ms; }
Grip <|> Release;
}
api Grip = Act.Grip;
api Release = Act.Release;
}
system CellMain {
origin flow Home {
work OpenGripper {
Gripper.Release reuse completed;
}
}
flow Cycle {
work PickAndPlace {
Gripper.Grip > Gripper.Release;
}
}
api StartCycle = Cycle.PickAndPlace;
}
}