pluggy-mcp-server

Ein schreibgeschützter MCP-Server, der Ihre persönlichen Finanzdaten (Brazilian Open Finance, über Pluggy) jedem MCP-Client zugänglich macht — Claude Code, Cursor, Cline, Zed.

Eine selbst gehostete Alternative zu kostenpflichtigen „Bank über MCP“-Diensten: Meu Pluggy ist kostenlos und ohne Ablaufdatum für Einzelpersonen, die über die API auf ihre eigenen Daten zugreifen.

Keine Geldbewegungen. Es gibt kein PIX, keine Überweisung, keine Zahlung. Pluggy's PaymentsClient wird nie importiert, und ein Test schlägt fehl, wenn jemand ihn importiert.

Tools

Related MCP server: @gu-does-packages/pluggy-mcp

Einrichtung

1. Verbinden Sie Ihre Banken (einmalig, ~15 Min.)

1. Erstellen Sie ein Konto bei meu.pluggy.ai und verbinden Sie Ihre Banken

2. Erstellen Sie ein Konto bei dashboard.pluggy.ai. Dies startet eine 15-tägige Testversion, die Sie ignorieren können: Pluggy gibt an, dass Sie Ihre Daten auch nach deren Ablauf abrufen können

3. Bevor Sie die Anwendung erstellen, gehen Sie zu Anpassen und fügen Sie den MeuPluggy-Connector zu Ihrer Connector-Liste hinzu. Überspringen Sie dies, wird er später nicht angezeigt

4. Erstellen Sie eine Entwicklungsanwendung und kopieren Sie deren Client ID und Client Secret

5. Öffnen Sie die Demo-Anwendung und verknüpfen Sie Ihr Meu-Pluggy-Konto über die MeuPluggy- OAuth-Autorisierung. Wiederholen Sie dies einmal pro verbundener Bank — Pluggy stellt ein Element pro Bank aus, nicht pro Konto

6. Kopieren Sie die Item-ID jeder Verbindung („Item-ID kopieren“)

Connector 200 fungiert als Proxy über die Verbindungen, die Meu Pluggy besitzt, und aktualisiert sie täglich.

2. Prüfen Sie, was Connector 200 tatsächlich zurückgibt

npm install
npm run setup   # prompts for the credentials, writes .env with mode 0600
npm run probe

npm run setup maskiert das Client-Secret, während Sie es eingeben, generiert das MCP-Bearer-Token für Sie und überprüft die Anmeldedaten gegen die Pluggy-API, bevor etwas geschrieben wird. Wenn Sie es erneut ausführen, bleiben Ihre aktuellen Werte erhalten — drücken Sie die Eingabetaste, um eine Eingabeaufforderung zu überspringen.

Der Probebericht zeigt, ob Investitionen, Kreditkartenrechnungen und Darlehen auf Ihren Verbindungen verfügbar sind, und validiert die Behandlung von Datum und Kategorie. Er gibt keine Kontonummern, Steuer-IDs oder Transaktionsbeschreibungen aus.

3. Ausführen

npm run build
npm start

Bereitstellung (VM + Tailscale)

Der Prozess lauscht nur auf Loopback. Die Exposition wird von Tailscale übernommen, niemals durch Binden an 0.0.0.0 — Cloud-VMs haben öffentliche IPs, und ein falsches Binden in Kombination mit einer offenen Sicherheitsliste bringt Ihren Kontoauszug ins Internet.

sudo cp deploy/pluggy-mcp.service /etc/systemd/system/
sudo install -d -m 700 /etc/pluggy-mcp
sudo install -m 600 .env /etc/pluggy-mcp/env
sudo systemctl enable --now pluggy-mcp

tailscale serve --bg --https=443 127.0.0.1:8787

Einen Client verbinden

claude mcp add pluggy --transport http \
  --header "Authorization: Bearer $MCP_BEARER_TOKEN" \
  https://YOUR-VM.YOUR-TAILNET.ts.net/mcp

Dies funktioniert nicht im Claude-Web oder in der mobilen App: claude.ai-Custom-Connectors werden von der Infrastruktur von Anthropic gewählt, die ein privates Tailnet nicht erreichen kann. Clients, die sich von der Maschine aus verbinden, auf der sie ausgeführt werden, funktionieren normal.

Design

Jede Entscheidung und ihre Begründung finden Sie in DESIGN.md.

Lizenz

MIT