mcp-culqi — MCP-сервер для Claude Code: платежи Culqi
20 инструментов для перуанского платёжного провайдера Culqi: списания, возвраты, карты, Yape, PagoEfectivo и подписки прямо из чата с агентом.
claude mcp add mcp-culqi -e CULQI_SECRET_KEY=<CULQI_SECRET_KEY> -- npx -y @codespar/mcp-culqiЧто делает mcp-culqi
Сервер закрывает API Culqi версии 2 со ставкой на операции, повторяющие рабочий день мерчанта: создать токен карты, провести списание, поймать авторизованный платёж, оформить возврат. Отдельные инструменты добавлены под клиентов и привязанные карты — их можно переиспользовать в следующих списаниях.
Оплата без карты идёт через заказы: create_order для Yape, PagoEfectivo и банковского перевода, затем confirm_order. Для подписок нужны create_plan и create_subscription, а создание требует принятия условий через tyc: true — без этого подписка не заведётся. Суммы передаются в копейках валюты, поддерживаются PEN и USD.
Перед запуском положите секретный ключ в CULQI_SECRET_KEY. Песочницы как отдельного адреса у Culqi нет: окружение выбирает префикс ключа, sk_test_ или sk_live_. Токенизацию карт сервер выполняет инструментом create_token, но он для тестовых скриптов — реальные номера карт с бэкенда без PCI-периметра гонять нельзя.
Какие задачи решает
- провести списание по карте и посмотреть его статус
- оформить возврат по уже пойманному платежу
- привязать карту к клиенту для повторных оплат
- выставить заказ на оплату через Yape или PagoEfectivo
- завести план и подключить к нему подписчика
Примеры запросов агенту
- Создай заказ на 5000 в PEN и подтверди его после оплаты через Yape
- Оформи возврат по платежу, найди его через
list_charges - Заведи клиента и привяжи к нему карту из нового токена
Как установить mcp-culqi
Командой платформы
claude mcp add mcp-culqi -e CULQI_SECRET_KEY=<CULQI_SECRET_KEY> -- npx -y @codespar/mcp-culqiВместо <…> подставьте свои значения
Командой платформы
codex mcp add culqi --env CULQI_SECRET_KEY=<CULQI_SECRET_KEY> -- npx -y @codespar/mcp-culqiВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"culqi": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-culqi"
],
"env": {
"CULQI_SECRET_KEY": "<CULQI_SECRET_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"culqi": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-culqi"
],
"env": {
"CULQI_SECRET_KEY": "<CULQI_SECRET_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e CULQI_SECRET_KEY=<CULQI_SECRET_KEY> culqi npx -y @codespar/mcp-culqiВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-culqi
Как установить mcp-culqi в Claude Code?
Выполните claude mcp add mcp-culqi -e CULQI_SECRET_KEY=<CULQI_SECRET_KEY> -- npx -y @codespar/mcp-culqi. Второй вариант — через транспорт stdio: claude mcp add --env CULQI_SECRET_KEY=<CULQI_SECRET_KEY> --transport stdio culqi -- npx -y @codespar/mcp-culqi.
Что делает mcp-culqi?
Даёт агенту инструменты для API Culqi: токены, списания, возвраты, клиенты, карты, заказы, планы, подписки и вебхук-события.
Как переключиться с теста на боевой режим?
Отдельного адреса песочницы у Culqi нет. Режим задаёт префикс ключа в CULQI_SECRET_KEY: sk_test_ для тестов, sk_live_ для реальных платежей.
