Cadê Meu Dinheiro

Servidor MCP que sincroniza os dados bancários da sua conexão Meu Pluggy para um Postgres próprio e responde, dentro do Claude Desktop/Code, à pergunta que importa: "para onde foi meu dinheiro esse mês?". Além do resumo de gastos por categoria com comparação mês a mês, dá para definir orçamentos por categoria, buscar transações e criar regras permanentes de categorização que são reaplicadas ao histórico.

São três camadas em um processo Node: o sync (Pluggy → Postgres, via cron de 6 em 6 horas, com janela de sobreposição de 7 dias), o motor de insights (funções puras sobre os dados já persistidos) e a interface MCP (Streamable HTTP protegido por bearer token). O design completo está em docs/superpowers/specs/2026-08-01-cade-meu-dinheiro-design.md e o plano de implementação da Fase 1 em docs/superpowers/plans/2026-08-01-cade-meu-dinheiro-fase1.md.

Pré-requisitos

• Conta no Meu Pluggy com os bancos e cartões já conectados.
• Credenciais de API (clientId e clientSecret) em dashboard.pluggy.ai.
• Os item IDs de cada conexão bancária, copiados do dashboard — é o que o sync percorre.
• Node 22+ e Docker.

Setup local

cp .env.example .env     # preencha as credenciais e o token
docker compose up -d postgres
npm install
npm run dev

O MCP_BEARER_TOKEN deve ser gerado com openssl rand -hex 32.

Testes

Os testes de repositório rodam contra o banco cade_test do compose, então o Postgres precisa estar de pé:

docker compose up -d postgres
npm test

Deploy na VPS

docker compose up -d --build

Sobe o Postgres, o servidor MCP (porta 3333), o n8n e o WAHA. Confira com curl http://localhost:3333/health e docker compose logs mcp-server.

Conectando ao Claude

Claude Code:

claude mcp add --transport http cade-meu-dinheiro http://SEU_IP:3333/mcp --header "Authorization: Bearer SEU_TOKEN"

Claude Desktop: Settings → Connectors → Add custom connector, com a mesma URL e o mesmo header Authorization.

Depois disso, pergunte "para onde foi meu dinheiro esse mês?" — o Claude chama get_spending_summary e responde com os seus números.

Tools disponíveis

Tool	O que faz
get_spending_summary	Gastos do mês por categoria, delta vs. mês anterior e top estabelecimentos
get_budget_status	Orçamento vs. realizado, com projeção linear de fim de mês
search_transactions	Busca por texto, categoria e período
set_budget	Define o limite mensal de uma categoria
set_category_rule	Cria regra de categorização e reaplica ao histórico

Há também o prompt financial-coach, que carrega a persona de coach financeiro já com o seu contexto de orçamento do mês.

Segurança

• Token forte e único (openssl rand -hex 32); trate-o como senha do seu extrato bancário.
• Nunca commite o .env — ele está no .gitignore e deve continuar lá.
• Screenshots e gravações públicas só com dados de sandbox da Pluggy, nunca com os seus.

n8n e WAHA (Fase 2)

Os dois já sobem no compose para você explorar desde já: n8n em http://localhost:5678 e WAHA em http://localhost:3000. As portas ficam presas a 127.0.0.1, então na VPS o acesso é por túnel SSH:

ssh -L 5678:localhost:5678 usuario@vps

Os workflows de alerta por WhatsApp chegam na Fase 2.