Agenten verbinden

Die CLI richtet alles ein. Von Hand richtest du einen beliebigen MCP-Client auf die MCP-Adresse deiner Organisation.

Jede Organisation hat ihren eigenen MCP-Server unter https://{org}-mcp.sddvault.com/mcp, zum Beispiel https://acme-mcp.sddvault.com/mcp. Er nutzt den Streamable-HTTP-Transport und heißt in deinem Agenten sdd-vault.

Der Agent kann sich auf zwei Arten anmelden:

  • Anmeldung im Browser (empfohlen): Der Agent öffnet beim ersten Verbinden die Anmeldung deiner Organisation. Es wird kein Geheimnis in einer Datei gespeichert, die Konfiguration kann also eingecheckt werden.
  • Agent-Token: für CI, entfernte Rechner und Agenten, die keinen Browser öffnen können. Siehe Agent-Tokens.

Claude Code

Terminal
claude mcp add --transport http sdd-vault https://{org}-mcp.sddvault.com/mcp

Starte dann claude und frage „zeige den Projektstatus“.

Cursor, VS Code, Windsurf und andere Clients

sddvault init schreibt die Datei, die jeder Agent liest: .mcp.json (Claude Code und andere Clients), .cursor/mcp.json, .vscode/mcp.json und für Windsurf ~/.codeium/windsurf/mcp_config.json. Wähle die Agenten mit --agent (claude, cursor, vscode, windsurf oder generic), für mehrere wiederholt.

Terminal
sddvault init your-org/your-project --agent claude --agent cursor

Von Hand geschrieben sieht .mcp.json so aus:

.mcp.json
{ "mcpServers": { "sdd-vault": { "type": "http", "url": "https://acme-mcp.sddvault.com/mcp" } } }

Cursor verwendet denselben Inhalt ohne das Feld type, in .cursor/mcp.json. VS Code verwendet statt mcpServers den Schlüssel servers, in .vscode/mcp.json.

Mit einem Token

Mit einem Token sendet der Agent Authorization: Bearer gefolgt vom Token. Halte das Token in der Umgebungsvariable SDD_VAULT_TOKEN, damit nie ein Geheimnis eingecheckt wird.

Terminal
claude mcp add --transport http sdd-vault https://{org}-mcp.sddvault.com/mcp \ --header "Authorization: Bearer $SDD_VAULT_TOKEN"
.mcp.json
{ "mcpServers": { "sdd-vault": { "type": "http", "url": "https://acme-mcp.sddvault.com/mcp", "headers": { "Authorization": "Bearer ${SDD_VAULT_TOKEN}" } } } }
Erstelle Tokens in der App unter Agent-Tokens oder mit sddvault tokens create. Ein Token wird nur einmal angezeigt; kopiere es sofort.