> Источник: https://apipay.kz/guides/podklyuchenie-apipay-mcp · Обновлено: 2026-09-19 · apipay.kz
> ApiPay — независимый сервис приёма платежей поверх вашего Kaspi Pay.

# Подключение ApiPay Setup MCP

Setup MCP помогает ИИ-помощнику провести владельца бизнеса через настройку ApiPay. Он не выставляет счета, не принимает платежи и не делает возвраты.

Адрес MCP-сервиса вы получаете в кабинете: **Настройки → Подключение** — там же лежит готовая инструкция для ИИ-помощника и команды подключения. Без входа в ApiPay работают справка по документации и план интеграции; действия с вашей организацией требуют подтверждения доступа. Настроить ApiPay можно и обычным путём, без ИИ: [настройка ApiPay за 15 минут](/guides/nastroyka-apipay-za-15-minut).

## Подключение к ИИ-помощнику

Подставьте адрес из кабинета вместо `<адрес>`.

- **Claude Code** — `claude mcp add --transport http apipay-setup <адрес>`
- **Codex** — `codex mcp add apipay-setup --url <адрес>`
- **Cursor** — в настройках MCP добавьте сервер с именем `apipay-setup` и полем `url`

Что подключение состоялось, видно по инструментам `search_docs` и `plan_integration`.

При первом действии с вашей организацией инструмент предложит войти в ApiPay. На странице входа проверьте название клиента, организацию и запрашиваемые права — подтверждайте доступ только своему клиенту. Доступ отзывается в кабинете: после отзыва инструмент запросит подтверждение заново. Постоянный API-ключ входом в MCP не является.

## Настройка по шагам

1. Попросите ИИ: «Подключи ApiPay к проекту». Помощник изучит ваш проект и составит план.
2. Выберите организацию или прямо попросите создать новую.
3. Ответьте на вопросы о бизнесе. Скриншоты для анкеты вы загружаете сами в кабинете. Проверьте ответы перед отправкой — одобрение выдаёт модератор.
4. Дождитесь одобрения анкеты и подключите кассира: укажите его телефон и код из SMS. До одобрения анкеты этот шаг отвечает отказом. Под номером кассира не входите в приложение Kaspi Pay для бизнеса: Kaspi держит одну сессию на номер, и такой вход обрывает привязку — берите номер, под которым в Kaspi Pay никто не входит (личным приложением Kaspi на нём пользоваться можно). Подробнее — [требования к номеру кассира](/guides/trebovaniya-k-nomeru-kassira). В песочнице интеграцию можно собирать и проверять сразу, кассир для неё не нужен.
5. Создайте API-ключ. Помощник откроет вам страницу `apipay.kz/setup/key` — там одна кнопка и ничего лишнего. Ключ и секрет подписи показываются один раз: скопируйте их сразу. Рядом будет готовая команда, которая впишет значения в файл вашего проекта, — запускайте её в терминале, а не в переписке с помощником.
6. Подтвердите адрес для уведомлений. Помощник проверит настройки и предложит технический тест webhook. Реальный платёж этим тестом не проверяется.
7. Перед переходом в рабочий режим помощник покажет свежие проверки и количество удаляемых тестовых записей. Удаление тестовых данных необратимо, вернуть их нельзя. Переход действует на всю организацию и требует отдельного подтверждения.

Повторную отправку кода из SMS запускает только владелец. Если попытки исчерпаны, дождитесь окончания паузы. Переписку хранит ваш ИИ-клиент, и MCP её удалить не может; сам сервер код из SMS не сохраняет.

## Секреты и журнал действий

Ключи в переписку с ИИ не вставляйте. Не разрешайте помощнику читать файл с ключами и выводить его содержимое — ни при отладке, ни «чтобы проверить». Держите этот файл вне репозитория: добавьте его в `.gitignore`.

Пакеты с именем `apipay` в npm, PyPI и Packagist к ApiPay.kz отношения не имеют — не устанавливайте их. Из программ ApiPay.kz раздаёт только узел для n8n (`n8n-nodes-apipay`); всё остальное, что нужно для настройки, вы берёте в кабинете.

ApiPay ведёт журнал действий: кто, в какой организации и какой шаг выполнил, с каким результатом. Значения ключей, кодов из SMS, телефонов и ответов анкеты в журнал не попадают.

## Если действие зависло

При `EXECUTION_UNKNOWN` помощник сначала проверяет операцию через `get_setup_status` с прежним ключом операции. Пока исход не установлен, отправлять SMS заново и переключать режим нельзя. Если проверка вернула `unknown`, исход ещё не установлен — это не успех: дождитесь определённого ответа или напишите в поддержку.

Актуальные инструкции клиентов: [Claude Code](https://code.claude.com/docs/en/mcp), [Codex](https://developers.openai.com/codex/mcp), [Cursor](https://docs.cursor.com/context/model-context-protocol).

---

ApiPay — независимый сервис и не аффилирован с АО «Kaspi Bank». Kaspi и Kaspi Pay — товарные знаки их правообладателя.
База знаний: https://apipay.kz/guides