mcp-santander — MCP-сервер для Santander Brasil: Pix, болето, выписка
Даёт агенту доступ к API Santander Brasil: платежи Pix, болето, выписка по счёту и баланс. Пригодится, если проект работает с бразильскими платежами напрямую, без PSP.
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Что делает 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 фиксируйте точную версию пакета.
Какие задачи решает
- отправить исходящий Pix со счёта мерчанта
- выпустить болето и отдать клиенту PDF второй копии
- сверить поступления Pix за нужный период
- проверить ключ DICT перед переводом
- оплатить квитанцию через Arrecadação
Примеры запросов агенту
- Отправь Pix на 150 реалов по ключу из
clients.csvи покажи endToEndId - Выпусти болето в workspace
ws_1042на сумму из заказа и принеси ссылку на PDF - Покажи все полученные Pix за прошлую неделю и сверь с таблицей оплат
Как установить mcp-santander
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-santander
Как установить mcp-santander в Claude Code?
Одной командой: `claude mcp add mcp-santander -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> -- npx -y @codespar/mcp-santander`. Подставьте свои креды и абсолютные пути к сертификату и ключу.
Что делает mcp-santander?
Это MCP-сервер над API Santander Brasil. Агент через него шлёт Pix, выпускает и отменяет болето, читает выписку и баланс, делает TED и внутренние переводы.
Что нужно, чтобы сервер заработал?
Подписанный мерчантский договор с Santander. Из Developer Portal берутся OAuth client_id и client_secret, отдельно — клиентский сертификат и приватный ключ для mTLS. Без сертификата шлюз trust-open запрос не пропустит.
