Что такое 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 не банк и не платёжная организация и чужие деньги не держит.