Collega il tuo agente

La CLI configura tutto. Per farlo a mano, punta qualsiasi client MCP all’indirizzo MCP della tua organizzazione.

Ogni organizzazione ha il proprio server MCP all’indirizzo https://{org}-mcp.sddvault.com/mcp, ad esempio https://acme-mcp.sddvault.com/mcp. Usa il trasporto Streamable HTTP e nel tuo agente si chiama sdd-vault.

L’agente può accedere in due modi:

  • Accesso dal browser (consigliato): l’agente apre l’accesso della tua organizzazione la prima volta che si collega. Nessun segreto viene salvato in un file, quindi la configurazione si può committare.
  • Token dell’agente: per CI, macchine remote e agenti che non possono aprire un browser. Vedi Token degli agenti.

Claude Code

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

Poi esegui claude e chiedi «mostra lo stato del progetto».

Cursor, VS Code, Windsurf e altri client

sddvault init scrive il file che ogni agente legge: .mcp.json (Claude Code e altri client), .cursor/mcp.json, .vscode/mcp.json e, per Windsurf, ~/.codeium/windsurf/mcp_config.json. Scegli gli agenti con --agent (claude, cursor, vscode, windsurf o generic), ripetuto per più agenti.

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

Scritto a mano, .mcp.json appare così:

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

Cursor usa lo stesso contenuto senza il campo type, in .cursor/mcp.json. VS Code usa la chiave servers invece di mcpServers, in .vscode/mcp.json.

Con un token

Con un token, l’agente invia Authorization: Bearer seguito dal token. Tieni il token nella variabile d’ambiente SDD_VAULT_TOKEN così nessun segreto finisce mai nel repository.

Terminale
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}" } } } }
Crea i token nell’app, in Token degli agenti, o con sddvault tokens create. Un token viene mostrato una sola volta; copialo subito.