neovault

SDK, CLI e servidor MCP oficiais do NeoVault — cofre de identidade, consentimento e comportamento pseudonimizado (LGPD by design). Os sistemas consomem dados pessoais por API com finalidade auditada, em vez de guardar o próprio cadastro.

npm install neovault

SDK

import { NeoVault } from 'neovault';

const nv = new NeoVault({ token: process.env.NEOVAULT_TOKEN!, purpose: 'atendimento' });

const { id_nome } = await nv.identities.register({
  nome: 'Maria Silva', cpf: '52998224725', dataNascimento: '1990-01-01',
});
await nv.contacts.upsert('minha-loja', id_nome, {
  celular: '+5585999998888', canalPref: 'whatsapp', optinMkt: true,
});
const perfil = await nv.prefs.profile('minha-loja', id_nome); // pseudonimizado, sem PII

// Opt-in em grupo: aprovação ÚNICA para uma rede nomeada de empresas
await nv.optin.aprovar('rede-neovault', { idNome: id_nome, evidencia: 'termo-v1:hash:...' });

// Eliminação LGPD (crypto-shredding + cascata automática)
await nv.identities.shred(id_nome);

CLI

export NEOVAULT_TOKEN=<jwt do realm>
npx neovault health
npx neovault identity resolve --id <id_nome> --purpose atendimento
npx neovault optin aprovar --grupo rede-neovault --id <id_nome> --evidencia termo-v1
npx neovault help

Operadores emitem tokens com EXT_JWT_SECRET=<segredo> npx neovault mint --sub eduuw --scopes contact:read,prefs:read --tenants eduue.

MCP (agentes)

{
  "mcpServers": {
    "neovault": {
      "command": "npx",
      "args": ["-y", "--package=neovault", "neovault-mcp"],
      "env": { "NEOVAULT_TOKEN": "<jwt do realm>" }
    }
  }
}

Ferramentas: vault_register/resolve/shred, contact_upsert/get, optin_aprovar/revogar/status, prefs_profile, qsa_pessoa/empresa.

Tokens e escopos

JWT HS256 do realm NeoVault com escopos mínimos: vault:register|resolve|shred, contact:read|write|delete, optin:read|write|admin, prefs:read, qsa:read|write — e tenants autorizados. Peça o seu ao operador em https://neovault.com.br.