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
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.
Écrit à la main, .mcp.json ressemble à ceci :
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.
sddvault tokens create. Un jeton n’est affiché qu’une fois ; copiez-le tout de suite.