Doklad.ai

Faturamento tcheco para freelancers e pequenas empresas: crie, envie e acompanhe faturas, clientes, despesas, pagamentos e fluxo de caixa a partir do Claude, ChatGPT, Codex, Cursor ou VS Code. Servidor hospedado, login via OAuth.

Ver em doklad.aiExperimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://doklad.ai/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Faturamento e contabilidade via MCP: doklad.ai no Claude, ChatGPT, Codex e Cursor

O Doklad.ai possui seu próprio servidor MCP no endereço https://doklad.ai/mcp. Você o conecta ao Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code ou Gemini CLI e passa a gerenciar faturas, clientes e despesas com uma frase comum — por exemplo, "emitir fatura para a empresa Alfa s.r.o. por 12 horas de consultoria a 1.500 Kč". Você faz login com sua conta doklad.ai via OAuth, sem copiar nenhuma chave para lugar algum. O servidor MCP, assim como todo o doklad.ai, está atualmente gratuito, sem limite de faturas e sem cartão de crédito.

O que é MCP e por que ele diz respeito ao seu faturamento

Model Context Protocol (MCP) é um padrão aberto pelo qual o assistente de IA chama ferramentas de outros aplicativos. Uma única interface funciona no Claude, ChatGPT, Codex, Cursor, VS Code e outras ferramentas, então você conecta o doklad.ai em qualquer lugar onde estiver trabalhando.

Sem MCP, a IA apenas dá conselhos sobre faturamento. Com o servidor MCP do doklad.ai, ela mesma lê suas faturas, encontra o cliente, emite o documento, envia por e-mail ou registra o pagamento — diretamente na sua conta, com seu consentimento e com registro no log de auditoria.

O que a IA consegue fazer com o doklad.ai

O servidor MCP do doklad.ai oferece 17 ferramentas:

  • Faturas: busca e filtros (status, cliente, período), detalhes com itens, emissão, edição, envio por e-mail, link para PDF, registro de pagamento e exclusão de rascunho.
  • Clientes: busca por nome, CNPJ/CPF ou e-mail, detalhes, criação e edição.
  • Despesas: lista, detalhes e registro de nova despesa.
  • Relatórios: estatísticas de faturas (pagas, enviadas, vencidas, rascunhos) e fluxo de caixa — receitas, despesas e lucro no período selecionado.

O que você pode escrever para a IA

  • "Quais faturas estão vencidas e quanto me devem no total?"
  • "Emitir fatura para a empresa Alfa s.r.o. por 12 horas de consultoria a 1.500 Kč sem IVA, vencimento em 14 dias."
  • "Enviar a fatura 2026-0142 ao cliente por e-mail."
  • "Recebi o pagamento de 18.150 Kč referente à fatura 2026-0137; registrar o pagamento com data de hoje."
  • "Como foi o fluxo de caixa em setembro e como ele se compara a agosto?"
  • "Registrar despesa: hospedagem de setembro, 990 Kč sem IVA, data de hoje."

A IA monta sozinha as etapas necessárias — primeiro encontra o cliente, depois emite a fatura. Além disso, o doklad.ai a instrui a sempre confirmar com você antes de enviar e-mail, registrar pagamento ou excluir.

Endereço do servidor e login

O endereço do servidor MCP é o mesmo para todos os aplicativos:

https://doklad.ai/mcp

Você faz login com sua conta doklad.ai via OAuth: o aplicativo de IA redireciona você para o doklad.ai, onde você seleciona a empresa e permite o acesso. A IA nunca vê sua senha e você não copia nenhuma chave. Para ferramentas sem OAuth (n8n, scripts próprios), há uma chave de API disponível.

Claude: claude.ai, Claude Desktop e celular

  1. No claude.ai, abra Customize → Connectors e clique em Add custom connector — ou use diretamente o link pré-preenchido.
  2. Como nome, insira Doklad.ai, como URL https://doklad.ai/mcp, mantenha o login em Sign in now e adicione o conector.
  3. O doklad.ai será aberto — faça login, selecione a empresa e permita o acesso.
  4. No chat, ative o doklad.ai no menu de ferramentas e escreva, por exemplo, "Quais faturas estão vencidas?".

O conector conectado funciona na web, no aplicativo Claude Desktop e no aplicativo móvel Claude. Conectores personalizados estão disponíveis em todos os planos do Claude; no Free, apenas um é permitido. Nos planos Team e Enterprise, o proprietário da organização adiciona o conector primeiro em Organization settings → Connectors → Add → Custom → Web, e os membros apenas conectam com sua conta doklad.ai.

ChatGPT

  1. No ChatGPT na web, abra Settings → Security and login e ative o Developer mode.
  2. Abra chatgpt.com/plugins, clique em + e preencha o nome Doklad.ai, uma breve descrição e, como conexão (Connection), o endereço https://doklad.ai/mcp com autenticação OAuth.
  3. Faça login no doklad.ai, selecione a empresa e permita o acesso.
  4. Em um novo chat, selecione o doklad.ai no menu de ferramentas e escreva normalmente em português.

O modo de desenvolvedor está disponível nos planos Plus, Pro, Business, Enterprise e Edu no site do ChatGPT. Antes de uma ação que altera algo (emissão de fatura, envio de e-mail), o ChatGPT pede confirmação.

Claude Code

claude mcp add --transport http doklad https://doklad.ai/mcp

Depois, no Claude Code, escreva /mcp, selecione doklad e escolha Authenticate — o navegador abrirá com o login do doklad.ai. O botão --scope user disponibiliza o doklad.ai em todos os seus projetos.

OpenAI Codex (CLI, VS Code, aplicativo desktop)

codex mcp add doklad --url https://doklad.ai/mcp
codex mcp login doklad

O comando login abre o navegador com o login do doklad.ai. A configuração é salva em ~/.codex/config.toml, compartilhada pelo Codex CLI, pela extensão Codex para VS Code e pelo aplicativo desktop ChatGPT, então basta adicionar o doklad.ai uma vez. Verifique o status com o comando codex mcp list — no doklad.ai deve aparecer OAuth. O Codex está incluído em todos os planos do ChatGPT, inclusive no Free.

Cursor

A forma mais rápida é pelo botão Adicionar ao Cursor nesta página. Manualmente, no arquivo ~/.cursor/mcp.json (todos os projetos) ou .cursor/mcp.json (um projeto), adicione:

{
  "mcpServers": {
    "doklad": {
      "url": "https://doklad.ai/mcp"
    }
  }
}

Em Cursor Settings → Tools & MCP, aparecerá uma solicitação de login para o doklad.ai. Após clicar, o doklad.ai será aberto, onde você seleciona a empresa e permite o acesso.

VS Code com GitHub Copilot

A forma mais rápida é pelo botão Adicionar ao VS Code nesta página. Manualmente, no arquivo .vscode/mcp.json no projeto (ou pelo comando MCP: Add Server), adicione:

{
  "servers": {
    "doklad": {
      "type": "http",
      "url": "https://doklad.ai/mcp"
    }
  }
}

Na primeira execução do servidor, o VS Code perguntará sobre o login no doklad.ai. As ferramentas são então usadas pelo GitHub Copilot no chat em modo Agent. Você precisa do VS Code 1.99 ou superior; nos planos Copilot Business e Enterprise, o administrador da organização deve permitir a política MCP servers in Copilot.

Gemini CLI

gemini mcp add --scope user --transport http doklad https://doklad.ai/mcp

Sem --scope user, o servidor é adicionado apenas ao projeto atual. No Gemini CLI, execute /mcp auth doklad e faça login no navegador.

Chave de API: n8n, scripts e ferramentas sem OAuth

A chave de API é criada no doklad.ai em Integrações → Chaves de API e webhooks → Servidor MCP. A ferramenta de IA a envia no cabeçalho Authorization: Bearer dk_…. A chave pertence a uma variável de ambiente, não a arquivos que você compartilha ou envia para o repositório.

Claude Code:

claude mcp add --transport http doklad https://doklad.ai/mcp --header "Authorization: Bearer $DOKLAD_API_KEY"

Codex (~/.codex/config.toml):

[mcp_servers.doklad]
url = "https://doklad.ai/mcp"
bearer_token_env_var = "DOKLAD_API_KEY"

Claude Desktop via bridge mcp-remote (Node.js 20.18 ou superior) em claude_desktop_config.json — abra-o em Settings → Developer → Edit Config e, após a edição, feche completamente o aplicativo e abra novamente. O espaço após Bearer pertence à variável, não ao argumento; caso contrário, o Claude Desktop no Windows o dividirá:

{
  "mcpServers": {
    "doklad": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://doklad.ai/mcp", "--header", "Authorization:${DOKLAD_AUTH_HEADER}"],
      "env": { "DOKLAD_AUTH_HEADER": "Bearer dk_VAS_KLIC" }
    }
  }
}

No n8n, use o nó MCP Client Tool: Endpoint https://doklad.ai/mcp, Server Transport HTTP Streamable, Authentication Bearer Auth com a chave dk_….

Segurança e controle sobre os dados

  • OAuth 2.1 com PKCE. O aplicativo de IA nunca vê sua senha. Ele recebe um token para uma única empresa, válido por uma hora e renovado continuamente.
  • Consentimento com seleção de empresa. Na página do doklad.ai, você vê qual aplicativo solicita acesso e para onde retornaremos após a permissão. Apenas o proprietário ou administrador da empresa pode conectar a IA.
  • Revogação com um clique. Todas as conexões estão em Integrações → Chaves de API e webhooks → Aplicativos conectados.
  • Log de auditoria. Cada chamada de ferramenta é registrada no log de auditoria da empresa.
  • Cautela em alterações. Ferramentas que alteram algo ou enviam dados para fora são marcadas no MCP, e os aplicativos de IA as executam, por padrão, somente após sua confirmação. Apenas rascunhos ou faturas canceladas podem ser excluídos.
  • Limite de requisições. No máximo 60 chamadas por minuto por empresa, para que uma IA em loop não cause danos.
  • Impressões digitais em vez de segredos. Tokens e chaves de API não ficam legíveis no banco de dados, apenas suas impressões digitais.

Faturamento ou contabilidade?

O Doklad.ai cobre faturamento, registro de despesas, conciliação de pagamentos e relatórios para autônomos e pequenas empresas. A contabilidade de partidas dobradas e as declarações de impostos continuam com o contador — você entrega os documentos por exportação, por exemplo, para Pohoda ou Money S3. Pelo MCP, a IA prepara e confere os documentos para a contabilidade, não o balanço contábil. Um contador que sabe trabalhar com o doklad.ai pode ser encontrado no catálogo de contadores.

Quanto custa

O servidor MCP, assim como todo o doklad.ai, está atualmente gratuito, sem limite de faturas e sem cartão de crédito. A assinatura do próprio aplicativo de IA (Claude, ChatGPT, Cursor…) é paga ao respectivo provedor; alguns aplicativos oferecem conectores próprios apenas em planos pagos. Como o doklad.ai se compara a Fakturoid, Fakturujsi.cz, Taxorio e outros, veja a comparação de servidores MCP para faturamento.

Perguntas frequentes

O que é o servidor MCP do doklad.ai?

Uma interface baseada no padrão aberto Model Context Protocol no endereço https://doklad.ai/mcp. Por meio dela, assistentes de IA como Claude, ChatGPT, Codex ou Cursor leem e gerenciam suas faturas, clientes e despesas no doklad.ai.

Preciso de uma chave de API para conectar?

Não. Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code e Gemini CLI fazem login com a conta doklad.ai via OAuth. A chave de API é apenas para ferramentas sem OAuth, como n8n ou scripts próprios.

A IA pode enviar ou excluir uma fatura sem meu conhecimento?

Ferramentas que alteram algo ou enviam dados para fora são marcadas no MCP, e os aplicativos de IA as executam, por padrão, somente após sua confirmação. Apenas rascunhos ou faturas canceladas podem ser excluídos, e cada chamada é registrada no log de auditoria da empresa.

A qual empresa a IA se conecta?

Àquela que você selecionar ao permitir o acesso. O acesso vale para uma única empresa; para outra empresa, cancele a conexão e conecte-se novamente.

Como cancelo o acesso da IA?

No doklad.ai, em Integrações → Chaves de API e webhooks → Aplicativos conectados, ou removendo o conector diretamente no aplicativo de IA.

Quanto custa o servidor MCP do doklad.ai?

O servidor MCP, assim como todo o doklad.ai, está atualmente gratuito, sem limite de faturas e sem cartão de crédito. A assinatura do próprio aplicativo de IA (Claude, ChatGPT, Cursor…) é paga ao respectivo provedor; alguns aplicativos oferecem conectores próprios apenas em planos pagos.

O doklad.ai também faz contabilidade via MCP?

O Doklad.ai cobre faturamento, despesas, conciliação de pagamentos e relatórios. A contabilidade de partidas dobradas é feita pelo contador; você entrega os documentos por exportação (por exemplo, para Pohoda ou Money S3). Pelo MCP, a IA prepara os documentos para a contabilidade, não o balanço contábil.

Funciona com dados do Fakturoid ou iDoklad?

O servidor MCP trabalha com dados no doklad.ai. Do Fakturoid e do iDoklad, você os transfere pelo assistente em Integrações → Importação de dados: clientes, faturas com itens e PDFs, além de despesas, são migrados.