mcp-open-finance — MCP-сервер для Open Finance Brasil
Подключает агента к Open Finance Brasil: счета, транзакции, согласия, кредитные карты, займы и инвестиции клиента. Пригодится, если код работает с бразильскими банковскими API.
claude mcp add mcp-open-finance -e OPEN_FINANCE_CLIENT_SECRET=<OPEN_FINANCE_CLIENT_SECRET> -- npx -y @codespar/mcp-open-financeЧто делает mcp-open-finance
Сервер даёт агенту 18 инструментов. Есть методы для счетов и баланса, истории транзакций, овердрафта, согласий — включая создание и отзыв, — выписок и покупок по кредитным картам, графика платежей по займам, финансирований, инвестиционных продуктов и квалификаций клиента (доход и занятость для физлиц, данные для юрлиц). Отдельная пара инструментов создаёт согласие на инициирование платежа и проводит сам платёж, например PIX.
Аутентификация — OAuth2 client credentials. Каждый банк выдаёт свой базовый URL и пару идентификаторов, так что без трёх переменных окружения OPEN_FINANCE_BASE_URL, OPEN_FINANCE_CLIENT_ID и OPEN_FINANCE_CLIENT_SECRET сервер не поднимется. Получают их у финансового учреждения, участвующего в Open Finance Brasil. Sandbox есть не у всех банков, это стоит выяснить до того, как закладывать интеграцию в план.
Учтите: в списке инструментов есть revoke_consent и платежи, то есть агент получает доступ к операциям с реальными деньгами и персональными данными. Права и лимиты настройте на стороне банка. Написано на Node.js, ставится через npx.
Какие задачи решает
- вытащить баланс и список счетов клиента через Open Finance
- собрать историю транзакций по счёту
- запросить выписки и покупки по кредитной карте
- посмотреть график платежей по займу
- создать согласие на инициирование платежа PIX
Примеры запросов агенту
- Покажи счета клиента и баланс по каждому через Open Finance
- Выведи транзакции по счёту за последний месяц
- Создай согласие на оплату через PIX и проведи платёж
Как установить mcp-open-finance
Командой платформы
claude mcp add mcp-open-finance -e OPEN_FINANCE_CLIENT_SECRET=<OPEN_FINANCE_CLIENT_SECRET> -- npx -y @codespar/mcp-open-financeВместо <…> подставьте свои значения
Командой платформы
codex mcp add open-finance --env OPEN_FINANCE_CLIENT_SECRET=<OPEN_FINANCE_CLIENT_SECRET> -- npx -y @codespar/mcp-open-financeВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"open-finance": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-open-finance"
],
"env": {
"OPEN_FINANCE_CLIENT_SECRET": "<OPEN_FINANCE_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"open-finance": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-open-finance"
],
"env": {
"OPEN_FINANCE_CLIENT_SECRET": "<OPEN_FINANCE_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e OPEN_FINANCE_CLIENT_SECRET=<OPEN_FINANCE_CLIENT_SECRET> open-finance npx -y @codespar/mcp-open-financeВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-open-finance
Как установить mcp-open-finance в Claude Code?
Выполните claude mcp add mcp-open-finance -e OPEN_FINANCE_CLIENT_SECRET=<OPEN_FINANCE_CLIENT_SECRET> -- npx -y @codespar/mcp-open-finance, перед этим задав остальные значения в конфигурации сервера.
Что делает mcp-open-finance?
Открывает агенту 18 инструментов Open Finance Brasil: счета, транзакции, согласия, кредитные карты, займы, финансирования, инвестиции, квалификации клиента и платежи.
Какие данные нужны для работы сервера?
Базовый URL API банка и пара OAuth2 client credentials. Их выдаёт финансовое учреждение, участвующее в Open Finance Brasil.
