Academy
CLI e MCP

CLI Dattos: instalação e primeiros passos

A CLI Dattos é a interface de linha de comando da plataforma — feita para operar a Dattos por scripts, pipelines de automação e agentes de inteligência artificial. Toda saída é em JSON (fácil de tratar em qualquer linguagem ou com jq), os erros saem estruturados com orientação de correção, e a mesma instalação traz também o SDK Python e o servidor MCP para assistentes de inteligência artificial.

Requisitos e instalação

  • Python 3.11 ou superior, em qualquer sistema operacional.

  • Instale com o pip:

pip install dattos

  • Confira a instalação:

dattos version

A instalação disponibiliza três comandos: dattos (a CLI), dattos-mcp (servidor MCP para assistentes de inteligência artificial) e dattos-mcp-http (variante do servidor para uso hospedado).

Autenticação

  1. Gere sua chave de API na plataforma: acesse o seu perfil (menu Meu Perfil > Chave de API), crie uma nova chave e copie o valor gerado — ele começa com api-.

  2. Configure a CLI com a sua instância e a chave:

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

No api-url, basta o nome da instância — a CLI completa para https://minha-empresa.dattos.com.br/dattos.api.

Alternativas:

  • dattos auth login — login interativo com usuário e senha (gera um token de sessão).

  • dattos auth login --browser — abre a página da chave de API no navegador para você criar e colar a chave.

  • Variáveis de ambiente, ideais para pipelines de CI/CD: DATTOS_API_URL, DATTOS_API_KEY, DATTOS_FOLDER_ID e DATTOS_PROFILE. As variáveis têm precedência sobre a configuração local.

Segurança das credenciais: a chave é guardada no cofre do sistema operacional (Windows Credential Manager, macOS Keychain ou Secret Service no Linux), nunca em texto puro. A conexão exige HTTPS. Use dattos auth status para conferir o método ativo e dattos auth logout para limpar as credenciais.

Conceitos básicos

  • Pastas: boa parte das operações roda no contexto de uma pasta de execução. Selecione com dattos folders select (lista interativa) e confira com dattos folders current.

  • Perfis: para quem trabalha com mais de uma instância ou ambiente, dattos config profile list e dattos config profile switch <nome> alternam configurações completas.

  • Saída e erros: resultados em JSON no stdout; erros em JSON no stderr com campo next_step orientando a correção. Códigos de saída: 0 sucesso, 1 erro da API, 2 erro de autenticação ou configuração — prontos para controle de fluxo em scripts.

  • Diagnóstico: dattos doctor valida configuração, conectividade e autenticação de uma vez (com --deep, testa também os serviços de inteligência artificial da plataforma).

Primeiro fluxo completo

Criar uma conciliação com o apoio do Dattos AI e executá-la, direto do 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

E consultar o 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

O catálogo completo de comandos está no artigo "CLI Dattos: comandos e capacidades".

Artigos relacionados

  • CLI Dattos: comandos e capacidades

  • Conectar assistentes de inteligência artificial via MCP

  • Chaves de API: gerar e revogar

  • Introdução às integrações

Isso foi útil?