# Как подключить Kaspi Pay к Claude, ChatGPT и Cursor через MCP

> Вставьте адрес https://api.aitole.kz/mcp в своё ИИ-приложение, войдите в Aitole через Google и нажмите «Разрешить». Ключ копировать не нужно, аккаунт создаётся при входе. Дальше агент сам выставляет QR и счета Kaspi, проверяет оплату, делает возвраты и встраивает приём платежей в ваш код. Сначала он работает в песочнице без настоящих денег. Для реальных платежей нужно один раз подключить кассира Kaspi.

Источник: https://aitole.kz/kaspi-mcp/ · Aitole — https://aitole.kz

Aitole · Опубликовано 15.11.2026

## Что такое MCP и зачем он для Kaspi

MCP (Model Context Protocol) — общий стандарт, по которому ИИ-приложения подключают внешние сервисы как инструменты. Его понимают Claude, ChatGPT, Cursor, VS Code, Claude Code и другие агенты.

У Kaspi Pay нет открытого API для приёма платежей. Aitole подключается к вашей кассе Kaspi как кассир и даёт к ней API, а MCP-сервер Aitole открывает этот же API агенту. Поэтому агент может не только написать код интеграции, но и сам выставить счёт, проверить оплату или найти платёж в журнале.

## Как подключить: по шагам

1. Добавьте в своё ИИ-приложение сервер с адресом `https://api.aitole.kz/mcp`. Где это сделать — в таблице ниже.
2. Приложение откроет страницу входа в Aitole. Войдите через Google: если аккаунта нет, он создаётся сразу, вместе с песочницей.
3. На экране согласия проверьте, какое приложение просит доступ, и нажмите «Разрешить».
4. Вернитесь в чат и напишите задачу: «встрой оплату Kaspi в мой сайт» или «выставь счёт на +7 701 123 45 67 на 5 000 ₸».

## Где вставить адрес

| Приложение | Где |
|---|---|
| Claude | Настройки → Коннекторы → добавить свой коннектор с адресом `https://api.aitole.kz/mcp` |
| ChatGPT | Настройки коннекторов в режиме разработчика, тот же адрес |
| Cursor | Кнопка «Добавить в Cursor» в [справочнике](/docs/#mcp) или `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](/docs/).

## Песочница и реальные платежи

Сразу после входа агент работает в песочнице: QR и счета ненастоящие, оплату и отказ клиента можно разыграть. Так интеграцию проверяют до первого настоящего тенге.

Для настоящих денег нужен кассир Kaspi. Его добавляет владелец в приложении Kaspi Pay на отдельный номер, а потом в кабинете Aitole нажимает «Подключить Kaspi» и вводит код из SMS. Как это сделать, разобрано в статье о том, [как добавить кассира в Kaspi Pay](/kaspi-kassir/). Агент этот шаг сделать не может и не должен просить у вас пароль или код из SMS.

Когда касса подключена, переподключите агента и на экране согласия включите «Реальные платежи». Включить их без подключённой кассы нельзя.

## Безопасность

- Каждый подключённый агент получает свой ключ. Он виден на странице «Ключи» с подписью вроде «MCP: Claude» и отзывается одной кнопкой. После отзыва агент теряет доступ сразу.
- Лимиты тарифа, лимит частоты запросов и журнал действий у агента те же, что у обычного API.
- Деньги покупателей идут напрямую на ваш счёт Kaspi. Aitole не банк и не платёжная организация и чужие деньги не держит.

## Вопросы

### Нужно ли уметь программировать?

Нет. Чтобы выставлять счета и проверять оплату через чат, достаточно подключить сервер и войти. Программировать нужно, только если вы хотите встроить приём платежей в свой сайт или бота, и это тоже может сделать агент.

### Сколько это стоит?

MCP-сервер есть на всех тарифах, включая Free: 20 оплаченных платежей в месяц бесплатно навсегда. Платные тарифы нужны, когда платежей больше.

### Какие приложения поддерживаются?

Любые, что подключают удалённые MCP-серверы по HTTP: Claude, ChatGPT, Cursor, VS Code, Claude Code, Windsurf и другие. Вход без ключа работает там, где приложение поддерживает вход по OAuth. В остальных передайте ключ в заголовке.

### Может ли агент случайно списать деньги?

В песочнице деньги не двигаются вовсе. Реальные платежи включаете вы сами на экране согласия, и только при подключённой кассе. Возвраты и отмены агент должен подтверждать у вас, а отозвать доступ можно в любой момент.