# mcp-open-finance

Подключает агента к Open Finance Brasil: счета, транзакции, согласия, кредитные карты, займы и инвестиции клиента. Пригодится, если код работает с бразильскими банковскими API.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Автор: codespar
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/banking/open-finance
- Обновлён: 2026-09-27
- HTML: https://affpapa.org/nevibecode/mcp/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`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `OPEN_FINANCE_CLIENT_SECRET` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add mcp-open-finance -e OPEN_FINANCE_CLIENT_SECRET=<OPEN_FINANCE_CLIENT_SECRET> -- npx -y @codespar/mcp-open-finance
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add open-finance --env OPEN_FINANCE_CLIENT_SECRET=<OPEN_FINANCE_CLIENT_SECRET> -- npx -y @codespar/mcp-open-finance
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "open-finance": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-open-finance"
            ],
            "env": {
                "OPEN_FINANCE_CLIENT_SECRET": "<OPEN_FINANCE_CLIENT_SECRET>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "open-finance": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-open-finance"
            ],
            "env": {
                "OPEN_FINANCE_CLIENT_SECRET": "<OPEN_FINANCE_CLIENT_SECRET>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e OPEN_FINANCE_CLIENT_SECRET=<OPEN_FINANCE_CLIENT_SECRET> open-finance npx -y @codespar/mcp-open-finance
```
Вместо <…> подставьте свои значения

## Когда брать
- вытащить баланс и список счетов клиента через Open Finance
- собрать историю транзакций по счёту
- запросить выписки и покупки по кредитной карте
- посмотреть график платежей по займу
- создать согласие на инициирование платежа PIX

## Примеры запросов агенту
- Покажи счета клиента и баланс по каждому через Open Finance
- Выведи транзакции по счёту за последний месяц
- Создай согласие на оплату через PIX и проведи платёж

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [CCXT](https://affpapa.org/nevibecode/mcp/ccxt.md) — MCP-сервер · ★ 44583
- [Finance Toolkit](https://affpapa.org/nevibecode/mcp/finance-toolkit.md) — MCP-сервер · ★ 5458
- [EdgarTools](https://affpapa.org/nevibecode/mcp/edgartools.md) — MCP-сервер · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/nevibecode/mcp/letsfg-flights-hotels.md) — MCP-сервер · ★ 2188
- [AutoTS](https://affpapa.org/nevibecode/mcp/autots.md) — MCP-сервер · ★ 1434

Из того же набора: [codespar/mcp-dev-latam](https://affpapa.org/nevibecode/by/codespar/mcp-dev-latam.md) — 124 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md