CRMHubSpot

Права ИИ-агента в CLI HubSpot

Выберите, что агент может менять в HubSpot, и какие проверки действуют при любых настройках.

Пусть ИИ-агент работает в вашей CRM HubSpot через hubspot, а решение о том, что он меняет, остается за вами. Ключ несет scope, которые вы дали ему в HubSpot, на весь аккаунт, поэтому без ваших собственных ограничений агент мог бы изменить любую сделку, контакт или компанию, до которых дотягиваются эти scope.

Для каждого профиля, то есть имени, которое вы дали входу в один аккаунт, вы решаете, что агент может только читать, что сначала спрашивает вас и что выполняется сразу. Вы можете запретить агенту удалять сделки или обращаться к API HubSpot напрямую и знаете, какие проверки действуют, что бы ни говорили настройки.

У каждой команды есть ключ разрешения, ее имя, например deals.move, или группа, например deals, и более длинный ключ побеждает. У каждой операции API HubSpot ключ тоже есть, api. и ее команда, например api.deals-search, а api покрывает их все. У каждого ключа есть уровень: deny, readonly, ask или allow. Уровни задаются через hubspot work config set, а --dry-run показывает, какие ключи проверяет команда.

На этой странице:

  1. Уровни
  2. Что задано до того, как вы что-то поменяете
  3. Одна команда может проверять несколько ключей
  4. Агенты и MCP
  5. Проверки, которые действуют независимо от разрешений

Уровни

УровеньЧто происходит
denyКоманда отклоняется, чтение тоже.
readonlyЧтение работает. Запись отклоняется.
askЗапись сначала спрашивает в терминале. Через MCP она выполняется.
allowКоманда выполняется без вопроса.
hubspot work config set permissions.people deny        # this profile reads no contacts
hubspot work config set permissions.api readonly       # the API reads, never writes
hubspot work config set permissions.notes.write allow  # let an agent add notes without a question
hubspot work config show                               # each key with its level and where it came from

Отказ это permission_error (код выхода 5), и он называет ключ. Он не значит, что вход сломан.

Агент не может ослабить разрешение: config set или config unset, который снял бы ограничение, отклоняется, если вы не выполните его сами в терминале.

Что задано до того, как вы что-то поменяете

ЧтоКлючиВстроенный уровень
deals create, update, move и close, people и organizations create и updateсвой, например deals.update. Смена стадии проверяет еще deals.move, а стадия выигрыша или проигрыша deals.closeallow
deals deletedeals.deleteask
Запись через api в сделки, контакты или компании, например api deals-updateapi.deals-update и ключ команды, которая делает то же самое (deals.update), как в amoCRM и b24. Запись, для которой команды нет, например слияние, проверяет <group>.update. Стадия сделки проверяет еще deals.move и deals.closeask
Другая запись через api, например api notes-createapi.notes-create и ключ .write своей группы (notes.write)ask
Чтение через api, например api contacts-listapi.contacts-list и ключ команды, которая читает те же записи (people.list), поэтому people: deny останавливает и егоallow
Удаление, архивирование или слияние через apiсвой ключ api. и ключ .delete своей группыask
Назначение ответственного у записи, любым путемcrm.assign-othersdeny
api contacts-gdpr-delete, который стирает контакт навсегдаеще people.erase, чтобы можно было запретить только егоask
Любая другая командасвойallow

Ключ HubSpot принадлежит аккаунту, а не человеку. hubspot не может отличить ваши записи от записей коллеги, поэтому любой ответственный считается кем-то другим, и crm.assign-others остается на deny, пока вы его не разрешите.

Одна команда может проверять несколько ключей

Одно и то же изменение может прийти двумя путями: командой вроде deals update или операцией API api deals-update. Каждый путь проверяет и ключи другого, поэтому одна настройка действует на обоих:

hubspot work config set permissions.deals.update deny   # no deal updates, by deals update or api deals-update

--dry-run показывает каждый ключ, который проверяет запись, и ничего не отправляет:

hubspot work deals move deal:12 "Contract sent" --dry-run
hubspot work api notes-create --body-file note.json --dry-run

Агенты и MCP

Через MCP отвечать на вопрос некому, поэтому ask пропускает команду. Чтобы остановить агента, поставьте ключ на readonly или deny:

hubspot work config set permissions.deals.delete deny
hubspot work config set permissions.api readonly

hubspot work mcp serve --permission people.list=deny делает ключ строже только для одного сервера и никогда не ослабляет его. Остальное показывает MCP.

Проверки, которые действуют независимо от разрешений

  • Scope ключа. Ключ без scope на запись ничего не может изменить в HubSpot, какой бы уровень вы ни поставили (установка).
  • Только чтение для всего. WCHUBSPOT_READ_ONLY=1 отклоняет каждую запись, что бы ни говорили разрешения.
  • Запись отправляется один раз. Запись, которая не получила ответа, снова не отправляется. Она заканчивается outcome_unknown, и вы проверяете запись в HubSpot, прежде чем отправить ее снова.
  • Вход остается за вами. session start и session end через MCP не предлагаются, а ключ читается скрытно или из stdin, но никогда не как аргумент.