Connecter votre agent

La CLI configure tout. Pour le faire à la main, pointez n’importe quel client MCP vers l’adresse MCP de votre organisation.

Chaque organisation a son propre serveur MCP à l’adresse https://{org}-mcp.sddvault.com/mcp, par exemple https://acme-mcp.sddvault.com/mcp. Il utilise le transport Streamable HTTP et s’appelle sdd-vault dans votre agent.

L’agent peut se connecter de deux façons :

  • Connexion par le navigateur (recommandée) : l’agent ouvre la connexion de votre organisation à sa première utilisation. Aucun secret n’est stocké dans un fichier, la configuration peut donc être versionnée.
  • Jeton d’agent : pour la CI, les machines distantes et les agents qui ne peuvent pas ouvrir de navigateur. Voir Jetons d’agent.

Claude Code

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

Lancez ensuite claude et demandez « affiche l’état du projet ».

Cursor, VS Code, Windsurf et autres clients

sddvault init écrit le fichier que lit chaque agent : .mcp.json (Claude Code et autres clients), .cursor/mcp.json, .vscode/mcp.json et, pour Windsurf, ~/.codeium/windsurf/mcp_config.json. Choisissez les agents avec --agent (claude, cursor, vscode, windsurf ou generic), répété pour plusieurs.

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

Écrit à la main, .mcp.json ressemble à ceci :

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

Cursor utilise le même contenu sans le champ type, dans .cursor/mcp.json. VS Code utilise la clé servers au lieu de mcpServers, dans .vscode/mcp.json.

Avec un jeton

Avec un jeton, l’agent envoie Authorization: Bearer suivi du jeton. Gardez le jeton dans la variable d’environnement SDD_VAULT_TOKEN pour ne jamais versionner de secret.

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}" } } } }
Créez les jetons dans l’application, sous Jetons d’agent, ou avec sddvault tokens create. Un jeton n’est affiché qu’une fois ; copiez-le tout de suite.