mcp-transbank — MCP-сервер для Claude Code: обзор и запуск
Подключает чилийский платёжный шлюз Transbank к ассистентам. Управляет сценариями Webpay Plus и OneClick Mall прямо из чата разработки.
claude mcp add --env TRANSBANK_COMMERCE_CODE=<TRANSBANK_COMMERCE_CODE> --env TRANSBANK_API_KEY_SECRET=<TRANSBANK_API_KEY_SECRET> --env TRANSBANK_ENV=<TRANSBANK_ENV> --transport stdio transbank -- npx -y @codespar/mcp-transbankЧто делает mcp-transbank
Сервер связывает модель со службой Transbank, обрабатывающей эквайринг банковских карт в Чили. Внутри заложено 19 инструментов под две схемы работы: разовые переводы со страницей подтверждения Webpay Plus и сохранение токенизированных карт OneClick Mall с распределением платежей по разным продавцам.
Ассистент умеет создавать транзакции и запрашивать их статус после возврата покупателя. Также поддерживаются возвраты и отложенная фиксация средств. Заголовки авторизации Tbk-Api-Key-Id и Tbk-Api-Key-Secret подставляются автоматически при каждом вызове.
Без переменных TRANSBANK_COMMERCE_CODE и TRANSBANK_API_KEY_SECRET сервер отклонит запросы к API. Переменная TRANSBANK_ENV переключает шлюз с тестовой среды integration на боевую production.
Какие задачи решает
- списать оплату через Webpay Plus с перенаправлением пользователя
- проверить статус транзакции по токену
- зарегистрировать карту покупателя через OneClick Mall
- оформить возврат средств по чеку торговой точки
Примеры запросов агенту
- Создай транзакцию Webpay Plus на сумму 15000 CLP с номером заказа ord-992 и обратным адресом.
- Подтверди платёж в Webpay по токену, полученному после перенаправления клиента.
- Проверь статус родительской транзакции OneClick Mall для заказа order-551.
Как установить mcp-transbank
Командой платформы
claude mcp add --env TRANSBANK_COMMERCE_CODE=<TRANSBANK_COMMERCE_CODE> --env TRANSBANK_API_KEY_SECRET=<TRANSBANK_API_KEY_SECRET> --env TRANSBANK_ENV=<TRANSBANK_ENV> --transport stdio transbank -- npx -y @codespar/mcp-transbankВместо <…> подставьте свои значения
Командой платформы
codex mcp add transbank --env TRANSBANK_COMMERCE_CODE=<TRANSBANK_COMMERCE_CODE> --env TRANSBANK_API_KEY_SECRET=<TRANSBANK_API_KEY_SECRET> --env TRANSBANK_ENV=<TRANSBANK_ENV> -- npx -y @codespar/mcp-transbankВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"transbank": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-transbank"
],
"env": {
"TRANSBANK_COMMERCE_CODE": "<TRANSBANK_COMMERCE_CODE>",
"TRANSBANK_API_KEY_SECRET": "<TRANSBANK_API_KEY_SECRET>",
"TRANSBANK_ENV": "<TRANSBANK_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"transbank": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-transbank"
],
"env": {
"TRANSBANK_COMMERCE_CODE": "<TRANSBANK_COMMERCE_CODE>",
"TRANSBANK_API_KEY_SECRET": "<TRANSBANK_API_KEY_SECRET>",
"TRANSBANK_ENV": "<TRANSBANK_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e TRANSBANK_COMMERCE_CODE=<TRANSBANK_COMMERCE_CODE> -e TRANSBANK_API_KEY_SECRET=<TRANSBANK_API_KEY_SECRET> -e TRANSBANK_ENV=<TRANSBANK_ENV> transbank npx -y @codespar/mcp-transbankВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-transbank
Как установить mcp-transbank в Claude Code?
Выполните команду `claude mcp add mcp-transbank -e TRANSBANK_COMMERCE_CODE=<TRANSBANK_COMMERCE_CODE> -e TRANSBANK_API_KEY_SECRET=<TRANSBANK_API_KEY_SECRET> -- npx -y @codespar/mcp-transbank`.
Что делает mcp-transbank?
Даёт агенту команды для взаимодействия с чилийской системой Transbank. Он создаёт сессии оплаты Webpay Plus, проверяет возвраты и регистрирует карты в OneClick Mall.
Как переключить сервер на боевой шлюз Transbank?
Передайте переменную окружения TRANSBANK_ENV="production". По умолчанию сервер использует значение integration и тестовые адреса.
