Pessoas e agentes sobre um núcleo compartilhado

A tese central do Notarium: a mesma base de conhecimento está igualmente disponível para pessoas e agentes de IA. Uma pessoa trabalha pela interface web (REST), um agente pelo endpoint MCP embutido, e ambos veem o mesmo grafo de notas sobre um único núcleo portável. Isso não é um "modo bot" pregado por fora — é paridade de recursos por concepção.

Um núcleo, muitos transportes

A arquitetura se apoia em um único princípio: a lógica de domínio vive em um só núcleo, e os transportes apenas adaptam o acesso a ele.

flowchart LR
  human([Pessoa]) -->|REST · editor web| core
  agent([Agente de IA]) -->|MCP · POST /mcp| core
  core[Núcleo do Notarium] --> files[(Arquivos Markdown)]

Quem decide é sempre o núcleo, não o transporte. Por isso uma nota criada por um agente percorre exatamente o mesmo caminho que uma edição feita no editor: é gravada no mesmo arquivo .md, versionada no registro, limitada pelo mesmo acesso e recebe um registro de proveniência.

O que significa "paridade"

A edição de um agente e a edição de uma pessoa são indistinguíveis na forma como são processadas:

Versionamento. Toda edição é uma revisão no registro, vinculada a um notarium-id. Veja Histórico de versões.
Escopo. O token de um agente não concede mais do que a participação do principal: um token somente leitura nem sequer enxerga as ferramentas de escrita. Veja Modelo de acesso.
Proveniência. Cada revisão mostra de onde veio a edição: uma pessoa (user:<nome>), um agente específico (pat:<nome>:<id>) ou um editor de arquivos externo. Quem editou o quê, e como, é sempre transparente.

Proveniência, não anonimato

As edições de um agente não se dissolvem num histórico compartilhado. Você sempre pode abrir uma nota e ver que esta linha específica foi adicionada por um agente específico sob um token específico — e revertê-la se precisar.

Como um agente trabalha

Um agente alcança a base de conhecimento por um único endpoint, POST /mcp — um conjunto restrito de 21 comandos prontos (criar uma nota, recuperar contexto, buscar, gravar memória), e não operações de baixo nível sobre o armazenamento. As ferramentas expressam a intenção, enquanto o sistema impõe a colocação e a classe da nota: o agente endereça um projeto pelo nome, mas não escolhe o espaço nem a classe da nota (uma proteção contra erros).

O ponto de entrada típico é uma chamada start_session: o agente recebe um perfil, a lista de seus projetos e o contexto relevante. A conexão e o conjunto completo de ferramentas estão descritos em Agentes e MCP; o primeiro passo prático é Conectar um agente.

Limites traçados deliberadamente

Um núcleo compartilhado não significa que o agente possa fazer tudo:

Um agente não tem exclusão irreversível. Sobrescrever, sim (é reversível pelo registro); exclusão permanente de contêineres, não.
Sem operações entre espaços. Um agente trabalha estritamente dentro dos espaços que consegue alcançar.
As ferramentas não têm canal para o mundo externo, e conteúdo não confiável nunca é misturado às suas descrições — isso rompe a cadeia "dados privados × entrada não confiável × caminho de saída".
O Notarium deliberadamente não é um produto E2EE: um servidor inteligente precisa ver o conteúdo para oferecer busca, semântica e agentes. A privacidade vem da auto-hospedagem e da posse dos seus arquivos, não da criptografia ponta a ponta.

Mais sobre proteger o perímetro do agente: Segurança e visibilidade.