AI-коннектор (MCP)
Подключение вашего аккаунта Paloma365 к ИИ-ассистентам (Claude, ChatGPT и другим) по протоколу MCP. По умолчанию ассистент работает только на чтение; всё, что он может менять, вы отмечаете галочками при создании подключения.
Как открыть
Настройки → AI-коннектор (MCP) (/settings/mcp-connector).
Страница доступна владельцу аккаунта (вход логином аккаунта) и сотрудникам с интерфейсом «Администратор (Управленческий режим)». У сотрудников с интерфейсом «Менеджер» или без управленческого интерфейса, при входе кассы, рабочего места или УРВ, а также в сеансе специалиста поддержки её нет в меню.
Что это даёт
ИИ-ассистент получает доступ к данным вашего аккаунта: поиск и просмотр товаров и справочников, а если вы разрешите — создание документов, проведение, отчёты и настройки. Доступ выдаётся от имени того, кто подключил ассистента, — владельца или сотрудника-администратора — и ограничен разрешениями, которые отмечены при подключении: без галочки ассистент этого не сделает.
Поля
| Поле | Описание | Обязательное |
|---|---|---|
| Название | Метка подключения, чтобы отличать токены (например «Claude Desktop — ноутбук») | Нет |
| Срок действия | Сколько дней действует токен: 30, 90 или 365 | Да |
| Что разрешить коннектору | Галочки дополнительных разрешений (см. ниже). По умолчанию не отмечено ничего | Нет |
Что разрешить коннектору
Чтение выдаётся всегда и галочки не требует. Остальное — отдельными согласиями:
| Разрешение | Что открывает |
|---|---|
| Создание и правка | Правка товаров и создание черновиков документов. Обратимо |
| Проведение документов | Проведение документа: меняет остатки на складе и себестоимость. Необратимо |
| Настройка аккаунта | Торговые точки, рабочие места, сотрудники с логинами и паролями, помещения, столы, роли, склады |
| Отчёты | Только чтение: остатки на складе, остатки по кассам и счетам, продажи |
| Просмотр настроек | Безопасные настройки приложения (оформление, чек, смена, доставка, регион) |
| Правка настроек | Правка одной такой настройки. Включает и просмотр |
Разрешения фиксируются в момент создания подключения и потом не меняются. Чтобы добавить право, отзовите токен и создайте новый — иначе ассистент будет отвечать «инструмент недоступен».
Пошаговая инструкция
- Откройте страницу AI-коннектор (MCP).
- Укажите название и срок действия, отметьте нужные разрешения, нажмите Создать подключение.
- Скопируйте показанный токен доступа — он отображается только один раз.
- Выберите клиент:
- Claude Code — выполните показанную команду в терминале.
- Claude Desktop — добавьте показанный блок в файл
claude_desktop_config.jsonи перезапустите приложение.
- Адрес MCP-сервера уже подставлен в команду/конфиг.
Подключение ChatGPT
ChatGPT подключается как плагин — по отдельному адресу из блока ChatGPT на этой странице (он оканчивается на /mcp/plugin). Токен с этой страницы ему не нужен.
Для кабинета dashboard.paloma365.com адрес плагина — https://mcp.paloma365.com/mcp/plugin. Он постоянный и не зависит от адреса MCP-сервера в блоке выше.
Блок ChatGPT появляется, только когда плагин включён: открывая страницу, кабинет сначала проверяет, что сервер плагина отвечает по этому адресу. Если блока нет — плагин для вашего кабинета пока недоступен. Подключение Claude по токену от этого не зависит.
- Скопируйте Адрес для ChatGPT из блока ChatGPT.
- В ChatGPT откройте раздел плагинов и добавьте MCP-сервер по этому адресу.
- ChatGPT откроет окно входа Paloma365. Войдите логином аккаунта и его паролем — тем, которым владелец входит в кабинет, — или логином сотрудника с интерфейсом «Администратор (Управленческий режим)» в виде «сотрудник.аккаунт». Вход менеджера, кассы, рабочего места и УРВ здесь не подходит.
- На экране подтверждения отметьте разрешения и нажмите Разрешить.
Какие галочки что дают
Без галочек плагин получает только чтение: поиск и просмотр товаров, справочников (склады, организации, поставщики, типы цен и другие), документов и калькуляций.
| Галочка | Что открывает |
|---|---|
| Изменение и создание товаров и черновики складских документов (запись) | Создание и правка товаров и групп товаров. Черновики документов: поступление товаров, оприходование, списание, перемещение, возврат от покупателя, возврат поставщику, инвентаризация |
| Аналитические отчёты | Только чтение: продажи, остатки на складе, остатки по кассам и счетам |
| Просмотр настроек приложения | Оформление, чек, смена, доставка, регион |
Черновик не меняет остатки на складе. Его проводят в кабинете Paloma365: вместе с черновиком ChatGPT получает ссылку на этот документ в кабинете.
Любое изменение идёт в два шага: сначала ассистент готовит изменение, затем выполняет его отдельным шагом. Подготовленное изменение действует около 5 минут — потом его нужно подготовить заново.
Чего плагин не делает
- не проводит документы;
- не создаёт кассовые и банковские документы;
- не настраивает аккаунт: торговые точки, рабочие места, сотрудников;
- не меняет настройки.
Этих галочек на экране подтверждения плагина нет. Для таких действий используйте кабинет.
Как отключить ChatGPT
Подключение появляется в таблице Активные токены с подписью «OAuth: …» и названием, которое указал ChatGPT. Нажмите Отозвать — плагин сразу перестанет работать. Чтобы пользоваться им снова, подключите его в ChatGPT заново.
Управление токенами
В таблице Активные токены видно название, разрешения, дату создания, последнее использование, срок и статус каждого токена. Любой токен можно Отозвать — подключение сразу перестанет работать. Кнопка Отключить все отзывает сразу все токены.
Владелец видит в таблице подключения всех сотрудников аккаунта — колонка Кто подключил — и может отозвать любое из них. Сотрудник-администратор видит и отзывает только свои подключения.
Колонка Разрешения показывает, что именно было отмечено при подключении: «Чтение», «Создание и правка» (у плагина ChatGPT — «Товары и черновики склада»), «Проведение документов», «Настройка аккаунта», «Отчёты», «Просмотр настроек», «Правка настроек». Разрешения выдаются один раз, в момент подключения, и потом не меняются. Если нужного разрешения в списке нет — ассистент этого просто не умеет в этом подключении: отзовите токен и подключите заново, отметив нужное согласие.
Советы
- Относитесь к токену как к паролю: не публикуйте его и не храните в общих репозиториях.
- Если токен скомпрометирован — отзовите его и создайте новый.
- Токен действует с правами того, кто подключил, — владельца или сотрудника-администратора — в пределах отмеченных разрешений, поэтому подключайте только доверенные приложения.
FAQ
Q: Можно ли подключить ChatGPT?
A: Да, как плагин — по адресу из блока ChatGPT на этой странице (для dashboard.paloma365.com — https://mcp.paloma365.com/mcp/plugin). Если блока ChatGPT на странице нет, плагин для вашего кабинета пока недоступен. Токен с этой страницы не нужен: ChatGPT сам откроет окно входа Paloma365 и экран подтверждения, где вы отмечаете разрешения. Плагин умеет меньше, чем полный коннектор: читает товары, справочники, документы и отчёты, правит и создаёт товары и создаёт черновики складских документов. Проводить документы, создавать кассовые и банковские документы, настраивать аккаунт и менять настройки он не может. Подробнее — в разделе Подключение ChatGPT.
Подключения, сделанные раньше по основному адресу MCP-сервера, продолжают работать.
Q: Может ли сотрудник подключить ИИ-ассистента?
A: Да, если у сотрудника интерфейс «Администратор (Управленческий режим)» — в кабинете такой сотрудник может всё то же, что владелец. Он подключает ассистента на этой странице или входит в окне подключения Claude или ChatGPT логином «сотрудник.аккаунт».
Сотрудник с интерфейсом «Менеджер» подключить ассистента не может: ассистент не учитывает ограничения прав менеджера и получил бы больше, чем менеджер может в кабинете.
Доступ проверяется при каждом обращении ассистента. Если сотруднику сменили интерфейс или пароль, его уволили или удалили, его подключения сразу перестают работать.
Подключения, которые сотрудники сделали раньше, не работают — подключите ассистента заново. Всё, что они делали, владелец видит в журнале MCP.
Q: Можно ли подключить claude.ai (веб)?
A: Да — он подключается как коннектор по OAuth к основному адресу MCP-сервера: при подключении открывается экран подтверждения, где вы отмечаете, что разрешаете. Токен с этой страницы ему не нужен, он для Claude Code и Claude Desktop. Выданные такому подключению разрешения потом видны в колонке Разрешения.
Q: ChatGPT создал документ, а остатки не изменились
A: Плагин ChatGPT создаёт только черновики — они не меняют остатки и себестоимость. Откройте документ по ссылке из ответа ChatGPT или в списке документов кабинета, проверьте и проведите его.
Q: Может ли ассистент менять товары или цены?
A: Только если вы отметили это при подключении — галочкой «Создание и правка» на этой странице или на экране подтверждения при подключении по OAuth. Без неё ассистент ничего не создаст и не изменит, а без «Проведение документов» — не проведёт документ. Что именно выдано, видно в колонке Разрешения.
Q: Ассистент пишет, что инструмент недоступен, хотя раньше работал
A: Две частые причины, и обе видны на этой странице. Первая — у подключения нет нужного разрешения: посмотрите колонку Разрешения и, если нужного нет, переподключите коннектор, отметив согласие. Вторая — ассистент работает со старым списком навыков: начните новый чат (в старом список навыков зафиксирован с момента его создания). Что именно ассистент вызывал и чем это закончилось, видно на странице Журнал MCP.
Q: Что будет после истечения срока токена?
A: Подключение перестанет работать. Создайте новый токен на этой же странице.
Q: «Токен показывается один раз. Скопируйте его сейчас — позже его нельзя будет посмотреть» — а если я его не скопировал?
A: Создайте новый токен на этой же странице. Значение показывается только в момент создания подключения — страница к нему больше не возвращается, и в таблице Активные токены видно название, даты и статус, но не сам токен.
Потери здесь нет. Нажмите Создать подключение, скопируйте новый токен сразу и подставьте его в команду или в claude_desktop_config.json вместо старого. Старую запись после этого лучше Отозвать, чтобы не копить неиспользуемые подключения.