mcp-worldpay — MCP-сервер для Claude Code: платежи Worldpay
MCP-сервер для Access Worldpay: авторизация, списание, возврат, токенизация карт и работа с чарджбэками прямо из ИИ-агента.
claude mcp add --env WORLDPAY_USERNAME=<WORLDPAY_USERNAME> --env WORLDPAY_PASSWORD=<WORLDPAY_PASSWORD> --env WORLDPAY_ENTITY=<WORLDPAY_ENTITY> --env WORLDPAY_ENV=<WORLDPAY_ENV> --env WORLDPAY_API_VERSION=<WORLDPAY_API_VERSION> --transport stdio worldpay -- npx -y @codespar/mcp-worldpayЧто делает mcp-worldpay
Сервер открывает агенту 22 инструмента Access Worldpay: authorize_payment, capture_payment, cancel_payment, refund_payment, reverse_payment, create_token, get_token, а также шаги 3DS2 и разбор споров. Отдельно есть fraud_screen — проверка платёжного метода через FraudSight без списания денег, и verify_account для AVS/CVC-проверки. Если нужно свериться с выпиской, пригодятся get_reconciliation_batch и list_payment_events.
Доступ к API идёт по HTTP Basic: понадобятся выданные Worldpay логин, пароль и идентификатор merchant entity. Без WORLDPAY_USERNAME, WORLDPAY_PASSWORD и WORLDPAY_ENTITY сервер к боевому или тестовому контуру не подключится. Окружение задаёт WORLDPAY_ENV, по умолчанию стоит sandbox. Версию Payments API фиксирует WORLDPAY_API_VERSION, по умолчанию v7.
Access Worldpay работает по HATEOAS: после авторизации в ответе приходят ссылки вида payments:settle или payments:refund, и из каждой надо вытащить хвостовой сегмент linkData. Его и передают в capture_payment, refund_payment и остальные операции жизненного цикла. Если сегмент не указать, сервер обратится к голому пути ресурса, а это сработает лишь на онбордингах, где расчёты адресуются через transactionReference. Пакет помечен как 0.1.0-alpha.1: пути эндпоинтов ещё могут сдвинуться.
Какие задачи решает
- проверить карту через AVS/CVC, не списывая деньги
- авторизовать платёж и затем захватить или отменить его
- вернуть деньги по уже захваченному платежу
- сохранить карту в токен для повторных покупок
- разобрать спор: принять его или отправить доказательства
Примеры запросов агенту
- Проведи AVS/CVC-проверку карты без списания
- Авторизуй платёж на 49.90 и захвати его через
linkData - Оформи возврат по захваченному платежу и приложи причину
Как установить mcp-worldpay
Командой платформы
claude mcp add --env WORLDPAY_USERNAME=<WORLDPAY_USERNAME> --env WORLDPAY_PASSWORD=<WORLDPAY_PASSWORD> --env WORLDPAY_ENTITY=<WORLDPAY_ENTITY> --env WORLDPAY_ENV=<WORLDPAY_ENV> --env WORLDPAY_API_VERSION=<WORLDPAY_API_VERSION> --transport stdio worldpay -- npx -y @codespar/mcp-worldpayВместо <…> подставьте свои значения
Командой платформы
codex mcp add worldpay --env WORLDPAY_USERNAME=<WORLDPAY_USERNAME> --env WORLDPAY_PASSWORD=<WORLDPAY_PASSWORD> --env WORLDPAY_ENTITY=<WORLDPAY_ENTITY> --env WORLDPAY_ENV=<WORLDPAY_ENV> --env WORLDPAY_API_VERSION=<WORLDPAY_API_VERSION> -- npx -y @codespar/mcp-worldpayВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"worldpay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-worldpay"
],
"env": {
"WORLDPAY_USERNAME": "<WORLDPAY_USERNAME>",
"WORLDPAY_PASSWORD": "<WORLDPAY_PASSWORD>",
"WORLDPAY_ENTITY": "<WORLDPAY_ENTITY>",
"WORLDPAY_ENV": "<WORLDPAY_ENV>",
"WORLDPAY_API_VERSION": "<WORLDPAY_API_VERSION>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"worldpay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-worldpay"
],
"env": {
"WORLDPAY_USERNAME": "<WORLDPAY_USERNAME>",
"WORLDPAY_PASSWORD": "<WORLDPAY_PASSWORD>",
"WORLDPAY_ENTITY": "<WORLDPAY_ENTITY>",
"WORLDPAY_ENV": "<WORLDPAY_ENV>",
"WORLDPAY_API_VERSION": "<WORLDPAY_API_VERSION>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e WORLDPAY_USERNAME=<WORLDPAY_USERNAME> -e WORLDPAY_PASSWORD=<WORLDPAY_PASSWORD> -e WORLDPAY_ENTITY=<WORLDPAY_ENTITY> -e WORLDPAY_ENV=<WORLDPAY_ENV> -e WORLDPAY_API_VERSION=<WORLDPAY_API_VERSION> worldpay npx -y @codespar/mcp-worldpayВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-worldpay
Как установить mcp-worldpay в Claude Code?
Добавьте сервер командой `claude mcp add mcp-worldpay -e WORLDPAY_USERNAME=<WORLDPAY_USERNAME> -e WORLDPAY_PASSWORD=<WORLDPAY_PASSWORD> -e WORLDPAY_ENTITY=<WORLDPAY_ENTITY> -- npx -y @codespar/mcp-worldpay`. Переменные с кредами подставьте свои.
Что делает mcp-worldpay?
Даёт агенту инструменты Access Worldpay: авторизацию, захват, отмену, возврат и реверс платежей, токенизацию карт, шаги 3DS2, антифрод-проверку и работу с чарджбэками.
Зачем нужен параметр linkData?
Access Worldpay отдаёт ссылки на действия после авторизации, и хвостовой сегмент href служит адресом операции. Без него сервер стучится по голому пути, и это проходит только при расчётах по transactionReference.
