Datos gobernados para Claude

Esta ruta permite que Claude Code consulte tus contenidos de Google Drive o S3 sin convertir Olivares en un gateway de IA. El control plane trae el contenido a una knowledge base gobernada, registra procedencia por documento y expone por MCP solo las herramientas de retrieval:

Default	Qué significa
KB semántica	embed_policy=model_backed; /status debe mostrar retrieval_semantic=true antes de ingestar.
Fallback visible	Si no hay embedder semántico, el create/ingest de la KB se niega en vez de fingir que los vectores local-hash son semánticos.
Guard ACL-aware	El agente solicitante debe resolver a una identidad vinculada con attr_clearance suficiente y grupos que coincidan con las ACL.
Source scope	Vincula la KB al agente de Claude Code; los subjects fuera de scope fallan cerrado.
Modo live honesto	Una respuesta de conector live lleva source_mode=live; los exports estáticos quedan como source_mode=export y nunca se presentan como live.

1. Guarda la credencial de la fuente

Mantén la credencial de la fuente live en el runtime secret store. La config de la fuente la referenciará como store:<name>, nunca inline.

olivares secrets put \
  --data-dir /var/lib/olivares \
  --name s3/prod-runbooks-read \
  --value-file /run/secrets/s3-prod-runbooks-read \
  --actor platform-operator \
  --reason governed-rag-source-credential

Para Google Drive, guarda el material OAuth que tu despliegue usa para acceso read-only a Drive y usa otro nombre de secreto.

2. Genera la config de governed RAG

Para S3:

olivares quickstart governed-rag \
  --data-dir /var/lib/olivares \
  --tenant-id ten_... \
  --source s3 \
  --source-name prod-runbooks-live \
  --bucket prod-runbooks \
  --prefix claude/ \
  --credential-ref store:s3/prod-runbooks-read \
  --mcp-issuer https://idp.example.com/ \
  --mcp-jwks-url https://idp.example.com/.well-known/jwks.json

Para Google Drive, usa --source gdrive --drive-id <shared-drive-id> y una referencia de credencial de Drive.

El comando escribe:

Fichero	Propósito
sources.json	Registra la content source bajo documents[] con mode=live.
agent-gateway.json	Habilita el MCP resource server con retrieval.enabled=true.
bootstrap-after-login.sh	Crea la KB semántica, ingesta la fuente live, vincula el agente y añade el binding de source scope.

Si el comando avisa que retrieval_semantic=false, configura primero OLIVARES_EMBEDDINGS_*. Una KB model-backed se niega intencionadamente a ingestar con solo el fallback local-hash.

3. Arranca con la config generada

OLIVARES_SOURCES_CONFIG=/var/lib/olivares/quickstart/governed-rag/sources.json \
OLIVARES_AGENT_GATEWAY_CONFIG=/var/lib/olivares/quickstart/governed-rag/agent-gateway.json \
olivares quickstart --data-dir /var/lib/olivares

Completa el setup inicial en consola si es una instalación nueva.

En una instalación nueva, knowledge y sourcescope están desactivados. Como administrador, activa knowledge y sourcescope en Settings > Edition & modules, manteniendo los demás módulos seleccionados activos. Para la CLI, inicia sesión primero como administrador en este motor con olivares login y después ejecuta olivares modules on knowledge y olivares modules on sourcescope. Espera a que termine cada reinicio del motor antes de continuar; las sesiones activas se detienen y se pueden reanudar. De lo contrario, estas llamadas a la API devuelven 404 module_not_enabled.

Después ejecuta el script de bootstrap con un token admin:

OLIVARES_TOKEN=<admin-token> \
OLIVARES_TENANT=ten_... \
/var/lib/olivares/quickstart/governed-rag/bootstrap-after-login.sh

4. Prerrequisito de identidad

El retrieval guard lee hechos de identidad desde el grafo de roster/SCIM. La identidad vinculada debe existir antes de que Claude Code pueda recuperar contenido restringido:

Hecho de identidad	Ejemplo
Subject del token del agente / agent_ref	claude-code-governed
Identidad NHI vinculada	agent:claude-code-governed
Metadata de clearance	attr_clearance=confidential o superior
Membership de grupo	group:engineering que coincida con la ACL del documento

Si el agente no tiene identidad, clearance o grupo coincidente, los chunks restringidos no se devuelven. Si el agente no está vinculado a la KB por source scope, la llamada MCP de retrieval falla cerrado.

5. Apunta Claude Code al MCP

Configura Claude Code con la URL de protected resource que imprime el quickstart, normalmente:

http://127.0.0.1:8446/mcp

El access token presentado a ese MCP resource server debe tener:

Claim/control	Valor requerido
iss	El issuer configurado con --mcp-issuer.
sub	El external id del agente, por ejemplo claude-code-governed.
Scope	knowledge:retrieval:read.
Audience/resource	La URL MCP configurada en agent-gateway.json.

6. Verifica

Ejecuta el E2E demo de referencia:

task demo:governed-rag

Comprueba status semántico, procedencia live, retrieval permitido con scope, no-retrieval por clearance bajo, denegación fuera de scope y source_mode=live en la respuesta MCP.

En despliegues existentes, verifica también un documento real:

curl -sk "$OLIVARES_BASE_URL/v1/m/knowledge/kbs/$KB_ID/documents" \
  -H "Authorization: Bearer $OLIVARES_TOKEN" \
  -H "X-Olivares-Tenant: $OLIVARES_TENANT"

Cada documento ingestado live debe mostrar source_mode: "live". Si dice export, la KB se ingestó desde un fichero export y debe describirse así a los operadores.