# DS Studio MCP — 공개 읽기 전용 Web MCP 안내 (DSDX-ZERO-EXPOSURE-1)

> 실행 엔드포인트: `https://dualsoft.ai/mcp` · channel: `stable` · 공개 HTTP는 10개 읽기 전용 도구만 노출하며(`PRIVACY-E403`), 컴파일·검증은 `https://dualsoft.ai/play#source` 또는 로컬 `stdio` MCP(`Dsdx.Authoring --stdio`)에서 실행합니다.


- **원본 인덱스 / 문서 / 빠른 시작**: https://dualsoft.ai/llms.txt · https://dualsoft.ai/docs · [`MCP-START`](https://dualsoft.ai/docs?raw=1&document_id=MCP-START) · https://dualsoft.ai/mcp-guide · https://dualsoft.ai/ai-start.txt
- **연결 경계**: Reading this page does not connect MCP tools. 실제 `tools/list` 호출 없이 문서를 읽은 것만으로 도구 연결이나 검증 완료를 선언할 수 없으며, 도구를 호출할 수 없는 웹 환경에서는 `MCP connection UNCONFIRMED`, 작성한 `.ds2` 초안은 `UNVERIFIED_DRAFT` 로 표시합니다.

## 1. 공개 Web MCP 범위 (10개 읽기 전용 도구 · `PRIVACY-E403`)

공개 HTTP 엔드포인트(`https://dualsoft.ai/mcp`)는 고객 공정 원문(`.ds2`) 유출을 원천 차단하는 **Client Zero-Exposure 모드(`DSDX-ZERO-EXPOSURE-1`)**로 동작합니다.

- **노출 도구 (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`
- **차단 범위 (`PRIVACY-E403_CLIENT_EXECUTION_REQUIRED`)**: 공개 HTTP 세션에서 공정 원문(`source`) 기반 컴파일·검증·시뮬레이션·내보내기 호출은 `PRIVACY-E403` 으로 거부됩니다. 공개 `/mcp` 경로에서는 원격 컴파일·검증 도구를 호출하지 마세요.
- **권장 실행 경로 2가지**:
  1. **웹 `/play` 브라우저 로컬 실행**: 생성한 전체 `ds2 v2;` 원문을 `UNVERIFIED_DRAFT` 코드 블록으로 제시하고 사용자가 [https://dualsoft.ai/play#source](https://dualsoft.ai/play#source) 에 붙여 넣어 브라우저 내부 WASM 엔진으로 100% 로컬 컴파일·시뮬레이션·PLC 변환을 실행하도록 안내합니다.
  2. **로컬 `stdio` MCP (`Dsdx.Authoring --stdio`)**: AI가 직접 컴파일·검증·MILS·PLC/AASX 내보내기를 실행하려면 사용자가 로컬 제품([https://dualsoft.ai/mcp-guide#product-download](https://dualsoft.ai/mcp-guide#product-download), 단일 `.vsix` 또는 Antigravity·Claude·Gemini·Codex 1클릭 로컬 MCP 설치기)을 PC에 설치해 `stdio` 모드로 연결합니다. Factory 3D 온보딩·로컬 연결 설정은 [https://dualsoft.ai/mcp-guide#factory-local-config](https://dualsoft.ai/mcp-guide#factory-local-config) 및 `/mcp-guide#factory-local-config` 안내를 참고합니다.

## 2. 공개 Web MCP JSON-RPC 호출 예시 (읽기 전용)

직접 HTTP 클라이언트는 `POST https://dualsoft.ai/mcp` (`Content-Type: application/json`, `Accept: application/json, text/event-stream`, 초기화 후 `MCP-Protocol-Version` 및 `Mcp-Session-Id` 헤더 전달)로 아래 읽기 전용 도구를 호출합니다.

```json
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"dsl-author","version":"1.0"}}}
```

```json
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"dsdx.start","arguments":{}}}
```

```json
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"docs_read","arguments":{"document_id":"AI-ST-KIT","version":"DS2-SPEC-V2.0"}}}
```

> 참고: `docs_read`에서 `version`을 생략하면 각 문서(`AI-ST-KIT`, `ST-EXPR-SPEC`, `SPEC-00`, `SPEC-04`, `wiki/home` 등)의 정본 버전 프로필이 자동 선택됩니다.

```json
{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"docs_search","arguments":{"query":"ST 조건식 when while 이전 입력 펄스","version":"DS2-SPEC-V2.0"}}}
```

```json
{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"dsdx.examples.list","arguments":{}}}
```

```json
{"jsonrpc":"2.0","id":6,"method":"tools/call","params":{"name":"dsdx.library.search","arguments":{"query":"robot","limit":5}}}
```

## 3. 정본 `ds2 v2;` (`DS2-SPEC-V2.0`) 작성 원칙

- 신규 공정·설비사진·MC 차트 작성의 유일한 정본 헤더는 `ds2 v2;` (`DS2-SPEC-V2.0`)입니다(`ds2 v1;` 파일은 명시적 요청 시에만 유지). `sys { F = ... P = ... }` 나 `passive system` 같은 비표준 구문을 생성하지 마세요.
- 1회 명령 1사이클 직렬 체인은 2-Work일 때 `A =|> B;`, 3개 이상일 때 `A => B =|> C;` 를 사용하고, 반복 호출되는 Passive 장치는 `Lock <|> Unlock;` 또는 `Weld =|> Rearm; work Rearm;` 으로 재준비 경로를 명시합니다.
- 조건식은 `when (BOOL 식);` · `while (BOOL 식);` · `interlock (BOOL 식) "사유";` 에 ST 부분집합(`= <> AND OR NOT MOD`)으로 작성합니다.
- 공개 Web MCP 응답만으로 컴파일/실행 PASS를 주장하지 않고, 반드시 [https://dualsoft.ai/play#source](https://dualsoft.ai/play#source) (브라우저 WASM) 또는 로컬 `stdio` MCP (`Dsdx.Authoring --stdio`) 결과를 근거로 구분해 보고합니다.

## 이 빌드의 실제 도구 목록

현재 레지스트리는 MCP 도구 10개를 노출합니다: 정본 Host 연산 0개와 확장/호환 도구 10개입니다. Host 정본 연산 수와 MCP 발견 수는 서로 다른 집합입니다. 호출 가능한 이름과 인자 스키마의 정본은 실제 `tools/list` 응답입니다.

확장/호환 도구: `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`.

문서는 `docs_search`와 `docs_read`를 우선합니다. `dsdx.docs.search/read`는 호환 별칭이며 `docs.search/read`는 등록된 도구가 아닙니다.
