Academy
CLI y MCP

CLI Dattos: instalación y primeros pasos

CLI Dattos es la interfaz de línea de comandos de la plataforma, hecha para operar Dattos mediante scripts, pipelines de automatización y agentes de inteligencia artificial. Toda la salida está en JSON (fácil de procesar en cualquier lenguaje o con jq), los errores se devuelven estructurados con orientación para corregirlos, y la misma instalación también incluye el SDK de Python y el servidor MCP para asistentes de inteligencia artificial.

Requisitos e instalación

  • Python 3.11 o superior, en cualquier sistema operativo.

  • Instala con pip:

pip install dattos

  • Comprueba la instalación:

dattos version

La instalación proporciona tres comandos: dattos (la CLI), dattos-mcp (servidor MCP para asistentes de inteligencia artificial) y dattos-mcp-http (variante del servidor para uso alojado).

Autenticación

  1. Genera tu clave de API en la plataforma: accede a tu perfil (menú Mi Perfil > Clave de API), crea una nueva clave y copia el valor generado — empieza con api-.

  2. Configura la CLI con tu instancia y la clave:

dattos config set api-url "minha-empresa"
dattos config set api-key "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

En api-url, basta con el nombre de la instancia — la CLI completa a https://minha-empresa.dattos.com.br/dattos.api.

Alternativas:

  • dattos auth login — inicio de sesión interactivo con usuario y contraseña (genera un token de sesión).

  • dattos auth login --browser — abre la página de la clave de API en el navegador para que crees y pegues la clave.

  • Variables de entorno, ideales para pipelines de CI/CD: DATTOS_API_URL, DATTOS_API_KEY, DATTOS_FOLDER_ID y DATTOS_PROFILE. Las variables tienen prioridad sobre la configuración local.

Seguridad de las credenciales: la clave se guarda en el almacén del sistema operativo (Windows Credential Manager, macOS Keychain o Secret Service en Linux), nunca en texto plano. La conexión requiere HTTPS. Usa dattos auth status para comprobar el método activo y dattos auth logout para borrar las credenciales.

Conceptos básicos

  • Carpetas: gran parte de las operaciones se ejecuta en el contexto de una carpeta de ejecución. Selecciónala con dattos folders select (lista interactiva) y compruébala con dattos folders current.

  • Perfiles: para quienes trabajan con más de una instancia o entorno, dattos config profile list y dattos config profile switch <nome> alternan configuraciones completas.

  • Salida y errores: resultados en JSON en stdout; errores en JSON en stderr con el campo next_step orientando la corrección. Códigos de salida: 0 éxito, 1 error de la API, 2 error de autenticación o configuración — listos para el control de flujo en scripts.

  • Diagnóstico: dattos doctor valida configuración, conectividad y autenticación de una sola vez (con --deep, también prueba los servicios de inteligencia artificial de la plataforma).

Primer flujo completo

Crear una conciliación con el apoyo de Dattos AI y ejecutarla, directamente desde la terminal:

dattos folders select 2473
dattos etl create --name "Conciliação Vendas"
dattos etl add-source --etl 891 --file vendas.xlsx
dattos etl add-source --etl 891 --file extrato.csv
dattos etl pipeline create "Conciliar vendas com extrato por valor e data" --etl 891
dattos etl start 891 --date 2026-06-30 --wait

Y consultar el resultado:

dattos etl execution-status 891 --date 2026-06-30
dattos matching status 891 <loadId> <matchingId>
dattos reports generate 891 --load-id <loadId> --dataset-id <datasetId> --format csv

El catálogo completo de comandos está en el artículo "CLI Dattos: comandos y capacidades".

Artículos relacionados

  • CLI Dattos: comandos y capacidades

  • Conectar asistentes de inteligencia artificial vía MCP

  • Claves de API: generar y revocar

  • Introducción a las integraciones

¿Te fue útil?