next-finance-mcp

next-finance-mcp

MCP Server para o NEXT Finance — conecta o Claude ao seu ERP financeiro com login seguro via browser.

Funcionalidades

• 🔐 Login via browser — credenciais nunca passam pelo chat
• 💾 Sessão persistente — não precisa logar toda vez (válida por 3 dias)
• 💼 Listar carteiras — veja todas as suas carteiras disponíveis
• 🏦 Listar contas — contas correntes, investimentos, cartões, etc.
• 📊 Buscar lançamentos — transações com filtro por data

Instalação no Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "next-finance": {
      "command": "npx",
      "args": ["-y", "next-finance-mcp"]
    }
  }
}

Localização do arquivo:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Reinicie o Claude Desktop após salvar.

Como usar

• Peça ao Claude para fazer login: "Faça login no NEXT Finance"
• O browser abrirá automaticamente com o formulário de login
• Preencha e-mail e senha — as credenciais ficam apenas no browser
• De volta ao Claude, liste as carteiras e comece a usar

Ferramentas disponíveis

Ferramenta	Descrição
login	Abre o browser para login seguro (ou restaura sessão salva)
logout	Encerra a sessão
listar_carteiras	Lista todas as carteiras do usuário
selecionar_carteira	Seleciona uma carteira pelo ID
listar_contas	Lista as contas da carteira selecionada
buscar_lancamentos	Busca lançamentos de uma conta por período

Requisitos

• Node.js 18+
• Conta no NEXT Finance

Licença

MIT