# HubSpot: MCP-сервер и CLI для CRM (/ru/docs/hubspot)

Знайте, где стоит каждая сделка и что поменялось в CRM за ночь, не открывая HubSpot. `hubspot` дает ИИ-агенту,
которым вы уже пользуетесь, например Claude Code или Codex, копию ваших сделок, контактов и компаний HubSpot на вашем
компьютере, и агент отвечает по этой копии, даже без интернета. Сделки он тоже создает, двигает и закрывает, в тех
пределах, которые вы разрешите.

Спросите, какие сделки ждут на стадии «Contract sent» и на какую сумму, что сдвинулось со вчера или сколько сделок
воронки Sales перешло на следующую стадию в этом месяце. Агент ответит сделкой, ее суммой и ответственным. Нужен один
ключ для аккаунта, который суперадминистратор один раз создает в настройках HubSpot.

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

1. [Что вы получаете](#what-you-get)
2. [О чем новичок не догадается](#things-a-newcomer-would-not-guess)
3. [Как это выглядит](#how-it-looks)
4. [Почему hubspot](#why-hubspot)
5. [Что он умеет](#what-it-can-do)
6. [Как это работает](#how-it-works)
7. [Начните за несколько минут](#start-in-a-few-minutes)
8. [Ограничения](#limits)
9. [Найдите руководство под свою задачу](#find-a-guide-for-your-task)

## Что вы получаете [#что-вы-получаете]

- **Ответ вместо поиска.** Спросите о сделке или клиенте своими словами. Агент найдет сделку с ее стадией, суммой и
  людьми, прочитает все с вашего компьютера, и вам не придется щелкать по HubSpot.
- **Воронка одним взглядом.** Сколько сделок стоит на каждой стадии и на какую сумму, сколько перешло дальше и какая
  доля выиграна.
- **Утро начинается с того, что изменилось.** Вчерашние новые сделки, переходы между стадиями, выигрыши и проигрыши
  приходят короткой сводкой в выбранное вами время: уведомлением на рабочем столе или в Telegram и почту через `tg`
  или `mail` от WireCat.
- **Вся работа по сделке в одном месте.** Ее заметки, звонки, письма, встречи и задачи, и задачи, которые просрочены.
- **Изменения по просьбе.** Достаточно написать «Перенеси Example kitchen в Contract sent». Агент найдет стадию по
  названию, а вы можете заранее проверить, какие разрешения нужны для изменения.
- **CRM рядом с вашими чатами.** Один поиск находит сделку рядом с сообщениями, письмами и встречами о ней, которые
  другие инструменты WireCat хранят на вашем компьютере.

## О чем новичок не догадается [#о-чем-новичок-не-догадается]

- **Ключ принадлежит аккаунту, а не вам.** Сервисный ключ HubSpot, с которым входит `hubspot`, не называет
  пользователя. Поэтому `hubspot` копирует сделки всего аккаунта, а `owner:me` никого не находит: агент фильтрует по
  id ответственного из `hubspot work users list`.
- **Создайте сервисный ключ, а не приватное приложение.** HubSpot перестал создавать новые приватные приложения
  26 октября 2026 года. Токен приватного приложения, которое у вас уже есть, по-прежнему работает. Где нажимать,
  показывает [установка](/llms.mdx/docs/ru/hubspot/installation/content.md#make-a-key).
- **Что можно менять, решают scope ключа.** Без scope на запись ключ только читает, что бы ни говорили настройки
  `hubspot`. Scope, который вы не выбрали, ломает только команды, которым он нужен, и ошибка его называет.
- **`work` это имя, которое вы выбираете сами.** Оно называет один аккаунт HubSpot и стоит первым словом каждой
  команды. Ни одна команда не выбирает аккаунт за вас.
- **Через MCP «ask» выполняется.** MCP это способ, которым приложения вроде Claude Desktop вызывают инструмент, и там
  никто не сидит у терминала, чтобы ответить на вопрос. Поставьте записи, которые агенту делать нельзя, на «только
  чтение» или запрет до того, как подключите его.
- **Все приложения аккаунта делят один дневной лимит вызовов API.** `hubspot` отвечает на большинство вопросов по
  своей копии и работает в спокойном темпе, поэтому тратит его мало. Когда лимит исчерпан, ошибка говорит, когда он
  вернется.

## Как это выглядит [#как-это-выглядит]

```text
You:    What changed in the CRM since yesterday?
Agent:  (runs hubspot work changes list "at>=1d")
        · New deal "Example kitchen", 15 000 EUR, in Appointment scheduled
        · "Example office" moved to Closed won, 8 200 EUR
You:    Move Example kitchen to Contract sent.
Agent:  (runs hubspot work deals move deal:12 "Contract sent")
        Done. "Example kitchen" (deal 12) is in Contract sent now.
```

## Почему hubspot [#почему-hubspot]

- **Копия ваших сделок на вашем компьютере.** Из пяти инструментов в [сравнении](/llms.mdx/docs/ru/hubspot/compare/content.md), включая собственный
  MCP-сервер HubSpot, ни у одного другого не описано чтение сделок без интернета. Следующая синхронизация берет только
  изменения.
- **Разрешение на каждое действие.** Разрешить, спросить, только чтение или запрет, для каждой команды и для каждой
  операции API HubSpot. Передать запись другому ответственному нельзя, пока вы это не разрешите.
- **Записи можно проверить заранее.** `--dry-run` ничего не отправляет и показывает, какие разрешения нужны записи.
  Запись, которая потеряла ответ, сама не отправляется снова, поэтому оборванное соединение не создаст вторую сделку.
- **Бережно к HubSpot.** Не больше 4 запросов в секунду на аккаунт, а большинству ответов запрос вообще не нужен.
- **Ключ остается в связке ключей системы.** Его не видно ни в выводе, ни в ошибках, ни в журналах.
- **Бесплатно и с открытым кодом.** Apache 2.0.

Другой инструмент подойдет лучше, если вам нужен HubSpot в ChatGPT или Claude в браузере, без программ на вашем
компьютере, со входом под вашим именем и с вашими правами в HubSpot (собственный MCP-сервер HubSpot).

## Что он умеет [#что-он-умеет]

- **Сделки и лиды:** списки по стадии, воронке, ответственному или дате, одна сделка с ее людьми, создание,
  изменение, перенос, закрытие с выигрышем или проигрышем, выгрузка списка в CSV для таблицы. Для лидов нужен Sales
  Hub Professional или Enterprise. [Как пользоваться](/llms.mdx/docs/ru/hubspot/usage/content.md)
- **Воронка:** каждая стадия с числом сделок и суммой, сколько сделок до нее дошло и пошло дальше, и доля выигранных
  за выбранный период. [Как пользоваться](/llms.mdx/docs/ru/hubspot/usage/content.md#read-your-deals)
- **Контакты, компании и ответственные:** найти любого из них в аккаунте, создать и изменить контакты и компании.
  [Как пользоваться](/llms.mdx/docs/ru/hubspot/usage/content.md#read-your-deals)
- **Что изменилось:** созданные, перенесенные, выигранные и проигранные сделки, смена ответственного, добавленные и
  выполненные активности в выбранном окне времени, и сводка по расписанию.
  [Как пользоваться](/llms.mdx/docs/ru/hubspot/usage/content.md#activities-and-what-changed)
- **Активности:** заметки, звонки, письма, встречи и задачи по вашим сделкам, когда вы их включите.
  [Как пользоваться](/llms.mdx/docs/ru/hubspot/usage/content.md#activities-and-what-changed)
- **Любая операция CRM API HubSpot:** заметки, задачи, тикеты, связи и слияния, у каждой свое разрешение.
  [Как пользоваться](/llms.mdx/docs/ru/hubspot/usage/content.md#call-the-api)

## Как это работает [#как-это-работает]

- **Копия на вашем компьютере.** `sync` кладет воронки, сделки и лиды с их контактами и компаниями в локальное
  хранилище WireCat, один файл на вашем компьютере, общий для всех инструментов WireCat. Списки, воронка и поиск
  читают его, в том числе без интернета.
- **Вход по ключу.** Сервисный ключ или токен приватного приложения. Он хранится в связке ключей системы, а на
  компьютере без нее в закрытом файле. [Установка](/llms.mdx/docs/ru/hubspot/installation/content.md)
- **Сделан для агентов и скриптов.** Навык учит команды Claude Code, Codex и Gemini CLI, а MCP отдает их приложениям
  вроде Claude Desktop. `--json` дает ответ в JSON, а ошибка приходит с кодом, по которому можно ветвиться.
  [MCP](/llms.mdx/docs/ru/hubspot/mcp/content.md)
- **Что хранится и что уходит в сеть.** [Безопасность](/llms.mdx/docs/ru/hubspot/security/content.md)

## Начните за несколько минут [#начните-за-несколько-минут]

Вставьте это своему агенту:

```text prompt
Установи hubspot командой npm install -g @wirecat/hubspot-cli. Помоги мне создать сервисный ключ HubSpot и запустить hubspot work session start, затем синхронизируй и покажи мои открытые сделки.
```

Или в терминале:

```sh
npm install -g @wirecat/hubspot-cli
hubspot skill install                 # teaches Claude Code, Codex and Gemini CLI to use hubspot
hubspot work session start            # paste the service key when asked
hubspot work sync                     # copy your deals with their contacts and companies
hubspot work deals list status:open   # your open deals, read from the copy
```

Нужен Node.js 22.16 или более поздний 22.x, либо Node.js 24 или новее. [Установка](/llms.mdx/docs/ru/hubspot/installation/content.md)

## Ограничения [#ограничения]

- Контакты, компании и ответственные каждый раз читаются из HubSpot, поэтому им нужен интернет. В копии есть контакты
  и компании ваших сделок.
- Для лидов нужен Sales Hub Professional или Enterprise.
- Тикеты, заметки и задачи записываются через `api`, а тикеты не копируются.
- HubSpot не помечает повторную запись как повтор. Запись, ответ на которую потерялся, могла пройти, поэтому
  проверьте запись в HubSpot, прежде чем отправить ее снова.

## Найдите руководство под свою задачу [#найдите-руководство-под-свою-задачу]

| Задача | Руководство |
|---|---|
| Установить и подключить аккаунт | [Установка](/llms.mdx/docs/ru/hubspot/installation/content.md) |
| Читать и менять сделки, сводка, API | [Как пользоваться](/llms.mdx/docs/ru/hubspot/usage/content.md) |
| Подключить приложение с MCP | [MCP](/llms.mdx/docs/ru/hubspot/mcp/content.md) |
| Решить, что агенту можно менять | [Разрешения](/llms.mdx/docs/ru/hubspot/permissions/content.md) |
| Точная команда или параметр | [Команды](/llms.mdx/docs/ru/hubspot/commands/content.md) |
| Что-то не работает | [Если что-то пошло не так](/llms.mdx/docs/ru/hubspot/troubleshooting/content.md) |
| Чем hubspot отличается от других инструментов для HubSpot | [Сравнение](/llms.mdx/docs/ru/hubspot/compare/content.md) |
