Bunq MCP

Банк MCP

Модель сервера контекстного протокола для Bunq (голландский необанк).

Доступные инструменты

Этот MCP-сервер предоставляет следующие инструменты для взаимодействия с Bunq:

1. bunqAccounts — получите данные о своих счетах Bunq, такие как тип счета, баланс и идентификатор.
2. getTransactions - Просмотр транзакций (платежей) для определенного счета
3. getRequestInquiries — получение запросов на получение денег, отправленных с определенного счета
4. createPaymentRequest - Создайте запрос на оплату для получения денег на свой счет
5. getPaymentAutoAllocates — получение настроек автоматического распределения платежей для учетной записи
6. getTopCounterpartyes — получение списка уникальных контрагентов на основе последних транзакций
7. createDraftPayment — создание черновиков платежей с возможностью планирования (требуется проверка/утверждение в приложении перед выполнением)
8. createPayment - Создание платежей реальными деньгами (переводы происходят немедленно). Доступно только при использовании ключа API (не OAuth).

Доступ к этим инструментам можно получить через любой клиент MCP, подключенный к этому серверу.

Аутентификация

Этот сервер поддерживает два режима аутентификации: OAuth и API Key . Для получения дополнительной информации см. документацию Bunq .

Создание ключа API или клиента OAuth выполняется через приложение Bunq:

1. Нажмите на свое лицо в левом верхнем углу.
2. Нажмите на шестеренку в правом верхнем углу.
3. В разделе «Разработчики» перейдите в раздел «OAuth» или «API-ключи».
4. При использовании OAuth установите следующий URL-адрес перенаправления:
   http://localhost:8788/callback

(При необходимости измените порт.)

При запуске сервера вы можете либо задать переменные окружения BUNQ_CLIENT_ID и BUNQ_CLIENT_SECRET , либо переменную окружения BUNQ_API_KEY . В качестве альтернативы вы можете передать идентификатор клиента и секрет или ключ API в качестве аргументов командной строки: --bunq-client-id <id> --bunq-client-secret <secret> или --bunq-api-key <key> .

Примечание: если вы хотите создавать реальные платежи без чека, вам необходимо использовать ключ API.

Установка и использование

1. Установите инструменты командной строки bunq-mcp и mcp-remote :

2. В приложении Bunq создайте клиент OAuth или ключ API (см. выше).
3. (Необязательно) Создайте новую пару открытого и закрытого ключей:

Обратите внимание, что это предполагает, что openssl установлен и доступен в PATH. Если вы решите пропустить этот шаг, будут использоваться уже существующие ключи в ./src/keys/ . Созданные ключи переопределят уже существующие ключи и будут сохранены в глобальном каталоге node_modules .

4. Запустите MCP-сервер в любом терминале:

Идентификатор клиента и секрет также можно задать с помощью переменных среды BUNQ_CLIENT_ID и BUNQ_CLIENT_SECRET .

5. В вашем любимом редакторе или другом MCP-клиенте (например, Claude Desktop) добавьте следующее:

Опять же, измените порт, если необходимо. mcp-remote используется, поскольку этот пакет использует транспорт SSE, в то время как большинство клиентов его не поддерживают. См. mcp-remote для получения дополнительной информации.

6. Как только сервер MCP будет запущен, mcp-remote должен открыть ваш браузер для запуска потока OAuth.

Теперь вы сможете задать вопрос, например:

• Каков мой текущий баланс Bunq?
• Каковы мои 5 основных контрагентов?
• Какая была моя последняя транзакция?

Поиск неисправностей

• Если возникли какие-либо проблемы с потоком OAuth, вы можете попробовать удалить каталог, созданный mcp-remote в вашем домашнем каталоге: rm -rf ~/.mcp-auth .

CLI

Разработка

1. Создайте файл .dev.vars в корневом каталоге со следующим содержимым:

2. Запустить сервер разработки

3. Настройка конфигурации MCP

Ограничения

• Невозможно создавать платежи с использованием потока OAuth. Можно создавать только черновики платежей.