mcp-caixa — MCP-сервер для Claude Code: что делает и как установить
Подключает банковские сервисы Caixa Econômica Federal: операции Pix, выпуск болето SICOB, выписки и оплату госпошлин с авторизацией по mTLS.
claude mcp add --env CAIXA_CLIENT_ID=<CAIXA_CLIENT_ID> --env CAIXA_CLIENT_SECRET=<CAIXA_CLIENT_SECRET> --env CAIXA_CERT_PATH=<CAIXA_CERT_PATH> --env CAIXA_KEY_PATH=<CAIXA_KEY_PATH> --env CAIXA_ENV=<CAIXA_ENV> --transport stdio caixa -- npx -y @codespar/mcp-caixaЧто делает mcp-caixa
MCP-сервер предоставляет 23 инструмента для взаимодействия с бразильским банком Caixa Econômica Federal. Он охватывает переводы Pix, выпуск болето через Cobrança v2 (SICOB), скачивание PDF-квитанций и проверку выписок. Через него также можно оплачивать федеральные сборы вроде DARF или GRU, регистрировать DICT-ключи и запрашивать баланс FGTS.
Для авторизации нужны сразу два фактора: OAuth2 client credentials и клиентский mTLS-сертификат. Банк выдаёт их только после официального заключения договора и аккредитации. Запросы уходят через встроенный агент Node.js с путями к сертификатам CAIXA_CERT_PATH и CAIXA_KEY_PATH.
Пакет опубликован в альфа-версии 0.1.0-alpha.1. Официальная документация Caixa закрыта для публики, поэтому пути эндпоинтов собраны по спецификации BACEN Pix v2 и помечены как непроверенные. Без одобренного контракта с банком и рабочих сертификатов запустить сервер в продакшене не получится.
Какие задачи решает
- генерировать динамические QR-коды Pix и проверять статус оплат
- выставлять и отзывать квитанции болето через Caixa Cobrança
- скачивать готовые PDF-файлы выписанных болето
- проверять банковские выписки и остатки на счетах FGTS
- оплачивать федеральные налоги и сборы DARF, GPS или GRU
Примеры запросов агенту
- Сгенерируй динамический QR-код Pix на сумму 150 BRL для заказа 4029
- Выстави болето через Caixa Cobrança и пришли ссылку на скачивание PDF
- Проверь статус входящего платежа Pix по идентификатору endToEndId
Как установить mcp-caixa
Командой платформы
claude mcp add --env CAIXA_CLIENT_ID=<CAIXA_CLIENT_ID> --env CAIXA_CLIENT_SECRET=<CAIXA_CLIENT_SECRET> --env CAIXA_CERT_PATH=<CAIXA_CERT_PATH> --env CAIXA_KEY_PATH=<CAIXA_KEY_PATH> --env CAIXA_ENV=<CAIXA_ENV> --transport stdio caixa -- npx -y @codespar/mcp-caixaВместо <…> подставьте свои значения
Командой платформы
codex mcp add caixa --env CAIXA_CLIENT_ID=<CAIXA_CLIENT_ID> --env CAIXA_CLIENT_SECRET=<CAIXA_CLIENT_SECRET> --env CAIXA_CERT_PATH=<CAIXA_CERT_PATH> --env CAIXA_KEY_PATH=<CAIXA_KEY_PATH> --env CAIXA_ENV=<CAIXA_ENV> -- npx -y @codespar/mcp-caixaВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"caixa": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-caixa"
],
"env": {
"CAIXA_CLIENT_ID": "<CAIXA_CLIENT_ID>",
"CAIXA_CLIENT_SECRET": "<CAIXA_CLIENT_SECRET>",
"CAIXA_CERT_PATH": "<CAIXA_CERT_PATH>",
"CAIXA_KEY_PATH": "<CAIXA_KEY_PATH>",
"CAIXA_ENV": "<CAIXA_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"caixa": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-caixa"
],
"env": {
"CAIXA_CLIENT_ID": "<CAIXA_CLIENT_ID>",
"CAIXA_CLIENT_SECRET": "<CAIXA_CLIENT_SECRET>",
"CAIXA_CERT_PATH": "<CAIXA_CERT_PATH>",
"CAIXA_KEY_PATH": "<CAIXA_KEY_PATH>",
"CAIXA_ENV": "<CAIXA_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e CAIXA_CLIENT_ID=<CAIXA_CLIENT_ID> -e CAIXA_CLIENT_SECRET=<CAIXA_CLIENT_SECRET> -e CAIXA_CERT_PATH=<CAIXA_CERT_PATH> -e CAIXA_KEY_PATH=<CAIXA_KEY_PATH> -e CAIXA_ENV=<CAIXA_ENV> caixa npx -y @codespar/mcp-caixaВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-caixa
Как установить mcp-caixa в Claude Code?
Выполните команду с указанием учётных данных и путей к ключам: `claude mcp add --env CAIXA_CLIENT_ID=<CAIXA_CLIENT_ID> --env CAIXA_CLIENT_SECRET=<CAIXA_CLIENT_SECRET> --env CAIXA_CERT_PATH=<CAIXA_CERT_PATH> --env CAIXA_KEY_PATH=<CAIXA_KEY_PATH> --env CAIXA_ENV=<CAIXA_ENV> --transport stdio caixa -- npx -y @codespar/mcp-caixa`.
Что делает mcp-caixa?
Сервер даёт ИИ-агенту 23 инструмента для взаимодействия с бразильским банком Caixa. Он позволяет проводить платежи Pix, выпускать болето, скачивать PDF и запрашивать выписки.
Какие требования нужны для подключения к API Caixa?
Требуется утверждённый договор продавца с банком. Для каждого вызова API обязательны одновременно OAuth2-токен и клиентский сертификат mTLS с приватным ключом.
