mcp-airwallex — MCP-сервер для Claude Code: платежи и переводы
Подключает Airwallex к ИИ-агенту: приём платежей, возвраты, выплаты и конвертация валюты через 20 инструментов.
claude mcp add --env AIRWALLEX_CLIENT_ID=<AIRWALLEX_CLIENT_ID> --env AIRWALLEX_API_KEY=<AIRWALLEX_API_KEY> --env AIRWALLEX_ENV=<AIRWALLEX_ENV> --transport stdio airwallex -- npx -y @codespar/mcp-airwallexЧто делает mcp-airwallex
Сервер даёт агенту доступ к API Airwallex. Он умеет создавать и подтверждать payment intent, ловить оплату в два шага, делать возвраты, вести клиентов и бенефициаров, отправлять трансграничные переводы и конвертировать валюту между кошельками. Отдельный инструмент отдаёт баланс по всем валютам счёта.
Авторизация устроена на токене: при первом вызове сервер логинится по AIRWALLEX_CLIENT_ID и AIRWALLEX_API_KEY, держит токен в памяти и обновляет его за минуту до истечения. Нужен аккаунт Airwallex с этими двумя ключами. Переменная AIRWALLEX_ENV переключает демо и боевой режим, по умолчанию стоит demo — на боевых деньгах проект сломается молча, если её не поменять.
У каждого create_* есть обязательный request_id: это ключ идемпотентности, и сервер его сам не придумывает. Агент должен передавать один и тот же UUID на повтор операции, иначе ретрай пройдёт как новый платёж. Это самое хрупкое место во всей обвязке.
Какие задачи решает
- создать payment intent и захватить оплату в два шага
- оформить полный или частичный возврат по платежу
- завести бенефициара с банковскими реквизитами
- отправить трансграничный перевод и отменить его до расчёта
- посмотреть остаток по каждой валюте на счёте
Примеры запросов агенту
- Создай payment intent на 250 USD для клиента
cus_123и верни его id - Сделай возврат по захваченному платежу
pi_456на половину суммы - Покажи баланс по всем валютам на счёте Airwallex
Как установить mcp-airwallex
Командой платформы
claude mcp add --env AIRWALLEX_CLIENT_ID=<AIRWALLEX_CLIENT_ID> --env AIRWALLEX_API_KEY=<AIRWALLEX_API_KEY> --env AIRWALLEX_ENV=<AIRWALLEX_ENV> --transport stdio airwallex -- npx -y @codespar/mcp-airwallexВместо <…> подставьте свои значения
Командой платформы
codex mcp add airwallex --env AIRWALLEX_CLIENT_ID=<AIRWALLEX_CLIENT_ID> --env AIRWALLEX_API_KEY=<AIRWALLEX_API_KEY> --env AIRWALLEX_ENV=<AIRWALLEX_ENV> -- npx -y @codespar/mcp-airwallexВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"airwallex": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-airwallex"
],
"env": {
"AIRWALLEX_CLIENT_ID": "<AIRWALLEX_CLIENT_ID>",
"AIRWALLEX_API_KEY": "<AIRWALLEX_API_KEY>",
"AIRWALLEX_ENV": "<AIRWALLEX_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"airwallex": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-airwallex"
],
"env": {
"AIRWALLEX_CLIENT_ID": "<AIRWALLEX_CLIENT_ID>",
"AIRWALLEX_API_KEY": "<AIRWALLEX_API_KEY>",
"AIRWALLEX_ENV": "<AIRWALLEX_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e AIRWALLEX_CLIENT_ID=<AIRWALLEX_CLIENT_ID> -e AIRWALLEX_API_KEY=<AIRWALLEX_API_KEY> -e AIRWALLEX_ENV=<AIRWALLEX_ENV> airwallex npx -y @codespar/mcp-airwallexВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-airwallex
Как установить mcp-airwallex в Claude Code?
Через CLI: claude mcp add mcp-airwallex -e AIRWALLEX_CLIENT_ID=<AIRWALLEX_CLIENT_ID> -e AIRWALLEX_API_KEY=<AIRWALLEX_API_KEY> -- npx -y @codespar/mcp-airwallex. Для передачи окружения и stdio-транспорта есть вариант с --env и --transport stdio.
Что делает mcp-airwallex?
Соединяет агента с API Airwallex: платежи, возвраты, клиенты, бенефициары, переводы, FX-конвертация и баланс кошелька — всего 20 инструментов.
Что нужно для работы сервера?
Пара ключей AIRWALLEX_CLIENT_ID и AIRWALLEX_API_KEY. Без них логин на /authentication/login не пройдёт, и ни один инструмент не ответит.
