Desenvolvedores

Integre em minutos: SDK TypeScript e Python, CLI e servidor MCP oficiais — todos contra a borda https://api.neovault.com.br com JWT de escopos mínimos.

SDK TypeScript / JavaScript

npm install neovault

import { NeoVault } from 'neovault';
const nv = new NeoVault({ token, purpose: 'atendimento' });

const { id_nome } = await nv.identities.register({
  nome, cpf, dataNascimento: '1990-01-01' });
await nv.contacts.upsert('minha-loja', id_nome, {
  celular: '+5585…', canalPref: 'whatsapp', optinMkt: true });
await nv.optin.aprovar('rede-neovault', {
  idNome: id_nome, evidencia: 'termo-v1:hash:…' });

SDK Python

pip install neovault

from neovault import NeoVault
nv = NeoVault(token=token, purpose="atendimento")

r = nv.register_identity(nome=nome, cpf=cpf,
        data_nascimento="1990-01-01")
nv.upsert_contact("minha-loja", r["id_nome"],
        celular="+5585…", canal_pref="whatsapp",
        optin_mkt=True)
nv.aprovar_optin("rede-neovault", r["id_nome"],
        evidencia="termo-v1:hash:…")

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

MCP (agentes de IA)

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

Escopos

Escopo	Dá acesso a
`vault:register · resolve · shred`	Identidade civil (registro, leitura auditada, eliminação LGPD)
`contact:read · write · delete`	Contato e consentimento por tenant
`optin:read · write · admin`	Opt-in em grupo (aprovação única) — admin é exclusivo do operador
`prefs:read`	Perfil comportamental pseudonimizado
`qsa:read · write`	Vínculos societários

Tokens são emitidos pelo operador com os escopos mínimos e os tenants do seu contrato. Toda leitura de PII exige finalidade (auditada); eventos e perfis comportamentais nunca contêm dados pessoais.