mcp-ebanx — MCP-сервер EBANX для Claude Code: платежи и выплаты
Даёт агенту 18 инструментов EBANX: создать платёж или выплату, вернуть деньги, узнать курс. Пригодится, если проект принимает оплату в Латинской Америке.
claude mcp add mcp-ebanx -e EBANX_API_KEY=<EBANX_API_KEY> -- npx -y @codespar/mcp-ebanxЧто делает mcp-ebanx
Сервер обёртывает API EBANX и отдаёт агенту 18 инструментов. Через них можно создать платёж в boleto, PIX или картой, посмотреть статус по хешу, оформить возврат — полный или частичный. Отдельная группа отвечает за выплаты на банковский счёт, включая массовую отправку одной пачкой.
Для интеграции есть мелочи, которые обычно пишут руками: проверка латиноамериканских налоговых документов (CPF/CNPJ для Бразилии, RFC для Мексики, DNI для Аргентины и Перу), токенизация карты для повторных списаний и проверка HMAC-подписи вебхука по ключу интеграции. simulate_payment проигрывает ответ платежа в песочнице, не сохраняя его, — это для тестов интеграции.
Аутентификация простая: ключ интеграции из личного кабинета EBANX кладётся в переменную EBANX_INTEGRATION_KEY. Без валидного ключа запросы к API не пройдут. Песочница включается флагом EBANX_SANDBOX=true и работает на sandbox.ebanx.com, так что реальные деньги на этапе отладки не нужны.
Какие задачи решает
- создать платёж в boleto, PIX или картой из кода
- оформить частичный возврат по платежу
- отправить пачку выплат на банковские счета
- проверить CPF или CNPJ перед отправкой
- сверить подпись входящего вебхука
Примеры запросов агенту
- Создай платёж через EBANX на 150 BRL картой и покажи хеш
- Верни половину суммы по платежу с хешем
abc123 - Какой сейчас курс USD к BRL через EBANX?
Как установить mcp-ebanx
Командой платформы
claude mcp add mcp-ebanx -e EBANX_API_KEY=<EBANX_API_KEY> -- npx -y @codespar/mcp-ebanxВместо <…> подставьте свои значения
Командой платформы
codex mcp add ebanx --env EBANX_API_KEY=<EBANX_API_KEY> -- npx -y @codespar/mcp-ebanxВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"ebanx": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-ebanx"
],
"env": {
"EBANX_API_KEY": "<EBANX_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"ebanx": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-ebanx"
],
"env": {
"EBANX_API_KEY": "<EBANX_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e EBANX_API_KEY=<EBANX_API_KEY> ebanx npx -y @codespar/mcp-ebanxВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-ebanx
Как установить mcp-ebanx в Claude Code?
Одной командой: claude mcp add mcp-ebanx -e EBANX_API_KEY=<EBANX_API_KEY> -- npx -y @codespar/mcp-ebanx. Ключ подставьте свой, его можно взять в личном кабинете EBANX.
Что делает mcp-ebanx?
Прокидывает в агент инструменты платёжного API EBANX: платежи, возвраты, выплаты, курсы валют, банки, токены карт и проверку документов.
Как тестировать без реальных денег?
Задайте EBANX_SANDBOX=true, и запросы уйдут в песочницу на sandbox.ebanx.com. Симуляция платежа там не сохраняется.
