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

1. Peça ao Claude para fazer login: "Faça login no NEXT Finance"
2. O browser abrirá automaticamente com o formulário de login
3. Preencha e-mail e senha — as credenciais ficam apenas no browser
4. 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