Pular para o conteúdo
DocAuto
Servidor MCP

Use a DocAuto pela sua IA

O MCP (Model Context Protocol) é um padrão aberto. Funciona com qualquer assistente compatível com MCP — Claude, Cursor, VS Code, Cline, Zed e outros — a critério do usuário.

Atualizado em junho de 2026

O que é

Em vez de você programar contra a API, a sua IA chama as ferramentas da DocAuto por você, em linguagem natural. Há dois servidores: o hospedado (conector remoto, sem instalar nada) e o local (roda na sua máquina e lê/salva arquivos nela).

ServidorIdeal paraLogin
Hospedado (remoto)Clientes que aceitam conector por URLPelo navegador (OAuth)
Local (stdio)Clientes de desktop, arquivos na sua máquinalogin_start / login_finish

Servidor hospedado (conector remoto)

É o jeito mais simples: você adiciona a DocAuto como servidor remoto informando uma URL, faz login pelo navegador e pronto.

  1. 1No seu cliente de IA, abra as configurações de conectores/MCP e escolha adicionar um servidor remoto (por URL).
  2. 2Informe a URL: https://mcp.docauto.com.br/mcp
  3. 3O cliente abre o login da DocAuto no navegador. Entre com e-mail/senha ou Google e autorize.
  4. 4As ferramentas da DocAuto passam a aparecer na conversa.

Onde colar a URL muda um pouco por cliente, mas a ideia é a mesma:

ClienteOnde adicionar
Claude (web/desktop)Configurações → Conectores → Adicionar conector personalizado
CursorSettings → MCP → Add server (tipo URL)
VS CodeArquivo mcp.json / configuração de MCP servers (tipo URL)
Outros compatíveisCampo de servidor remoto/URL do cliente

Clientes que usam um arquivo de configuração costumam aceitar este formato:

{
  "mcpServers": {
    "docauto": {
      "url": "https://mcp.docauto.com.br/mcp"
    }
  }
}

No Claude Code (CLI), basta um comando:

claude mcp add --transport http docauto https://mcp.docauto.com.br/mcp

É a sua conta DocAuto de sempre — o conector não cria outro tipo de conta. A autorização é feita com segurança pelo navegador (OAuth); a IA nunca vê a sua senha.

Servidor local (stdio)

Se você prefere que os arquivos sejam lidos e salvos direto na sua máquina, rode o servidor local. É um pacote Python (precisa do Python 3.11 ou superior).

# run on demand, no install:
uvx docauto-mcp
# or install it:
pipx install docauto-mcp

A forma mais fácil de registrar no Claude Desktop é o comando auxiliar — ele edita o claude_desktop_config.json por você (e acerta o caminho da versão da Store no Windows):

docauto-mcp-install

Prefere editar à mão? Aponte para o claude_desktop_config.json:

{
  "mcpServers": {
    "docauto": {
      "command": "docauto-mcp"
    }
  }
}

No Claude Code (CLI):

claude mcp add docauto -- uvx docauto-mcp
  1. 1Peça à IA para chamar login_start — ela devolve uma URL e um código curto.
  2. 2Abra a URL, entre (e-mail/senha ou Google) e aprove o código.
  3. 3Peça para chamar login_finish — conclui o login e guarda seus tokens (renovados sozinhos).
  4. 4A qualquer momento, peça para chamar doctor — ele confere conexão, login e versão.

Os tokens ficam só na sua máquina, em ~/.docauto/mcp-tokens.json. No modo local, o download salva o ZIP direto na sua pasta de Downloads.

Ferramentas disponíveis

GrupoFerramentas
Sessãologin_start, login_finish, logout, whoami, doctor, workflow_guide
Templateslist_templates, get_template, upload_template, delete_template
Datasetslist_datasets, get_dataset, preview_dataset, upload_dataset, delete_dataset
Geraçãovalidate_mapping, create_generation_job, get_job, list_jobs, cancel_job, delete_job, list_job_documents
Arquivosdownload_document, download_job_zip, request_upload_url, check_upload

Exemplos de conversa

Dica: muitos clientes expõem o prompt guiado generate_documents, que conduz todo o fluxo do início ao fim.

VocêGere contratos para todos os clientes da minha planilha usando o template de contrato.
Agente IAEncontrei o template “Contrato” (variáveis: nome_cliente, cpf) e o dataset “clientes.csv” (colunas: nome_cliente, cpf). Vou mapear nome_cliente→nome_cliente e cpf→cpf e criar o job em PDF. Confirma?
VocêConfirmo.
Agente IAJob concluído: 128 documentos gerados. Aqui está o link para baixar o ZIP (válido por alguns minutos): https://api.docauto.com.br/…

Enviar e baixar arquivos

No servidor hospedado, os arquivos não passam pelo chat. Para enviar, a IA te dá o link de uma página segura da DocAuto onde você sobe o arquivo; depois ela acompanha o resultado. Para baixar, ela devolve um link assinado de curta duração.

VocêQuero usar um novo template que está no meu computador.
Agente IANo modo conector eu não recebo o arquivo pelo chat. Abra este link seguro para enviar o template: https://docauto.com.br/upload?… — assim que você subir, eu continuo.
VocêPronto, enviei.
Agente IARecebido! O template “Proposta” tem as variáveis: cliente, valor, prazo. De qual planilha você quer gerar?

No servidor local não há essa etapa: a IA lê o arquivo do caminho que você indicar e salva o resultado na sua máquina.