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

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

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.

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

Escrito à mão, o .mcp.json fica assim:

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

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.

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}" } } } }
Crie os tokens na aplicação, em Tokens de agente, ou com sddvault tokens create. O token é mostrado uma única vez; copie-o logo.