Conecta tu agente

La CLI lo configura todo. Para hacerlo a mano, apunta cualquier cliente MCP a la dirección MCP de tu organización.

Cada organización tiene su propio servidor MCP en https://{org}-mcp.sddvault.com/mcp, por ejemplo https://acme-mcp.sddvault.com/mcp. Usa el transporte Streamable HTTP y en tu agente se llama sdd-vault.

El agente puede iniciar sesión de dos maneras:

  • Inicio de sesión en el navegador (recomendado): el agente abre el inicio de sesión de tu organización la primera vez que se conecta. No se guarda ningún secreto en ningún archivo, así que la configuración se puede subir al repositorio.
  • Token de agente: para CI, máquinas remotas y agentes que no pueden abrir un navegador. Consulta Tokens de agente.

Claude Code

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

Después ejecuta claude y pregunta "muestra el estado del proyecto".

Cursor, VS Code, Windsurf y otros clientes

sddvault init escribe el archivo que lee cada agente: .mcp.json (Claude Code y otros clientes), .cursor/mcp.json, .vscode/mcp.json y, para Windsurf, ~/.codeium/windsurf/mcp_config.json. Elige los agentes con --agent (claude, cursor, vscode, windsurf o generic), repetido para varios.

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

Escrito a mano, .mcp.json queda así:

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

Cursor usa el mismo contenido sin el campo type, en .cursor/mcp.json. VS Code usa la clave servers en lugar de mcpServers, en .vscode/mcp.json.

Con un token

Con un token, el agente envía Authorization: Bearer seguido del token. Guarda el token en la variable de entorno SDD_VAULT_TOKEN para no subir nunca un secreto al repositorio.

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}" } } } }
Crea los tokens en la aplicación, en Tokens de agente, o con sddvault tokens create. El token se muestra una sola vez; cópialo enseguida.