Academy
CLI e MCP

Conectar assistentes de inteligência artificial via MCP

O MCP (Model Context Protocol) é o padrão aberto que conecta assistentes de inteligência artificial a sistemas externos. Com o servidor MCP da Dattos, o seu assistente — Claude, ChatGPT, Cursor e outros — passa a operar a plataforma em linguagem natural: cria e executa fluxos de conciliação, consulta resultados, gera relatórios e administra cadastros, sempre com as permissões do usuário conectado.

O que fica disponível para o assistente

O servidor MCP expõe cerca de 70 ferramentas cobrindo o ciclo completo da plataforma:

  • Construção de fluxos: criar análises, adicionar fontes de dados e montar pipelines com o apoio do Dattos AI.

  • Execução: disparar e retomar execuções por data de referência e acompanhar o status.

  • Consulta: carregamentos, conjuntos de dados, resultados de conciliação e resumos.

  • Exportação: gerar e baixar relatórios.

  • Administração: usuários, perfis, conectores e pastas.

Não é uma superfície somente leitura — o assistente executa ações reais. Por isso, tudo roda com a chave de API do próprio usuário: o assistente enxerga e faz exatamente o que aquele usuário pode, nada além.

Escopo atual: as ferramentas cobrem a Automação de Processos e a administração da plataforma. Os módulos Comprovação de Contas e Gestão de Tarefas ainda não estão disponíveis via MCP — a cobertura está prevista na evolução do produto.

Caminho 1 — Instalar no seu assistente (local)

Com a CLI Dattos instalada e autenticada (veja "CLI Dattos: instalação e primeiros passos"), um único comando configura o servidor MCP na ferramenta:

dattos mcp install <ferramenta>

Ferramentas suportadas: claude-code, claude-desktop, cursor, vscode, windsurf, gemini, chatgpt e copilot-studio. O comando escreve a entrada do servidor dattos no arquivo de configuração da ferramenta (para as opções em nuvem, exibe as instruções de conexão). Sem argumento, dattos mcp install lista os alvos disponíveis.

Depois de instalar, reinicie o assistente e peça, por exemplo: "liste minhas análises de conciliação na Dattos e execute a de vendas para 30/06".

Caminho 2 — Conector hospedado (para assistentes na nuvem)

Para assistentes que rodam na nuvem (conectores do Claude.ai, ChatGPT, n8n), a Dattos disponibiliza um gateway MCP hospedado, sem instalação local: a ferramenta se conecta por HTTP informando a URL do gateway e dois cabeçalhos — a chave de API do usuário (Authorization: Bearer api-...) e o endereço da sua instância (X-Dattos-Api-Url).

Habilitação: a disponibilização do conector hospedado para o seu ambiente é feita junto à equipe da Dattos — fale com o seu gerente de conta ou com o suporte.

Segurança

  • Permissões do usuário, sempre: a credencial usada é a chave de API pessoal — perfis de privacidade, escopo de pastas e permissões valem integralmente para o assistente.

  • Sem custódia de credenciais: no gateway hospedado, a chave viaja em cada requisição e não é armazenada — revogar a chave no seu perfil corta o acesso do assistente.

  • Operações sensíveis restritas: ações privilegiadas e operações que dependem de arquivos locais ficam indisponíveis no modo hospedado.

  • Boas práticas: trate a chave de API como uma senha; prefira um usuário com permissões mínimas para automações; revogue e regenere a chave periodicamente em Meu Perfil > Chave de API.

Artigos relacionados

  • CLI Dattos: instalação e primeiros passos

  • CLI Dattos: comandos e capacidades

  • Chaves de API: gerar e revogar

  • Introdução às integrações

Isso foi útil?