Claude Code DTS MCP 플러그인

DTS Engine 게이트웨이( https://192.168.50.170:8770/mcp )를 위한 비공개 Claude Code 플러그인입니다.

macOS 또는 Windows에서 Claude Code가 소스 데이터를 업로드하고, Windows DTS Engine 6.1 퍼블리싱 작업을 대기열에 추가하고, 모니터링하며, 해시 검증된 3DT 결과를 다운로드할 수 있게 해줍니다. 플러그인에는 DTS Engine 바이너리나 서버 비밀이 포함되어 있지 않습니다.

이는 macOS에서 Codex에 동일한 게이트웨이를 제공하는 codex-dts-mcp-plugin의 Claude Code 대응 버전입니다. 두 플러그인 모두 동일한 게이트웨이와 동일한 DTS_MCP_TOKEN 환경 변수를 대상으로 하므로 동일한 저장된 베어러 토큰을 공유할 수 있습니다.

전제 조건

• 클라이언트 머신이 사설 LAN 또는 VPN을 통해 192.168.50.170:8770에 라우팅할 수 있어야 합니다.

• GitHub 액세스로 zhouning/claudecode-dts-mcp-plugin을 클론할 수 있어야 합니다.

• Claude Code CLI가 설치되어 있어야 합니다 (claude plugin --help가 성공해야 함).

• Windows DTS MCP 게이트웨이가 정상이고 DTS Engine이 설치 및 라이선스되어 로그인된 대화형 Windows 세션에서 실행 중이어야 합니다.

• 보안 채널을 통해 게이트웨이 베어러 토큰을 보유하고 있어야 합니다.

토큰을 셸 명령에 붙여넣지 마십시오. 두 설치 프로그램 모두 터미널 에코 없이 프롬프트를 표시합니다: configure-macos.sh는 macOS 로그인 키체인에 저장하고, configure-windows.ps1은 Windows 자격 증명 관리자에 저장합니다.

macOS에 설치

git clone git@github.com:zhouning/claudecode-dts-mcp-plugin.git
./claudecode-dts-mcp-plugin/plugins/dts-mcp/scripts/configure-macos.sh

스크립트는 공용 DTS MCP CA만 로그인 키체인에 가져오고, 서비스 dts-mcp 아래에 베어러 토큰을 저장하며, DTS_MCP_TOKEN을 복원하는 사용자 LaunchAgent를 설치하고, zhouning-dts 마켓플레이스를 추가하며, dts-mcp@zhouning-dts를 설치하고, 고정 상태 엔드포인트를 확인합니다.

다음으로 확인합니다:

./claudecode-dts-mcp-plugin/plugins/dts-mcp/scripts/verify-connection-macos.sh

Windows에 설치

git clone https://github.com/zhouning/claudecode-dts-mcp-plugin.git
.\claudecode-dts-mcp-plugin\plugins\dts-mcp\scripts\configure-windows.ps1

스크립트는 베어러 토큰을 Windows 자격 증명 관리자에 Generic Credential으로 대상 dts-mcp 아래에 저장하고, DTS_MCP_TOKEN을 사용자 환경 변수로 유지하며 변경 사항을 브로드캐스트하여 새 프로세스에서 이를 인식하도록 하고, Cert:\CurrentUser\Root에 번들된 CA를 신뢰하며, zhouning-dts 마켓플레이스를 추가하고, dts-mcp@zhouning-dts를 설치하고, 고정 상태 엔드포인트를 확인합니다.

다음으로 확인합니다:

.\claudecode-dts-mcp-plugin\plugins\dts-mcp\scripts\verify-connection-windows.ps1

어느 플랫폼에서든 설치 후 Claude Code를 다시 시작하고 새 세션을 여십시오.

업데이트

git -C claudecode-dts-mcp-plugin pull --ff-only
claude plugin marketplace update zhouning-dts
claude plugin install dts-mcp@zhouning-dts

업데이트 후 Claude Code를 다시 시작하고 새 세션을 사용하십시오.

베어러 토큰 교체

먼저 Windows 게이트웨이에서 토큰을 교체한 후 다음을 실행하십시오:

./claudecode-dts-mcp-plugin/plugins/dts-mcp/scripts/configure-macos.sh --rotate-token

.\claudecode-dts-mcp-plugin\plugins\dts-mcp\scripts\configure-windows.ps1 --rotate-token

CA 갱신

Windows 호스트 주소 또는 DTS MCP CA가 변경된 후 체크아웃을 업데이트하고 다음을 실행하십시오:

git -C claudecode-dts-mcp-plugin pull --ff-only
./claudecode-dts-mcp-plugin/plugins/dts-mcp/scripts/configure-macos.sh --refresh-ca
./claudecode-dts-mcp-plugin/plugins/dts-mcp/scripts/verify-connection-macos.sh

git -C claudecode-dts-mcp-plugin pull --ff-only
.\claudecode-dts-mcp-plugin\plugins\dts-mcp\scripts\configure-windows.ps1 --refresh-ca
.\claudecode-dts-mcp-plugin\plugins\dts-mcp\scripts\verify-connection-windows.ps1

갱신은 베어러 토큰을 읽거나 다시 쓰지 않습니다. 엔드포인트 또는 서명 키 변경 전에 발급된 서명된 URL은 폐기하십시오.

제거

macOS:

claude plugin uninstall dts-mcp
claude plugin marketplace remove zhouning-dts
launchctl bootout "gui/$UID/com.dts.mcp.token" 2>/dev/null || true
rm -f "$HOME/Library/LaunchAgents/com.dts.mcp.token.plist"
rm -rf "$HOME/Library/Application Support/dts-mcp"
security delete-generic-password -a "$USER" -s dts-mcp
launchctl unsetenv DTS_MCP_TOKEN

Windows:

claude plugin uninstall dts-mcp
claude plugin marketplace remove zhouning-dts
[Environment]::SetEnvironmentVariable('DTS_MCP_TOKEN', $null, 'User')
cmdkey /delete:dts-mcp 2>$null

지문을 확인한 후에만 로그인 키체인(security delete-certificate) 또는 Cert:\CurrentUser\Root(Remove-Item)에서 DTS MCP Local CA 인증서를 제거하십시오.

게시 제약 조건

• road만 종단 간 검증되었습니다.

• 도로 입력에는 투영된 CRS와 domPath가 필요하며, 일치하는 DEM을 강력히 권장합니다.

• OSGB 게시는 두 단계가 모두 필요하며 dts_publish_osgb를 사용해야 합니다.

• 원격 경로 플래그는 아티팩트 ID와 아티팩트 상대 경로를 사용하며, Windows 경로를 사용하지 않습니다.

• 업로드 및 다운로드 바이트는 베어러 토큰 없이 서명된 HTTPS URL을 사용합니다.

• 원격 게이트웨이는 14개의 도구를 등록하며, dts_validate는 로컬 전용으로 유지됩니다.

• 성공적인 결과 ZIP은 .3dt 데이터와 DataInfor.txt를 모두 보유해야 합니다.

문제 해결 순서

1. 192.168.50.170:8770에 대한 사설 라우팅을 확인합니다.

2. Windows 호스트가 로그인되어 있고 DTS MCP 게이트웨이가 정상인지 확인합니다.

3. 플랫폼의 verify-connection-* 스크립트를 실행하고 첫 번째 실패한 계층을 수정합니다.

4. 인증 실패 시 --rotate-token을 사용합니다.

5. 주소 또는 인증서 변경 후 --refresh-ca를 사용합니다.

6. dts-mcp가 claude plugin list에 나타나는지 확인합니다.

7. dts가 claude mcp list에 나타나는지 확인합니다.

8. 새 Claude Code 세션을 시작하고 dts_ping을 호출합니다.

검증 상태

• DTS 서버 원격 게이트웨이 구현 및 자체 원격 스모크 테스트: 이 저장소에서 재검증되지 않음; zhouning/dts-mcp-server 참조.

• 플러그인 manifest, Skill, 인증서, 스크립트 구문 및 비밀 검사: 이 저장소의 테스트에 포함됨.

• Windows 자격 증명 관리자 및 macOS 키체인 수락은 대상 머신에서 보류 중입니다.

• 대상 머신이 실제 도로 업로드, 게시, 다운로드 및 SHA-256 검증을 완료할 때까지 플러그인의 종단 간 성공을 보고하지 마십시오.