mcp-kushki — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер даёт агенту доступ к платёжному API Kushki: карты, переводы PSE и SPEI, наличные и подписки. Пригодится, если вы принимаете платежи в Латинской Америке.
claude mcp add --env KUSHKI_PUBLIC_MERCHANT_ID=<KUSHKI_PUBLIC_MERCHANT_ID> --env KUSHKI_PRIVATE_MERCHANT_ID=<KUSHKI_PRIVATE_MERCHANT_ID> --env KUSHKI_ENV=<KUSHKI_ENV> --transport stdio kushki -- npx -y @codespar/mcp-kushkiЧто делает mcp-kushki
Сервер подключает агента к платёжному API Kushki, который работает в Мексике, Колумбии, Чили, Перу и Эквадоре. Внутри 10 инструментов: tokenize_card превращает карту в одноразовый токен, create_charge списывает деньги за один шаг, а create_preauthorization и capture_preauthorization дают схему «заморозить, потом списать». Отмену или возврат делает void_charge.
Банковские переводы идут через create_transfer_token и create_transfer_charge, который возвращает ссылку для редиректа. PSE нужен для Колумбии, SPEI для Мексики. Ваучер для оплаты наличными выдаёт create_cash_charge, регулярные списания заводит create_subscription, останавливает cancel_subscription.
Нужны два идентификатора мерчанта. Публичный умеет только токенизировать, приватный двигает деньги, поэтому держите его на сервере. KUSHKI_ENV по умолчанию равен sandbox: реальные платежи не уйдут, пока вы не выставите production. Суммы передаются в налоговой структуре Kushki: subtotalIva, subtotalIva0, iva и currency.
Какие задачи решает
- принять оплату картой через Kushki в тестовой среде
- заморозить сумму на карте и списать её позже, в том числе частично
- принять банковский перевод PSE или SPEI через редирект
- выдать клиенту ваучер для оплаты наличными
- запустить и остановить регулярные списания с карты
Примеры запросов агенту
- Через Kushki токенизируй тестовую карту и проведи списание в COP с НДС 19%
- Через Kushki заморозь сумму на карте, а позже спиши её часть через
capture_preauthorization - Создай через Kushki перевод PSE и верни ссылку для редиректа
Как установить mcp-kushki
Командой платформы
claude mcp add --env KUSHKI_PUBLIC_MERCHANT_ID=<KUSHKI_PUBLIC_MERCHANT_ID> --env KUSHKI_PRIVATE_MERCHANT_ID=<KUSHKI_PRIVATE_MERCHANT_ID> --env KUSHKI_ENV=<KUSHKI_ENV> --transport stdio kushki -- npx -y @codespar/mcp-kushkiВместо <…> подставьте свои значения
Командой платформы
codex mcp add kushki --env KUSHKI_PUBLIC_MERCHANT_ID=<KUSHKI_PUBLIC_MERCHANT_ID> --env KUSHKI_PRIVATE_MERCHANT_ID=<KUSHKI_PRIVATE_MERCHANT_ID> --env KUSHKI_ENV=<KUSHKI_ENV> -- npx -y @codespar/mcp-kushkiВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"kushki": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-kushki"
],
"env": {
"KUSHKI_PUBLIC_MERCHANT_ID": "<KUSHKI_PUBLIC_MERCHANT_ID>",
"KUSHKI_PRIVATE_MERCHANT_ID": "<KUSHKI_PRIVATE_MERCHANT_ID>",
"KUSHKI_ENV": "<KUSHKI_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"kushki": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-kushki"
],
"env": {
"KUSHKI_PUBLIC_MERCHANT_ID": "<KUSHKI_PUBLIC_MERCHANT_ID>",
"KUSHKI_PRIVATE_MERCHANT_ID": "<KUSHKI_PRIVATE_MERCHANT_ID>",
"KUSHKI_ENV": "<KUSHKI_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e KUSHKI_PUBLIC_MERCHANT_ID=<KUSHKI_PUBLIC_MERCHANT_ID> -e KUSHKI_PRIVATE_MERCHANT_ID=<KUSHKI_PRIVATE_MERCHANT_ID> -e KUSHKI_ENV=<KUSHKI_ENV> kushki npx -y @codespar/mcp-kushkiВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-kushki
Как установить mcp-kushki в Claude Code?
Выполните `claude mcp add mcp-kushki -e KUSHKI_PUBLIC_MERCHANT_ID=<KUSHKI_PUBLIC_MERCHANT_ID> -e KUSHKI_PRIVATE_MERCHANT_ID=<KUSHKI_PRIVATE_MERCHANT_ID> -- npx -y @codespar/mcp-kushki`. Вместо плейсхолдеров подставьте оба идентификатора мерчанта.
Что делает mcp-kushki?
Даёт агенту 10 инструментов для платёжного API Kushki: токенизация карт, списания и preauth, переводы PSE и SPEI, наличные ваучеры и подписки.
Какие ключи нужны для работы mcp-kushki?
Два обязательных: KUSHKI_PUBLIC_MERCHANT_ID для токенизации и KUSHKI_PRIVATE_MERCHANT_ID для операций с деньгами. KUSHKI_ENV необязателен и по умолчанию равен sandbox, для боевой среды укажите production.
