# mcp-santander

Даёт агенту доступ к API Santander Brasil: платежи Pix, болето, выписка по счёту и баланс. Пригодится, если проект работает с бразильскими платежами напрямую, без PSP.

- 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/santander
- Обновлён: 2026-09-27
- HTML: https://affpapa.org/nevibecode/mcp/mcp-santander

## Что делает

Сервер закрывает 23 инструмента: отправка Pix, создание динамического QR-кода, возврат, регистрация и удаление ключей DICT, выпуск и отмена болето, выписка за период, баланс, TED и перевод между счетами Santander, оплата квитанций через Arrecadação и согласия Open Finance.

Аутентификация двухфакторная, и оба фактора нужны на каждом вызове. Первый — OAuth2 `client_credentials`: сервер получает токен у `/auth/oauth/v2/token`, кэширует его примерно до минуты перед истечением и подставляет в заголовок. Второй — mTLS: клиентский сертификат и ключ грузятся из путей `SANTANDER_CERT_PATH` и `SANTANDER_KEY_PATH`, все запросы идут через собранный `https.Agent`. Сертификат с ключом выдаёт Developer Portal после подписания мерчантского договора, и это не те же данные, что OAuth-креды.

Версия `0.1.0-alpha.1`, и это видно по коду. Подтверждены только адреса хостов `trust-open` и `trust-sandbox`, путь токена и база Cobrança v2. Пути для Pix, Arrecadação и Extrato собраны из стандарта BACEN и чужих конвенций, в исходнике они помечены `TODO(verify)`. Болето в Cobrança привязаны к `workspace_id`, который заводится в портале заранее — без него `create_boleto` не сработает. На время `0.1.x` фиксируйте точную версию пакета.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add --env SANTANDER_CLIENT_ID=<SANTANDER_CLIENT_ID> --env SANTANDER_CLIENT_SECRET=<SANTANDER_CLIENT_SECRET> --env SANTANDER_CERT_PATH=<SANTANDER_CERT_PATH> --env SANTANDER_KEY_PATH=<SANTANDER_KEY_PATH> --env SANTANDER_ENV=<SANTANDER_ENV> --transport stdio santander -- npx -y @codespar/mcp-santander
```
Вместо <…> подставьте свои значения

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## Когда брать
- отправить исходящий Pix со счёта мерчанта
- выпустить болето и отдать клиенту PDF второй копии
- сверить поступления Pix за нужный период
- проверить ключ DICT перед переводом
- оплатить квитанцию через Arrecadação

## Примеры запросов агенту
- Отправь Pix на 150 реалов по ключу из `clients.csv` и покажи endToEndId
- Выпусти болето в workspace `ws_1042` на сумму из заказа и принеси ссылку на PDF
- Покажи все полученные 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

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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