Claude Code DTS MCP Plugin

Privates Claude Code Plugin für das DTS Engine Gateway unter https://192.168.50.170:8770/mcp.

Es ermöglicht Claude Code auf macOS oder Windows, Quelldaten hochzuladen, Windows DTS Engine 6.1 Publishing-Jobs in die Warteschlange zu stellen, zu überwachen und hash-verifizierte 3DT-Ergebnisse herunterzuladen. Das Plugin enthält keine DTS Engine-Binärdateien und keine Server-Geheimnisse.

Dies ist das Claude Code-Gegenstück zu codex-dts-mcp-plugin, welches das gleiche Gateway für Codex auf macOS bereitstellt. Beide Plugins können denselben gespeicherten Bearer Token verwenden, da sie auf dasselbe Gateway und dieselbe Umgebungsvariable DTS_MCP_TOKEN abzielen.

Voraussetzungen

• Der Client-Rechner kann über das private LAN oder VPN eine Route zu 192.168.50.170:8770 herstellen.

• Der GitHub-Zugriff kann zhouning/claudecode-dts-mcp-plugin klonen.

• Die Claude Code CLI ist installiert (claude plugin --help ist erfolgreich).

• Das Windows DTS MCP Gateway ist fehlerfrei und die DTS Engine ist installiert, lizenziert und läuft in einer angemeldeten interaktiven Windows-Sitzung.

• Sie haben den Gateway Bearer Token über einen sicheren Kanal erhalten.

Fügen Sie den Token nicht in einen Shell-Befehl ein. Beide Installationsprogramme fragen ohne Terminal-Echo ab: configure-macos.sh speichert ihn in der macOS Login Keychain, configure-windows.ps1 speichert ihn im Windows Credential Manager.

Installation auf macOS

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

Das Skript importiert nur das öffentliche DTS MCP CA in die Login Keychain, speichert den Bearer Token unter dem Dienst dts-mcp, installiert einen Benutzer-LaunchAgent, der DTS_MCP_TOKEN wiederherstellt, fügt den Marktplatz zhouning-dts hinzu, installiert dts-mcp@zhouning-dts und überprüft den festgelegten Health-Endpunkt.

Überprüfen mit:

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

Installation auf Windows

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

Das Skript speichert den Bearer Token als generische Anmeldeinformationen im Windows Credential Manager unter dem Ziel dts-mcp, persistiert DTS_MCP_TOKEN als Benutzer-Umgebungsvariable und sendet die Änderung, sodass neue Prozesse sie sehen, vertraut dem gebündelten CA in Cert:\CurrentUser\Root, fügt den Marktplatz zhouning-dts hinzu, installiert dts-mcp@zhouning-dts und überprüft den festgelegten Health-Endpunkt.

Überprüfen mit:

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

Starten Sie Claude Code nach der Installation auf einer der beiden Plattformen neu und öffnen Sie eine neue Sitzung.

Aktualisierung

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

Starten Sie Claude Code nach einem Update neu und verwenden Sie eine neue Sitzung.

Rotation des Bearer Tokens

Rotieren Sie den Token zuerst auf dem Windows-Gateway und führen Sie dann Folgendes aus:

./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

Aktualisierung des CA

Nach einer Änderung der Windows-Hostadresse oder des DTS MCP CA aktualisieren Sie den Checkout und führen Sie Folgendes aus:

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

Die Aktualisierung liest oder überschreibt den Bearer Token nicht. Verwerfen Sie signierte URLs, die vor einer Endpunkt- oder Signaturschlüsseländerung ausgestellt wurden.

Entfernung

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

Entfernen Sie das Zertifikat DTS MCP Local CA aus der Login Keychain (security delete-certificate) oder Cert:\CurrentUser\Root (Remove-Item) erst, nachdem Sie seinen Fingerabdruck bestätigt haben.

Einschränkungen bei der Veröffentlichung

• Nur road ist durchgängig verifiziert.

• Straßeneingaben erfordern ein projiziertes CRS und domPath; ein passendes DEM wird dringend empfohlen.

• Die OSGB-Veröffentlichung erfordert beide Stufen und muss dts_publish_osgb verwenden.

• Remote-Pfad-Flags verwenden Artefakt-IDs und artefaktrelative Pfade, niemals Windows-Pfade.

• Upload- und Download-Bytes verwenden signierte HTTPS-URLs ohne den Bearer Token.

• Das Remote-Gateway registriert 14 Tools; dts_validate bleibt lokal.

• Ein erfolgreiches Ergebnis-ZIP muss sowohl seine .3dt-Daten als auch DataInfor.txt enthalten.

Fehlerbehebungsreihenfolge

1. Bestätigen Sie die private Weiterleitung zu 192.168.50.170:8770.

2. Bestätigen Sie, dass der Windows-Host angemeldet ist und das DTS MCP Gateway fehlerfrei ist.

3. Führen Sie das plattformspezifische Skript verify-connection-* aus und beheben Sie die erste fehlgeschlagene Ebene.

4. Verwenden Sie --rotate-token bei Authentifizierungsfehlern.

5. Verwenden Sie --refresh-ca nach einer Adress- oder Zertifikatsänderung.

6. Bestätigen Sie, dass dts-mcp in claude plugin list erscheint.

7. Bestätigen Sie, dass dts in claude mcp list erscheint.

8. Starten Sie eine neue Claude Code-Sitzung und rufen Sie dts_ping auf.

Verifikationsstatus

• DTS Server Remote-Gateway-Implementierung und dessen eigener Remote-Smoke-Test: nicht von diesem Repository aus erneut verifiziert; siehe zhouning/dts-mcp-server.

• Plugin-Manifeste, Skill, Zertifikat, Skript-Syntax und Geheimnisprüfungen: werden von den Tests dieses Repositorys abgedeckt.

• Die Akzeptanz von Windows Credential Manager und macOS Keychain steht auf den Zielrechnern noch aus.

• Melden Sie keinen durchgängigen Plugin-Erfolg, bis ein Zielrechner einen echten Straßen-Upload, eine Veröffentlichung, einen Download und eine SHA-256-Verifizierung abgeschlossen hat.