Aitole — Kaspi Pay
Chấp nhận Kaspi Pay tại Kazakhstan: mã QR, hóa đơn gửi đến số điện thoại, liên kết thanh toán, hóa đơn định kỳ, trạng thái thanh toán và hoàn tiền. Trước tiên, hãy dùng môi trường thử nghiệm.
Máy chủ MCP được lưu trữ
npx add-mcp 'https://api.aitole.kz/mcp'Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác
Tài liệu
Что такое MCP и зачем он для Kaspi
MCP (Model Context Protocol) — общий стандарт, по которому ИИ-приложения подключают внешние сервисы как инструменты. Его понимают Claude, ChatGPT, Cursor, VS Code, Claude Code и другие агенты.
У Kaspi Pay нет открытого API для приёма платежей. Aitole подключается к вашей кассе Kaspi как кассир и даёт к ней API, а MCP-сервер Aitole открывает этот же API агенту. Поэтому агент может не только написать код интеграции, но и сам выставить счёт, проверить оплату или найти платёж в журнале.
Как подключить: по шагам
- Добавьте в своё ИИ-приложение сервер с адресом
https://api.aitole.kz/mcp. Где это сделать — в таблице ниже. - Приложение откроет страницу входа в Aitole. Войдите через Google: если аккаунта нет, он создаётся сразу, вместе с песочницей.
- На экране согласия проверьте, какое приложение просит доступ, и нажмите «Разрешить».
- Вернитесь в чат и напишите задачу: «встрой оплату Kaspi в мой сайт» или «выставь счёт на +7 701 123 45 67 на 5 000 ₸».
Где вставить адрес
| Приложение | Где |
|---|---|
| Claude | Настройки → Коннекторы → добавить свой коннектор с адресом https://api.aitole.kz/mcp |
| ChatGPT | Настройки коннекторов в режиме разработчика, тот же адрес |
| Cursor | Кнопка «Добавить в Cursor» в справочнике или mcp.json с полем url |
| Claude Code | claude mcp add --transport http aitole https://api.aitole.kz/mcp |
| VS Code и другие | Новый MCP-сервер типа HTTP с этим адресом |
Если приложение не умеет входить по OAuth, передайте ключ из кабинета сами: заголовок Authorization: Bearer sk_test_….
Что умеет агент
- Принимать оплату: QR Kaspi, счёт на номер телефона, постоянные ссылки на оплату, регулярные счета.
- Проверять оплату: статус операции, список оплаченных платежей, журнал событий.
- Возвращать и отменять: полный и частичный возврат, отмена неоплаченного счёта. Это необратимо, поэтому агент должен спрашивать подтверждение.
- Понимать, где он работает: инструмент
account_statusпоказывает режим (песочница или реальные платежи), тариф, расход и подключена ли касса Kaspi. - Встраивать приём платежей в код: агент проверяет каждый шаг в песочнице, а код пишет по справочнику API.
Песочница и реальные платежи
Сразу после входа агент работает в песочнице: QR и счета ненастоящие, оплату и отказ клиента можно разыграть. Так интеграцию проверяют до первого настоящего тенге.
Для настоящих денег нужен кассир Kaspi. Его добавляет владелец в приложении Kaspi Pay на отдельный номер, а потом в кабинете Aitole нажимает «Подключить Kaspi» и вводит код из SMS. Как это сделать, разобрано в статье о том, как добавить кассира в Kaspi Pay. Агент этот шаг сделать не может и не должен просить у вас пароль или код из SMS.
Когда касса подключена, переподключите агента и на экране согласия включите «Реальные платежи». Включить их без подключённой кассы нельзя.
Безопасность
- Каждый подключённый агент получает свой ключ. Он виден на странице «Ключи» с подписью вроде «MCP: Claude» и отзывается одной кнопкой. После отзыва агент теряет доступ сразу.
- Лимиты тарифа, лимит частоты запросов и журнал действий у агента те же, что у обычного API.
- Деньги покупателей идут напрямую на ваш счёт Kaspi. Aitole не банк и не платёжная организация и чужие деньги не держит.