CRMHubSpot

Установка CLI и MCP-сервера HubSpot

Установите CLI для HubSpot из npm, создайте сервисный ключ с нужными правами и войдите с ним.

Установите hubspot один раз на каждый компьютер, где им пользуетесь вы или агент. Нужен Node.js 22.16 или более поздний 22.x, либо 24 или новее. Node 23 не поддерживается.

npm install -g @wirecat/hubspot-cli
hubspot --version
hubspot doctor

doctor не нужна сеть, и он не открывает связку ключей. Он показывает версию, где лежат настройки, какие профили есть и могут ли другие пользователи компьютера читать настройки.

Создайте ключ

hubspot входит с ключом, который принадлежит одному аккаунту HubSpot. Создает его один раз суперадминистратор или пользователь с разрешением HubSpot Developer tools access (руководство HubSpot):

  1. Откройте Development, затем Keys → Service keys в левом меню. В некоторых аккаунтах это находится в Settings → Integrations → Service keys.
  2. Нажмите Create service key и назовите ключ WireCat.
  3. Нажмите Add new scope, отметьте каждый scope из таблицы и нажмите Update. Ключ получает только те scope, которые есть у его создателя.
  4. Нажмите Create и подтвердите.
  5. Нажмите на имя ключа, затем Show и Copy. Ключ начинается с pat-.

HubSpot перестал создавать новые приватные приложения 26 октября 2026 года (объявление HubSpot). Токен доступа существующего приватного приложения по-прежнему работает: дайте приложению те же scope и скопируйте токен на его вкладке Auth.

Дайте ключу эти scope на чтение (список scope HubSpot):

ScopeЧто он читает
crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.readконтакты, компании и сделки
crm.objects.owners.readответственных за сделки
crm.schemas.contacts.read, crm.schemas.companies.read, crm.schemas.deals.readсвойства каждого из них
sales-email-readзаписанные письма. Заметкам, звонкам, встречам и задачам свой scope не нужен: их читает scope контактов
crm.objects.leads.readлиды, только в Sales Hub Professional или Enterprise
ticketsтикеты, только через api

Запись необязательна. Добавьте эти scope, только если hubspot может менять записи. Без них ключ только читает:

ScopeЧто он меняет
crm.objects.deals.writeсделки: создание, изменение, перенос, закрытие и удаление
crm.objects.contacts.writeконтакты. Заметки, звонки, встречи и задачи, которые пишутся через api, могут потребовать свой scope: ошибка его назовет
crm.objects.companies.writeкомпании

Scope, который вы не выбрали, ломает только команды, которым он нужен, и ошибка называет этот scope.

Войдите

Выберите имя профиля для аккаунта, например work, и вставьте ключ, когда его попросят:

hubspot work session start

Ключ читается скрытно или из stdin (hubspot work session start < key.txt), но никогда не как аргумент. hubspot спрашивает HubSpot, какому аккаунту принадлежит ключ, и хранит ключ вместе с id аккаунта в связке ключей системы или, с --credential-storage file, в файле, который можете читать только вы. Второй профиль на тот же аккаунт отклоняется.

hubspot work setup задает те же вопросы по шагам. WireCat Desktop показывает те же шаги: он берет их из одного JSON-документа, который печатает CLI, hubspot work setup show --json, на английском, испанском или русском.

WCHUBSPOT_TOKEN в окружении заменяет сохраненный ключ для каждого профиля, как в CI. Рядом задайте WCHUBSPOT_ACCOUNT, id аккаунта: hubspot work session status --check с одним токеном печатает его как account. Каждая команда, которая обращается к HubSpot, сначала сверяет id с токеном. Команде, которая читает только локальную копию, нужно, чтобы одна такая команда, например sync, уже запускалась. api так не узнает часовой пояс аккаунта, поэтому при исчерпанном дневном лимите он предлагает повторить после времени в UTC, самого раннего, когда лимит может вернуться.

Дальше: как пользоваться.