← Назад к материалам
Kaspi × Claude · Пошаговое объяснение

Карманный аналитик Kaspi
— установка по шагам

Делайте по порядку, ничего не пропуская. Программировать не нужно — всю настройку выполнит Claude, вы только делаете простые клики и в конце вставляете один готовый текст со своим токеном. Время: ~15 минут.

1

Установить Node.js

Если ещё не установлен — откройте nodejs.org → большая кнопка LTS → скачайте файл → запустите → устанавливайте по умолчанию (Next / Далее до конца, ничего не меняя).

Проверка не требуется — если установщик дошёл до «Finish», всё ок.

2

Установить VS Code

Если ещё не установлен — откройте code.visualstudio.com → кнопка Download (сайт сам определит вашу систему) → установите по умолчанию.

VS Code — это просто удобное окно: внутри будет папка проекта, чат с Claude и встроенный терминал. Бояться нечего.

3

Поставить расширение Claude Code

Запустите VS Code → слева иконка Extensions (четыре квадратика) → в поиске наберите Claude Code → выберите расширение от Anthropic → Install → войдите (Sign in), откроется браузер, подтвердите и вернитесь в VS Code.

Важно: ставьте именно «Claude Code» от Anthropic — не «Claude Dev» и не другие похожие. Это разные расширения.

4

Скачать архив и распаковать на Рабочий стол

Скачайте файл kaspi-mcp.zip по ссылке — он попадёт в Загрузки:

ссылка на архив: https://drive.google.com/file/d/1vCVd3Ehu9vfyF8RTfQMQzRMdxtmH9hta/view?usp=sharing

Перетащите его на Рабочий стол, затем распакуйте. Windows правый клик → «Извлечь всё». Mac двойной клик по архиву. На Рабочем столе появится папка kaspi-mcp.

Важно: распаковывайте именно на Рабочий стол — так папку проще найти на следующем шаге.

5

Открыть папку в VS Code

VS Code → меню File → Open Folder… (Файл → Открыть папку) → выберите папку kaspi-mcp на Рабочем столе → Open.

Слева появится список файлов проекта. Если спросит «Do you trust the authors?» — нажмите Yes / Trust. Без этого Claude и коннектор не увидят проект.

6

Вставить один промпт со своим токеном

Откройте чат Claude Code (иконка Claude слева). Сначала возьмите токен: Kaspi Merchant Cabinet → Настройки → API → X-Auth-Token, скопируйте. Затем вставьте в чат текст ниже, подставив свой токен вместо ВСТАВЬ_СВОЙ_ТОКЕН, и нажмите Enter:

Это проект kaspi-mcp, папка уже открыта. Разверни его по шагам, объясняя простыми словами: 1) выполни npm install 2) создай .env из .env.example 3) впиши в .env мой Kaspi-токен: ВСТАВЬ_СВОЙ_ТОКЕН 4) запусти npm run sync (данные за 30 дней) 5) скажи, когда коннектор kaspi готов, и дай 4 примера вопросов. Если попросишь разрешение запустить команду — я нажму «разрешить».

Дальше Claude работает сам: ставит зависимости, создаёт настройки, синхронизирует данные за 30 дней. Просто читайте, что он пишет, и при запросе разрешения нажимайте «разрешить».

Безопасность: токен сохранится только у вас на компьютере (в файле .env проекта), никуда не отправляется. После форума можете перевыпустить его в кабинете Kaspi — старый перестанет работать.

7

Перезапустить и спрашивать

Claude скажет, что данные загружены. Перезагрузите окно: Ctrl/Cmd+Shift+P → Reload Window. Если появится запрос — разрешите коннектор kaspi. Теперь спрашивайте обычным языком:

Какая у меня выручка за 30 дней?
Где теряю на отменах? Превышен ли порог Kaspi 3%?
Топ-10 городов по выручке
Сколько идёт через Kaspi Kredit?
★

Бонус — отчёт для собственника одной командой

Вставьте в чат Claude Code:

Сделай отчёт для собственника: выполни npm run report — он создаст файл report.html прямо в папке проекта на Рабочем столе. Затем открой report.html в браузере, чтобы я сразу увидел результат, и в двух словах скажи главные выводы и риски.

Файл report.html — KPI, график выручки, топ-города, структура оплаты, выводы и риски. Откроется сразу, печатается в PDF (Ctrl/Cmd+P).

Если что-то пошло не так

Расширения «Claude Code» нет в поиске / поставил не то
Ищите именно Claude Code от Anthropic (не «Claude Dev»). Если поставили не то — удалите, поставьте правильное, перезапустите VS Code.
Чат Claude Code не открывается
Проверьте что вошли в аккаунт (Sign in) на шаге 3. Ctrl/Cmd+Shift+P → наберите «Claude» → выберите команду фокуса на чат.
Слева нет файлов / Claude «не видит проект»
Папка открыта неправильно. File → Open Folder → выберите именно папку kaspi-mcp (не отдельный файл). На запрос «Do you trust the authors?» нажмите Trust.
Ошибка на npm install / sync
Скажите Claude в чате: «повтори с того места где упало» — часто помогает. Mac при ошибке про права — «запусти с sudo». Windows запустите VS Code от имени администратора.
Спрашиваю — отвечает «нет данных»
Синхронизация не прошла или токен не вписан. Скажите Claude: «проверь .env и выполни npm run sync заново» — он подскажет, что сделать. После — Reload Window.
@almas_kasymzhanov