# PAT токен в CloudCart: свържете Claude, ChatGPT и Gemini с магазина PAT токен в CloudCart: как се създава в админа, какви права да дадете на Claude, ChatGPT или Gemini, кога с IP ограничение и как спирате достъпа веднага. Източник: https://cloudcart.com/blog/ai-assistant-store-management · CloudCart · 2026-11-05 Накратко: PAT токенът (Personal Access Token) е ключът, с който AI агент като Claude Code, ChatGPT Codex или Gemini CLI влиза в магазина ви в CloudCart. Създава го само собственикът в Настройки → PAT токени. Токенът започва с cc_pat_, показва се веднъж и носи едно от три нива на достъп: Read Only, Full Access или Custom Permissions. Това ръководство е само за ключа: как се създава, какви права да му дадете, кога да го вържете за IP адрес и как спирате достъпа. Как се инсталира агентът и какво може да прави след това е описано в статиите за [Claude Code и онлайн магазина](https://cloudcart.com/blog/online-store-with-claude), [ChatGPT и Codex стъпка по стъпка](https://cloudcart.com/blog/online-store-with-chatgpt) и [Gemini CLI от терминала](https://cloudcart.com/blog/online-store-with-gemini-cli). Имената на екраните и полетата са както ги показва админът на CloudCart, българската платформа за онлайн магазини. Проверени са на 04.11.2026 в документацията на платформата и на страниците [AI интеграция с CloudCart](https://cloudcart.com/bg/offer/ai) и [За разработчици](https://cloudcart.com/developers). ## Какво е PAT токен в CloudCart PAT токенът е личен ключ за достъп на собственика, с който CloudCart API за администрация (Admin GraphQL API) и CloudCart CLI разпознават кой изпраща заявката. Всяка заявка с токена работи от името на собственика, но само в рамките на правата, срока и IP адресите, които сте задали на токена. Токенът е низ от 71 знака: cc_pat_ и 64 случайни шестнайсетични знака. Платформата пази само хеша му (SHA-256), затова стойността се вижда един-единствен път, в зеления панел „Token Created Successfully!“ след създаването. Изгубен токен не се възстановява: изтривате го и правите нов. ### PAT токен или API ключ: коя е разликата PAT токенът е за AI агенти и Admin GraphQL API, а API ключът е за REST API и постоянни интеграции. В CloudCart има още два вида ключове за headless витрини и е лесно да ги объркате. Таблицата показва кой за какво е: | Ключ | Къде се прави | За какво служи | Права | | PAT токен | Настройки → PAT токени | AI агенти, CloudCart CLI, Admin GraphQL API ( /api/gql ) | Read Only, Full Access или избрани ресурси; срок и IP адреси | | API ключ | Настройки → Api keys | REST API ( /api/v2 ) за външни интеграции: ERP, системи за автоматизация, скриптове | Целият магазин, без деление по ресурси; от Starter Pack нагоре, с лимит по план | | Deployment token | Страницата на Nitrogen витрина, раздел Deployments | Качване на headless витрина с cloudcart nitrogen deploy | Само deploy на тази витрина | | Storefront API токени | Страницата на Nitrogen витрина, раздел Storefront API | Заявки на витрината към каталога (публичен и частен токен) | Данните на витрината | За AI агент ви трябва PAT токен. API ключът е за фиксирани интеграции, а Nitrogen токените са за разработчици на собствени витрини. ## За кого и кога е нужен PAT токен PAT токен е нужен на всеки собственик, който иска AI агент да чете или променя магазина, и на всеки, който ползва CloudCart CLI. Функцията няма ограничение по план: екранът PAT токени е еднакъв в Baby Pack, Starter Pack, CC Pro и CC Master. - Свързвате агента за първи път. След като поставите изречението от картата „Свържи магазина си с AI агент“ на таблото, агентът сам инсталира нужното и накрая ви пита за две неща: адреса на магазина и PAT токен. - Искате само отчети. Агент, който ви казва сутрин продажбите, склада и изоставените колички, се справя с токен Read Only. Пример за такава задача е в статията отчет за продажбите в 8:00 с AI агент . - Давате работа на агента в отделна част от магазина. Например само продукти и наличности, без поръчки и клиенти: това става с Custom Permissions. - Работите на няколко компютъра или с няколко агента. Отделен токен за всеки ви позволява да спрете един, без да пипате другите. Токенът не е акаунт на служител и не се брои към лимита за администратори на плана. Baby Pack включва 1 администратор ([условията на плановете](https://cloudcart.com/bg/offer/online-store-for-1-euro)), а агентът работи, без да заема второ място. Цените на всички планове са на [страницата с цените](https://cloudcart.com/pricing). > Магазин с AI асистент Едно изречение и един ключ: агентът е свързан Свързването е без такса от CloudCart и работи с Claude Code, ChatGPT Codex, Cursor, VS Code и Gemini CLI. Абонамента за самия агент плащате на неговия доставчик, а правата му решавате вие с PAT токена. Как се свързва AI асистентът → ## Как се създава PAT токен: стъпка по стъпка PAT токен се създава от екрана Настройки → PAT токени (пътят в админа е Settings → Account → PAT Tokens) или от менюто на потребителя долу вляво → PAT токени. Нужни са име на токена и ниво на достъп, останалото е по желание. - Влезте като собственик. Само собственикът на магазина създава и управлява токените. Администратор или модератор получава отказ „Only store owners can manage CLI tokens“, а в правата на служителите няма отметка, с която това да се делегира. - Отворете PAT токени. Горе е броячът „N of 100 tokens“: до 100 токена на собственик. Ако още нямате токен, натиснете Create Your First Token , иначе Create Token . - Попълнете Token Details. Token Name е задължително (до 100 знака): напишете за кого е, например „Claude Code, лаптоп в офиса“. Description е по желание (до 500 знака). - Изберете ниво в Permissions. Три карти: Read Only (отбелязана „Recommended“ и избрана по подразбиране), Full Access и Custom Permissions . Кое кога е подходящо, вижте в следващия раздел. - Отворете Advanced Settings, ако искате срок или IP. Секцията е свита. В Token Validity изключете „No expiration“ и изберете крайна дата. В IP Restrictions с Add IP Address добавяте до 20 адреса или диапазона. - Натиснете Generate Token. Появява се панелът „Token Created Successfully!“ с целия токен и бутон Copy . Копирайте го веднага: след Done стойността изчезва завинаги. Кликът извън прозореца не го затваря, за да не загубите токена случайно. - Дайте токена на агента. Поставете го в чата на агента, когато той го поиска, заедно с адреса на магазина без https:// (например mystore.cloudcart.net или mystore.com ). Агентът го използва само в командата за вход и го пази на вашия компютър. - Проверете с въпрос. На екрана няма бутон за тест. Напишете на агента „Колко поръчки имах вчера?“. Ако отговори, колоната Last used at на токена ще покаже часа на заявката. Важно: токенът работи от всеки компютър за всеки, който го има, освен ако не сте задали IP адреси. Пазете го като парола: не го пращайте по имейл, не го снимайте и не го слагайте в споделени документи. ## Какви права да дадете на PAT токена Започнете с Read Only и минете към по-широк достъп, когато агентът трябва да променя нещо. Това е принципът на най-малките права (least privilege), който препоръчват и [NIST](https://csrc.nist.gov/glossary/term/least_privilege), и [OWASP](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html): всеки ключ има точно толкова достъп, колкото му трябва за задачата. | Ниво | Какво позволява | Кога да го изберете | | Read Only | Чете всичко, не променя нищо. Всяка промяна се отказва. | Отчети, KPI, въпроси за склада и поръчките, първите дни с агента | | Full Access | Чете и променя всичко в магазина | Агентът създава магазина, пише описания, сменя цени и настройки | | Custom Permissions | Само избраните ресурси, всеки с None, Read или Read & Write | Агентът работи в една част: например продукти и наличности | В Custom Permissions има 8 реда: Products, Orders, Customers, Inventory, Discounts, Blog, Settings и Webhooks. Inventory и Discounts нямат вариант само за четене: агент, който трябва да види наличностите, получава пълния достъп до Inventory. Ако оставите всички редове на None, токенът се записва като Read Only. Долу има бързи бутони Select all as Read, Select all as Read & Write и Clear all. ### Коя задача какви права иска Таблицата е за най-честите задачи, които търговците дават на агента. Изреченията са примери, които можете да поставите директно: | Задача | Изречение към агента | Минимални права | | Сутрешен отчет и KPI | „Сравни вчерашния приход със същия ден миналата седмица.“ | Read Only | | Нов ценоразпис от доставчика | „Обнови цените по кодовете и ми покажи кои липсват.“ | Products: Read & Write | | Списък за поръчка към доставчик | „Кои продукти са под 5 бройки? Направи таблица.“ | Products: Read + Inventory | | Промоция за Черния петък | „Направи 15% отстъпка за категория „Зима“ до неделя.“ | Discounts + Products: Read | | Статия в блога на магазина | „Напиши чернова за грижа за кожа през зимата.“ | Blog: Read & Write | | Отчет по категории | „Покажи продажбите по категории за октомври.“ | Settings: Read (отчетите са в Settings) | Повече готови изречения има в [30 промпта за поръчки, склад, цени и SEO](https://cloudcart.com/blog/ai-prompts-online-store), а кои числа да следите и как агентът ги смята, е описано в [10-те KPI на онлайн магазина](https://cloudcart.com/blog/ecommerce-kpi-metrics-ai-agent). ## Какви права иска агентът за имейли, реклами и метрики За маркетинга агентът има нужда от Settings, защото в Admin GraphQL API кампаниите, приложенията, SEO настройките и отчетите на магазина са под този ресурс. Абонатите и клиентите са под Customers. PAT токенът отваря за агента само магазина в CloudCart: резултатите в Meta Ads Manager, Google Ads, TikTok Ads Manager и Google Search Console се четат с отделен достъп, който давате в съответната услуга. | Работа | Какво прави агентът в CloudCart | Минимални права на токена | Какво остава извън токена | | Имейл кампания в Marketing Suite | Пише кампанията от реалните продукти и цени, избира сегмента абонати, подготвя шаблона | Settings: Read & Write, Customers: Read, Products: Read | Нищо: имейлите, SMS, Viber и web push са в Маркетинг на магазина | | Meta (Facebook и Instagram) | Проверява Pixel ID и Conversions API в Приложения → XML Feed → Facebook, пише рекламни текстове за най-продаваните продукти | Settings: Read, Products: Read, Orders: Read | Бюджетите и резултатите на рекламите в Meta Ads Manager | | Google Ads и Google Shopping | Подобрява заглавията и описанията на продуктите, които влизат във фийда, проверява Google Dynamic Remarketing и Google Tag Manager | Products: Read & Write, Settings: Read | Кампаниите и разходите в акаунта на Google Ads | | TikTok | Проверява приложенията TikTok Pixel и TikTok Shop и продуктите, които влизат в каталога за TikTok | Settings: Read, Products: Read | Кампаниите и бюджетите в TikTok Ads Manager | | Google Search Console | Проверява верификацията в Приложения → Google Search Console, пише SEO заглавия и мета описания на продуктите | Products: Read & Write, Settings: Read | Заявките, кликовете и позициите в Search Console | | Метрики на магазина | Смята прихода, броя поръчки, средната поръчка, дела на повторните клиенти, най-продаваните продукти и ниските наличности | Read Only | Сесиите от GA4, ако ги искате и оттам | Метриките не изискват да отваряте екран: питате агента с Read Only токен „Каква е средната поръчка за октомври спрямо септември и кои 5 продукта носят най-много приход?“ и той смята числата от поръчките. Read Only е достатъчен за всеки отчет, защото чете и Settings, и Customers, и Orders, без да може да промени нещо. Кои 10 числа си заслужава да следите, е разписано в [KPI на онлайн магазина с AI агент](https://cloudcart.com/blog/ecommerce-kpi-metrics-ai-agent). Мобилните посещения са отделен ред в отчета Analytics → Сесии по тип устройство (mobile, desktop, tablet). Посещенията с неразпознато устройство се броят към desktop, затова делът на мобилните там е по-скоро занижен. Какво да проверите в мобилната версия, е в статията [мобилната версия на онлайн магазина](https://cloudcart.com/blog/mobile-version-online-store). Каналите поотделно са описани в ръководствата за [имейл кампания в CloudCart стъпка по стъпка](https://cloudcart.com/blog/email-campaign-cloudcart-step-by-step), [Meta реклами за онлайн магазин](https://cloudcart.com/blog/meta-ads-online-store), [Google Ads за онлайн магазин](https://cloudcart.com/blog/google-ads-online-store), [TikTok Shop и TikTok Ads](https://cloudcart.com/blog/tiktok-shop-tiktok-ads) и [Google Search Console за онлайн магазин](https://cloudcart.com/blog/google-search-console-online-store). Важно: за рекламни текстове и имейли агентът няма нужда да вижда клиентите поименно. Дайте Customers: Read само когато задачата е сегмент от абонати или отчет за повторните клиенти. > Магазин за €1 €1 на месец за първите 3 месеца, с PAT токени във всеки план PAT токените и AI агентът работят и в Baby Pack, най-малкия план. Нов магазин до 31.12.2026 плаща €1 на месец за първите 3 месеца на всеки план, затова можете да пробвате агента върху истински магазин още тази седмица. Създайте магазин за €1 → ## С IP ограничение ли да е и какъв срок да има токенът IP ограничение слагайте, когато агентът работи от адрес, който не се сменя: офис, сървър или CI. Ако работите от лаптоп у дома и доставчикът на интернет ви дава променлив адрес, оставете списъка празен и сложете кратък срок. - Празен списък означава, че токенът работи от всеки адрес. Това е стойността по подразбиране. - Един адрес се пише като 192.168.1.100 , цяла мрежа като 192.168.1.0/24 (256 адреса). Поддържат се IPv4, IPv6 и CIDR диапазони, до 20 на токен. - Заявка от друг адрес получава отказ IP_NOT_ALLOWED, а колоната Last used at не се променя. Така тя показва само успешните заявки. Срокът (Token Validity) по подразбиране е „No expiration“: токенът работи, докато не го изтриете или изключите. Крайната дата трябва да е в бъдещето. Сложете си напомняне в календара за датата на изтичане, за да не спре агентът внезапно. Разумна практика е 30 до 90 дни за токен на лаптоп и без срок само за токен, вързан за IP на сървър. ## Как да спрете достъпа на AI агента Достъпът спира веднага, на всички компютри, когато изключите или изтриете токена в PAT токени. Двата начина имат различни последици: | Действие | Къде | Какво става | Обратимо ли е | | Изключване (Active) | Превключвателят на реда | Всяка заявка се отказва; токенът остава в списъка | Да: включвате го и същият токен пак работи | | Изтриване (Delete) | Бутонът на реда, с потвърждение „This action cannot be undone.“ | Хешът се унищожава завинаги | Не: правите нов токен с нова стойност | | cloudcart auth logout | Терминалът на компютъра с агента | Изтрива входа само на този компютър | Да, с нов вход | Изключването е удобно за пауза, например докато сте в отпуск. Изтриването е правилният ход, щом подозирате, че токенът е попаднал в чужди ръце. Редакцията не сменя стойността: за нов ключ със същите права изтривате стария и създавате нов. Ако собствеността на магазина мине към друг човек, PAT токените на предишния собственик не преминават към новия: той създава свои. ## Какво печелите с PAT токен и AI агент С правилно настроен токен една задача от десетки кликове става едно изречение, а рискът остава под контрол. В магазин за козметика с 300 продукта нов ценоразпис от доставчика означава да сверите 300 кода и 300 цени. Агент с токен Products: Read & Write сравнява кодовете, показва ви разликите и сменя цените с една масова операция, която върви на заден план. - Скорост. Admin GraphQL API приема 300 заявки в минута на адрес на магазин, а масовите промени минават като една фонова задача вместо стотици отделни. - Контрол. Read Only токен не може да промени нищо, дори агентът да сбърка заявката. Отказът назовава точно правото, което липсва. - Проследимост. Промените през токена се записват като направени от собственика. С отделен токен за всеки агент и колоната Last used at виждате кой ключ кога е работил. - Без нов служител. Агентът не заема админ акаунт от плана и не иска отделна парола за вход в админа. Колко часа на седмица спестява това за типичен магазин, сме сметнали в статията [AI агент за онлайн магазин: колко часа и пари спестява](https://cloudcart.com/blog/ai-agent-online-store-why), а масовите промени са разписани в [масова промяна на цени и наличности с едно изречение](https://cloudcart.com/blog/bulk-catalog-changes-ai). CloudCart взима [0% комисионна от продажбите](https://cloudcart.com/bg/offer/zero-commission-ecommerce), затова поръчките, които агентът ви помогне да спечелите, не ви струват процент към платформата. > AURA Агентът работи за вас, Aura Chat продава на клиентите PAT токенът дава достъп на вашия агент до админа. За купувачите на витрината е AURA: Aura Chat отговаря и продава в чата, а Aura Search разбира какво търси клиентът. Агентът работи с данните в админа, а Aura Chat говори с купувачите от името на магазина. Какво прави AURA → ## 7 добри практики за PAT токените - Един токен за един агент или компютър. Името казва кой и къде („Gemini CLI, сървър“). Спирате един, без да спирате останалите. - Read Only за начало. Първите дни питайте агента за отчети и наличности. Full Access давайте, когато сте видели как работи. - Искайте „първо ми покажи“. Помолете агента да покаже списъка с промени и ги потвърдете, преди да ги приложи. Така грешка в заявката се вижда, преди да стигне до магазина. - Пуснете ежедневни копия преди Full Access. След копиране на изречението от таблото админът предлага абонамент за ежедневни копия, когато магазинът може да ги има. С тях връщате целия магазин или част от него до последното дневно копие. - Срок за лаптопа, IP за сървъра. Токенът на преносим компютър с 30–90 дни, токенът на сървър вързан за адреса му. - Преглеждайте Last used at веднъж на месец. Токен, който не е ползван от седмици, изтрийте. Колоната се обновява само при успешна заявка. - Помислете какво чете доставчикът. Доставчикът на агента (Anthropic, OpenAI, Google) обработва това, което агентът прочете, по условията на вашия акаунт при него. Ако агентът няма нужда от клиентите, не му давайте Customers. ## Грешки, които да избягвате, и какво означават отказите Най-честата грешка е затварянето на прозореца, преди токенът да е копиран: тогава единственият изход е нов токен. Втората е Full Access „за всеки случай“ за агент, който само чете отчети. Третата е един общ токен за всичко, който после не можете да спрете, без да спрете всички агенти. Когато агентът не може да направи нещо, Admin GraphQL API връща код и съобщение. Таблицата показва най-честите: | Съобщение | Причина | Какво правите | | „Invalid or expired token“ | Грешно копиран токен, изключен токен или изтекъл срок | Включете токена отново или създайте нов и влезте пак в агента | | „Token has been revoked“ | Токенът е изтрит в PAT токени | Създайте нов токен и го дайте на агента | | „… writes data, which this token's scopes do not allow.“ | Read Only или само Read за този ресурс | Токен с Read & Write за ресурса | | „… needs the `inventory` scope, which this token does not have.“ | В Custom Permissions липсва ресурсът | Добавете го в Edit на токена | | IP_NOT_ALLOWED | Заявката идва от адрес извън списъка | Добавете адреса или изчистете списъка | | TOO_MANY_REQUESTS (429) | Над 300 заявки в минута на магазина | Поискайте от агента масова операция вместо цикъл | В Edit (клик на името в списъка) сменяте името, нивото на достъп, IP адресите и срока, а стойността на токена остава същата. Трите API на CloudCart и лимитите на REST API по план са описани на [страницата за разработчици](https://cloudcart.com/developers), а общите добри практики за лични токени са описани и в [документацията на GitHub](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens). ## Често задавани въпроси **Как се създава PAT токен в CloudCart?** Влезте като собственик и отворете Настройки → PAT токени или менюто долу вляво → „PAT токени“. Натиснете Create Token, въведете име, изберете ниво на достъп и натиснете Generate Token. Копирайте токена веднага, защото се показва само веднъж. **Какви права да дам на AI агента?** Започнете с Read Only, който е отбелязан като препоръчан и не позволява промени. За задача в една част от магазина изберете Custom Permissions, например Products: Read & Write за цени. Full Access давайте само на агент, който създава или настройва целия магазин. **Как да спра достъпа на агента до магазина?** Изключете или изтрийте токена в PAT токени: достъпът спира веднага, на всеки компютър. Изключването е обратимо, изтриването не е. На самия компютър командата cloudcart auth logout изтрива запазения вход. **С IP ограничение ли да е PAT токенът?** Да, ако агентът работи от постоянен адрес като офис или сървър. Добавяте до 20 адреса или CIDR диапазона в Advanced Settings → IP Restrictions. При променлив домашен адрес оставете списъка празен и сложете кратък срок на токена. **Каква е разликата между PAT токен и API ключ?** PAT токенът е за AI агенти, CloudCart CLI и Admin GraphQL API и има избор на права, срок и IP адреси. API ключът е за REST API и фиксирани интеграции като ERP и има достъп до целия магазин. За Claude, ChatGPT или Gemini ви трябва PAT токен. **Загубих PAT токена. Мога ли да го видя отново?** Не. CloudCart пази само хеша на токена и стойността не може да се възстанови. Изтрийте стария токен и създайте нов със същите права, после го дайте на агента. **Може ли служител да създаде PAT токен?** Не, само собственикът на магазина създава PAT токени, а правото не се делегира. Служител може да свърже агента с вход през браузъра: тогава агентът работи с правата на служителя за 30 дни, след което входът се повтаря. **Може ли AI агентът да чете Meta Ads, Google Ads и Search Console с PAT токена?** Не. PAT токенът дава достъп само до магазина в CloudCart: продукти, поръчки, клиенти, кампании в Marketing Suite, приложения и отчети. Данните на рекламните акаунти и на Search Console агентът чете с отделен достъп, който давате в Meta, Google или TikTok.