CLI: Integraciones y Broker

Dos familias cubren los sistemas externos: integration es setup (connect, confirm, disconnect), y broker es ejecución (operar un provider ya conectado). Están separadas a propósito. Ver Integraciones y Connections para el modelo y Broker para la semántica. Agrega --json a cualquier comando para salida de máquina.

Integraciones (setup)

Comando	Descripción
`integration catalog`	Providers que puedes conectar.
`integration connect <provider>`	Inicia el flujo de autorización.
`integration confirm <provider>`	Persiste la connection tras autorizar.
`integration list`	Tus integraciones conectadas.
`integration rm <id>`	Desconecta (alias: `delete`, `disconnect`); revoca la credencial.

driftless integration catalog
driftless integration connect notion
driftless integration confirm notion
driftless integration list

Broker (operar)

El broker está gated (apagado por defecto en producción) y es fail-closed. driftless broker setup solo imprime guía.

Comando	Descripción
`broker connections`	Tus connections con salud, estado y criterion.
`broker operations [provider]`	Lista operaciones, o busca con `--query`, `--provider`, `--effect read\|write`, `--risk low\|medium\|high`, `--limit`, `--cursor`, `--refresh`.
`broker capabilities <provider>`	El capability directory.
`broker inspect <provider> <op>`	La spec completa de una operación.
`broker invoke <provider> <op> [--input <json>\|@file] [--idempotency-key <k>]`	Ejecuta una operación inline; la clave hace que reintentar una escritura repita el resultado, sin volver a ejecutarla.
`broker criterion <provider> [--add <slug>\|--rm <slug>]`	Sin flags: el contexto EFECTIVO de la connection (criterion resuelto a trust/staleness; léelo antes de trabajar con el provider). Con flags: adjunta o quita un slug de topic criterion.

driftless broker connections
driftless broker operations notion
driftless broker invoke notion <operation> --input @payload.json

Leer y materializar

Comando	Descripción
`broker models <provider>`	Record models importables (syncs habilitados).
`broker records <provider> --model <m>`	Lee los records de un modelo desde el mirror (`--modified-after`, `--cursor`, `--limit`).
`broker document <provider> <externalId>`	Lee el contenido acotado, en vivo y citable de un documento de cualquier content provider (`--max-bytes`).
`broker page <pageId>`	Alias DEPRECADO y exclusivo de Notion para `broker document notion <id>`.
`broker index <provider>`	Materializa connector documents. `--dry-run` previsualiza; también `--model`, `--limit`, `--sample-limit`, `--max-bytes`, `--import-run-id`.
`broker import <provider> --collection <id>`	Importa records del mirror a una Collection mediante su connector mapping guardado (`--model`, `--modified-after`, `--max-pages`).
`broker events [provider]`	El feed de eventos entrantes del provider (`--limit`).

records lee un cache; document lee en vivo; index escribe connector documents propios de Driftless (nunca el provider); import escribe Records de Collection. El retrieve de contexto normal nunca consulta un provider. Un record eliminado en el provider crea una tombstone para su connector document en la siguiente ejecución de index (deja de ser citable); al desconectar se hace soft-delete de todos los documentos del provider.

Gates y grants

Una llamada al broker puede ser rechazada por cualquiera de los tres gates: el flag maestro, el rollout de la lane externa y los grants por principal. Para una llamada de CLI autenticada con tu propia key eres un caller interno (gobernado por identidad y scopes, no por grants); un caller OAuth/MCP sin rostro además necesita el rollout encendido y un grant que coincida. Gestionar grants es solo owner/admin, por la API o el dashboard.

Flags, archivos y JSON

@file lo acepta broker invoke --input.
--json funciona en cada comando.
broker invoke sobre un efecto de escritura requiere un idempotency_key para poder reintentarse con seguridad; las escrituras nunca se reintentan solas.

Relacionado

Integraciones y Connections - la cadena de setup a utilizable y la disponibilidad por provider.
Broker - acciones, gates y semántica de lectura/escritura.

Primeros pasos

Conectar

Conceptos

Trabajar y colaborar

Guías

Agentes

Referencia MCP

Referencia CLI

Referencia API

Plataforma

CLI: Integraciones y Broker

Integraciones (setup)

Broker (operar)

Leer y materializar

Gates y grants

Flags, archivos y JSON

Relacionado

​Integraciones (setup)

​Broker (operar)

​Leer y materializar

​Gates y grants

​Flags, archivos y JSON

​Relacionado

Integraciones (setup)

Broker (operar)

Leer y materializar

Gates y grants

Flags, archivos y JSON

Relacionado