fin-claude-plugin

Processa fatura de cartão de crédito em lote e lança no FIN App via fin_fatura_transacoes (NÃO via despesa avulsa, regra de negócio do FIN). Aceita 5 formatos (preferência: OFX > CSV > CNAB 240 > texto colado > PDF). Identifica o cartão automaticamente, detecta período REAL da fatura (importante: pode variar do ciclo cadastrado), trata estorno (reversal_of_id) e parcelamento sem duplicar. Garante idempotência. No fim, oferece pagar a fatura via fin_pagar_fatura.

Lançamento avulso de transação no FIN App. Entende instruções em linguagem natural ("lança 45 no mercado, débito [conta]", "20 conto no pão, dinheiro", "saquei 200 no Itaú", "recebi 4mil do cliente X", "vendi $100 e veio R$540", "tô com $487 na carteira"), aplica regras aprendidas de Estabelecimentos.md, trata dinheiro vivo, saque, câmbio USD/BRL e ajuste de saldo corretamente, sempre confirma em uma linha antes de criar. Aprende e atualiza memória.

Conciliação de uma conta ou cartão em um período: compara o que tá lançado no FIN com o que tá num extrato/fatura externo, mostra o que bate, o que só está no FIN, o que só está no extrato, suspeitos de duplicata e divergências de valor. Pessoa decide o que fazer com cada divergência (lançar o que falta, deletar o que sobra, marcar como conferido). Atualiza Status Conciliação.md no fim. Use quando a pessoa pedir "concilia conta X de mês Y" ou "tá batendo o saldo?".

Processa extrato bancário em lote e lança no FIN App. Aceita 5 formatos (preferência: OFX > CSV > CNAB 240 > texto colado > PDF). Garante idempotência (FITID pra OFX, hash pros outros). Categoriza automaticamente via Estabelecimentos.md, mostra tabela pra revisão, lança em batch e atualiza memória + Status Conciliação.md. Use quando a pessoa colar/anexar o extrato de uma conta corrente, poupança ou conta digital.

Onboarding completo do FIN App. Três modos: Modo A (questionário guiado em 6 blocos, do zero) — Modo B (importação de documento de setup pronto) — Modo C (aprendizado retroativo, quando o FIN já tem contas/categorias/histórico e o plugin precisa só aprender o que já existe e popular a memória). Use quando o FIN da pessoa estiver vazio, quando ela tiver um documento pronto, ou quando ela já usa o FIN há tempo mas é a primeira vez rodando o plugin. Idempotente: rodar 2x não duplica nada.

Skill de FALLBACK pra configurar o MCP server do FIN App. A partir da v0.2.0, o plugin já declara o fin-app-mcp via .mcp.json e pede a API key automaticamente no install (userConfig sensitive). Essa skill só roda se o método automático falhar OU se a pessoa precisar atualizar/revogar a chave manualmente. Guia: gerar API key, editar config (Desktop) ou rodar claude mcp add (Code), troubleshooting de erros comuns.