Ligar o seu agente
A CLI configura tudo. Para o fazer à mão, aponte qualquer cliente MCP para o endereço MCP da sua organização.
Cada organização tem o seu próprio servidor MCP em https://{org}-mcp.sddvault.com/mcp, por exemplo https://acme-mcp.sddvault.com/mcp. Usa o transporte Streamable HTTP e no seu agente chama-se sdd-vault.
O agente pode iniciar sessão de duas formas:
- Início de sessão no navegador (recomendado): o agente abre o início de sessão da sua organização na primeira ligação. Nenhum segredo fica guardado num ficheiro, pelo que a configuração pode ser submetida ao repositório.
- Token de agente: para CI, máquinas remotas e agentes que não conseguem abrir um navegador. Veja Tokens de agente.
Claude Code
Depois execute claude e pergunte «mostra o estado do projeto».
Cursor, VS Code, Windsurf e outros clientes
O sddvault init escreve o ficheiro que cada agente lê: .mcp.json (Claude Code e outros clientes), .cursor/mcp.json, .vscode/mcp.json e, para o Windsurf, ~/.codeium/windsurf/mcp_config.json. Escolha os agentes com --agent (claude, cursor, vscode, windsurf ou generic), repetido para vários.
Escrito à mão, o .mcp.json fica assim:
O Cursor usa o mesmo conteúdo sem o campo type, em .cursor/mcp.json. O VS Code usa a chave servers em vez de mcpServers, em .vscode/mcp.json.
Com um token
Com um token, o agente envia Authorization: Bearer seguido do token. Guarde o token na variável de ambiente SDD_VAULT_TOKEN para nunca submeter um segredo ao repositório.
sddvault tokens create. O token é mostrado uma única vez; copie-o logo.