Bunq MCP

Bunq MCP

Ein Model Context Protocol-Server für Bunq (niederländische Neobank).

Verfügbare Tools

Dieser MCP-Server bietet die folgenden Tools für die Interaktion mit Bunq:

1. bunqAccounts - Holen Sie sich Ihre Bunq-Konten mit Details wie Kontotyp, Kontostand und ID
2. getTransactions - Transaktionen (Zahlungen) für ein bestimmtes Konto anzeigen
3. getRequestInquiries - Erhalten Sie Geldanfragen, die Sie von einem bestimmten Konto gesendet haben
4. createPaymentRequest – Erstellen Sie eine Zahlungsanforderung, um Geld auf Ihr Konto zu erhalten
5. getPaymentAutoAllocates – Automatische Zahlungszuweisungseinstellungen für ein Konto abrufen
6. getTopCounterparties - Erhalten Sie eine Liste eindeutiger Gegenparteien basierend auf den letzten Transaktionen
7. createDraftPayment – Erstellen Sie Zahlungsentwürfe mit optionaler Planung (erfordert vor der Ausführung eine Überprüfung/Genehmigung in der App)
8. createPayment - Erstellen Sie Echtgeldzahlungen (sofortige Überweisungen). Nur bei Verwendung eines API-Schlüssels verfügbar (nicht OAuth).

Auf diese Tools kann über jeden mit diesem Server verbundenen MCP-Client zugegriffen werden.

Authentifizierung

Dieser Server unterstützt zwei Authentifizierungsmodi: OAuth und API-Schlüssel . Weitere Informationen finden Sie in der Bunq-Dokumentation .

Das Erstellen eines API-Schlüssels oder OAuth-Clients erfolgt über die Bunq-App:

1. Drücken Sie Ihr Gesicht oben links
2. Drücken Sie das Zahnrad oben rechts
3. Gehen Sie unter „Entwickler“ entweder zu „OAuth“ oder „API-Schlüssel“.
4. Wenn Sie OAuth verwenden, legen Sie die Umleitungs-URL wie folgt fest:
   http://localhost:8788/callback

(Ändern Sie den Port bei Bedarf.)

Beim Starten des Servers können Sie entweder die Umgebungsvariablen BUNQ_CLIENT_ID und BUNQ_CLIENT_SECRET oder die Umgebungsvariable BUNQ_API_KEY festlegen. Alternativ können Sie die Client-ID und den geheimen oder API-Schlüssel als Befehlszeilenargumente übergeben: --bunq-client-id <id> --bunq-client-secret <secret> oder --bunq-api-key <key> .

Hinweis: Wenn Sie tatsächliche Zahlungen in Echtgeld ohne Scheck erstellen möchten, müssen Sie einen API-Schlüssel verwenden.

Installation und Verwendung

1. Installieren Sie die CLI-Tools bunq-mcp und mcp-remote :

2. Erstellen Sie in der Bunq-App einen OAuth-Client oder API-Schlüssel (siehe oben).
3. (Optional) Generieren Sie ein neues öffentliches/privates Schlüsselpaar:

Beachten Sie, dass openssl installiert und im Pfad verfügbar ist. Wenn Sie diesen Schritt überspringen, werden die bereits vorhandenen Schlüssel in ./src/keys/ verwendet. Die erstellten Schlüssel überschreiben die bereits vorhandenen Schlüssel und werden im globalen Verzeichnis node_modules gespeichert.

4. Starten Sie den MCP-Server in einem beliebigen Terminal:

Client-ID und Geheimnis können auch mit den Umgebungsvariablen BUNQ_CLIENT_ID und BUNQ_CLIENT_SECRET festgelegt werden.

5. Fügen Sie in Ihrem bevorzugten Editor oder einem anderen MCP-Client (z. B. Claude Desktop) Folgendes hinzu:

Passen Sie den Port gegebenenfalls erneut an. mcp-remote wird verwendet, da dieses Paket den SSE-Transport nutzt, obwohl die meisten Clients dies nicht unterstützen. Weitere Informationen finden Sie unter mcp-remote .

6. Sobald der MCP-Server gestartet ist, sollte mcp-remote Ihren Browser öffnen, um den OAuth-Flow zu starten.

Sie sollten nun in der Lage sein, eine Frage zu stellen, wie zum Beispiel:

• Wie hoch ist mein aktuelles Bunq-Guthaben?
• Wer sind meine Top 5 Gegenparteien?
• Was war meine letzte Transaktion?

Fehlerbehebung

• Wenn es ein Problem mit dem OAuth-Flow gibt, können Sie versuchen, das von mcp-remote erstellte Verzeichnis in Ihrem Home-Verzeichnis zu löschen: rm -rf ~/.mcp-auth .

Befehlszeilenschnittstelle (CLI)

Entwicklung

1. Erstellen Sie im Stammverzeichnis eine Datei .dev.vars mit folgendem Inhalt:

2. Entwicklungsserver starten

3. Einrichten der MCP-Konfiguration

Einschränkungen

• Es ist nicht möglich, Zahlungen über den OAuth-Flow zu erstellen. Es können nur Zahlungsentwürfe erstellt werden.