MCP деген не және ол Kaspi үшін не үшін керек
MCP (Model Context Protocol) — ЖИ-қосымшалар сыртқы сервистерді құрал ретінде қосатын ортақ стандарт. Оны Claude, ChatGPT, Cursor, VS Code, Claude Code және басқа агенттер түсінеді.
Kaspi Pay-де төлем қабылдауға арналған ашық API жоқ. Aitole сіздің Kaspi кассаңызға кассир ретінде қосылып, оған API береді, ал Aitole MCP-сервері сол 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-ға қосу» батырмасы немесе url өрісі бар mcp.json |
| Claude Code | claude mcp add --transport http aitole https://api.aitole.kz/mcp |
| VS Code және басқалар | Осы мекенжаймен HTTP түріндегі жаңа MCP-сервер |
Қосымша OAuth арқылы кіре алмаса, кабинеттегі кілтті өзіңіз беріңіз: Authorization: Bearer sk_test_… тақырыбы.
Агент не істей алады
- Төлем қабылдау: Kaspi QR, телефон нөміріне шот, тұрақты төлем сілтемелері, тұрақты шоттар.
- Төлемді тексеру: операция мәртебесі, төленген төлемдер тізімі, оқиғалар журналы.
- Қайтару және болдырмау: толық және ішінара қайтару, төленбеген шотты болдырмау. Бұл қайтымсыз, сондықтан агент растау сұрауы керек.
- Қай жерде жұмыс істеп тұрғанын түсіну:
account_statusқұралы режимді (сынақ ортасы немесе нақты төлемдер), тарифті, шығынды және Kaspi кассасы қосылған-қосылмағанын көрсетеді. - Төлем қабылдауды кодқа қосу: агент әр қадамды сынақ ортасында тексереді, ал кодты API анықтамалығы бойынша жазады.
Сынақ ортасы және нақты төлемдер
Кіргеннен кейін агент бірден сынақ ортасында жұмыс істейді: QR мен шоттар жалған, клиенттің төлеуін және бас тартуын ойнатып көруге болады. Интеграцияны осылай алғашқы нақты теңгеге дейін тексереді.
Нақты ақша үшін Kaspi кассирі керек. Оны иесі Kaspi Pay қосымшасында жеке нөмірге қосады, содан кейін Aitole кабинетінде «Подключить Kaspi» батырмасын басып, SMS кодын енгізеді. Мұны қалай жасау керектігі Kaspi Pay-ге кассирді қалай қосу туралы мақалада айтылған. Агент бұл қадамды жасай алмайды және сізден құпиясөз немесе SMS кодын сұрамауы керек.
Касса қосылғанда агентті қайта қосып, келісім экранында «Реальные платежи» қосыңыз. Касса қосылмаған кезде оларды қосу мүмкін емес.
Қауіпсіздік
- Әр қосылған агент өз кілтін алады. Ол «Ключи» бетінде «MCP: Claude» сияқты белгімен көрінеді және бір батырмамен кері қайтарылады. Кері қайтарылғаннан кейін агент қолжетімділіктен бірден айырылады.
- Агенттің тариф шектері, сұрау жиілігінің шегі және әрекеттер журналы кәдімгі API-дегідей.
- Сатып алушылардың ақшасы тікелей сіздің Kaspi шотыңызға түседі. Aitole банк те, төлем ұйымы да емес және бөтен ақшаны ұстамайды.