Ir para o conteúdo

Converta seus extratos pelo seu assistente de IA

O servidor MCP do BankConv permite que Claude, Cursor, VS Code e outros assistentes de IA convertam extratos bancários em PDF. Indique ao assistente um PDF do seu computador: ele devolve as transações, com valores com sinal e datas de verdade, ou salva um arquivo CSV, OFX, QFX, QBO ou Xero CSV ao lado do PDF. Você precisa de uma chave de API do BankConv, e um único comando faz a instalação.

npm: bankconv-mcpCódigo-fonte: GitHub (MIT)

Instalação

  1. Entre no BankConv e crie uma chave de API em Equipe → Chaves de API. A chave completa aparece uma única vez: copie-a.
  2. Adicione o servidor ao seu assistente com a chave, usando o trecho do seu aplicativo abaixo.
  3. Reinicie o aplicativo se ele pedir e depois peça a ele que converta um extrato.

Claude Code

claude mcp add bankconv -e BANKCONV_API_KEY=sk_live_your_api_key -- npx -y bankconv-mcp

Claude Desktop

Abra Settings, depois Developer, depois Edit Config, e adicione isto ao claude_desktop_config.json:

{
  "mcpServers": {
    "bankconv": {
      "command": "npx",
      "args": ["-y", "bankconv-mcp"],
      "env": { "BANKCONV_API_KEY": "sk_live_your_api_key" }
    }
  }
}

Cursor, Windsurf e outros aplicativos

Use os mesmos command, args e env na configuração MCP do aplicativo. No Cursor, é ~/.cursor/mcp.json.

VS Code

Adicione isto a .vscode/mcp.json no seu projeto, ou à sua configuração MCP de usuário:

{
  "servers": {
    "bankconv": {
      "command": "npx",
      "args": ["-y", "bankconv-mcp"],
      "env": { "BANKCONV_API_KEY": "sk_live_your_api_key" }
    }
  }
}

O servidor precisa do Node.js 20 ou mais recente. O npx baixa o servidor na primeira execução.

Ferramentas

O assistente escolhe a ferramenta de acordo com o seu pedido. Você não as chama pelo nome.

FerramentaO que faz
convert_statementConverte um PDF do seu computador. Devolve as transações, ou salva um CSV, OFX, QFX, QBO ou Xero CSV ao lado do PDF (ou onde você indicar). Aceita a senha do PDF, se houver.
get_transactionsBusca as transações de uma conversão anterior.
download_statementSalva uma conversão anterior em CSV, OFX, QFX, QBO ou Xero CSV.
list_conversionsLista suas conversões recentes com o status de cada uma.
get_creditsInforma quantas páginas restam na sua conta no período.

O que o assistente recebe

Para as transações, o servidor devolve um resumo curto, em inglês, e depois cada linha em JSON. Saldos iniciais e linhas de totais são retirados, as entradas são positivas e as saídas negativas, e as datas são datas ISO completas mesmo quando o extrato só imprime o dia e o mês. Esta é a resposta para o nosso extrato de exemplo (dados fictícios, Banco do Ipê, setembro de 2026):

9 transactions from 2026-09-01 to 2026-09-30 in BRL.
Account: Banco do Ipê · checking · XXXX4821.
Money in 92774.00, money out -45823.40.
{
  "institution": "Banco do Ipê",
  "country": "BR",
  "account_type": "checking",
  "currency": "BRL",
  "period": {
    "start": "2026-09-01",
    "end": "2026-09-30"
  },
  "transaction_count": 9,
  "transactions": [
    {
      "date": "2026-09-01",
      "description": "PIX ENVIADO FOLHA DE PAGAMENTO",
      "reference": null,
      "amount": "-24800.00",
      "balance": "59323.70"
    },
    {
      "date": "2026-09-02",
      "description": "PIX RECEBIDO COMERCIAL SERRA AZUL",
      "reference": null,
      "amount": "38650.00",
      "balance": "97973.70"
    },
    {
      "date": "2026-09-03",
      "description": "DEB AUTOMATICO ENERGIA ELETRICA",
      "reference": null,
      "amount": "-1842.00",
      "balance": "96131.70"
    },
    …
  ]
}

Para um arquivo, o assistente só recebe onde ele foi salvo, com os avisos que houver, por exemplo um banco que o QuickBooks não reconhece. Os mesmos dados estão disponíveis sem assistente no endpoint de transações da API.

Qual arquivo para qual sistema

PeçaPara usar em
CSVExcel, Google Sheets e a maioria dos outros programas. Para a Conta Azul, abra o CSV no Excel e passe as colunas para a planilha de lançamentos. Em português, o CSV usa ponto e vírgula e vírgula decimal; para o QuickBooks Online, prefira o OFX. Veja extrato bancário PDF para CSV.
OFXOmie, Xero e QuickBooks Online, sem associar colunas. A Conta Azul pede o OFX gerado pelo próprio banco. Veja OFX.
QFXQuicken. Veja QFX.
QBOQuickBooks Desktop (Web Connect), com o identificador do QuickBooks para o seu banco. Veja QBO.
Xero CSVAs colunas CSV do Xero, com as datas na ordem do seu banco. Veja Xero.

Exemplos de pedidos

  • “Converta ~/Downloads/setembro.pdf e me diga minhas dez maiores despesas.”
  • “Converta cada PDF de ~/Extratos/2026 em OFX para importar no Omie.”
  • “Converta extrato-marco.pdf em CSV. A senha do PDF é 4821.”
  • “Some meus gastos por categoria em extrato-setembro.pdf e aponte tudo que pareça uma assinatura.”
  • “Confira se as transações deste extrato chegam ao saldo final impresso.”

Pedir as transações é a parte útil: o assistente pode então somar, categorizar, comparar meses ou conferir o saldo, coisas que numa planilha você faria à mão.

Quanto custa

O servidor é grátis. As conversões usam suas páginas do BankConv, como no site: cada página do PDF conta como uma página. O primeiro extrato de uma conta grátis é convertido de graça, até 5 páginas. Depois, você precisa das páginas mensais de um plano; veja os preços. Pergunte ao assistente “quantas páginas do BankConv ainda tenho?” para conferir.

O que sai do seu computador

  • Para o BankConv: só os PDFs que você indicar, por HTTPS, com a senha se você a informar. O PDF e os arquivos convertidos são excluídos depois de 24 horas por padrão. Veja segurança e tratamento de dados.
  • Para o seu provedor de IA: o que o assistente lê. Ou seja, as transações se você pedir, ou só o caminho do arquivo se pedir um arquivo. Uma senha que você digita faz parte do chat.
  • No seu disco: os arquivos que você pedir, e nada mais. O servidor só lê os arquivos que você indica.

Sua chave de API fica na configuração MCP do seu aplicativo e só é enviada ao BankConv. Você pode revogá-la quando quiser em Equipe → Chaves de API.

Perguntas sobre o servidor MCP

O que é o servidor MCP do BankConv?

Um pequeno programa que permite a um assistente de IA usar o BankConv. MCP (Model Context Protocol) é o padrão que Claude, Cursor, VS Code e outros assistentes usam para chamar ferramentas externas. Com ele, você pede ao assistente que converta um extrato em PDF: ele envia o arquivo, espera a conversão e depois devolve as transações ou salva o arquivo pedido.

Com quais assistentes funciona?

Com qualquer aplicativo que rode servidores MCP locais: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf e outros. Ele roda no seu computador com Node.js 20 ou mais recente, então você precisa de um aplicativo que possa executar um programa local. Os aplicativos de chat que só se conectam a servidores remotos na web, como o ChatGPT, podem usar o servidor remoto https://bankconv.com/mcp: adicione-o como servidor MCP personalizado e faça login com sua conta do BankConv, sem chave de API.

Preciso de um plano pago?

Não para testar. Uma conta grátis do BankConv pode criar uma chave de API, e o primeiro extrato é convertido de graça, até 5 páginas. Depois, as conversões usam as páginas mensais de um plano pago; cada página do PDF conta como uma página do plano.

A IA vê minhas transações bancárias?

Só se você pedir. Se pedir as transações, o servidor passa as linhas ao assistente, e elas chegam ao seu provedor de IA nos termos desse aplicativo, como qualquer coisa que você cola em um chat. Se pedir um arquivo (CSV, OFX, QFX, QBO ou Xero CSV), ele é gravado no seu disco e o assistente só recebe onde ele foi salvo.

Ele lê extratos protegidos por senha ou escaneados?

Sim. Informe a senha no pedido e o servidor a envia junto com o PDF. Os extratos escaneados são lidos por OCR, como no site.

É de código aberto?

Sim, com licença MIT. O código está no GitHub: https://github.com/wassim/bankconv-mcp. É uma camada fina sobre a API pública do BankConv: não faz nada que a sua chave de API não permita.