HubSpot MCP: ответы по CRM и изменения под контролем человека

Удалённый MCP-сервер HubSpot позволяет совместимому AI-агенту отвечать на вопросы по CRM и, при наличии прав, создавать или обновлять записи для задач продаж и поддержки. В Claude можно использовать коннектор HubSpot, а для собственного клиента — настроить подключение через OAuth. Изменения стадий сделок, контактных данных и заметок о клиентах следует оставлять на подтверждение человеку; назначение сервера описано в документации HubSpot.

Сведения сверены с документацией по состоянию на 30 октября 2026 года. Другие подключения собраны в категории MCP-серверы для приложений; основы протокола объясняет введение в MCP.

Что агент может сделать

HubSpot описывает доступ к контактам, компаниям, сделкам, обращениям и истории действий, включая заметки и задачи. Доступные операции зависят от разрешений подключения. Поэтому полезно разделять получение контекста из CRM, подготовку предложения и сохранение изменений: для каждого этапа нужно своё решение. Возможности перечислены в обзоре MCP от HubSpot.

Для пилота задавайте конкретный аккаунт, ответственного и период:

• Разбор воронки: подготовить сводку доступных открытых сделок по стадиям, указать ID записей, суммы, даты закрытия и пробелы в данных. Отсутствие следующего шага должно стать вопросом владельцу сделки, а не выводом о её потере.
• Подготовка к встрече: собрать справку о выбранной компании из доступных записей и недавних действий. Отделить зафиксированные факты от предложенных тем разговора и указать источники утверждений.
• Передача обращения: обобщить назначенные мне открытые обращения и подготовить текст передачи коллеге. Перечислить нерешённые вопросы и ссылки на записи; до проверки оставить текст черновиком вне CRM.

Это примеры организации работы, а не гарантия полного ответа. Запросы для продаж и поддержки описаны в руководстве по коннектору Claude. Просите агента перечислять применённые фильтры, чтобы человек мог повторить выборку.

Какие изменения нужно проверять человеку

Оформляйте предложение так, чтобы владелец записи мог оценить его без перечитывания всей переписки:

Это рекомендуемый порядок работы. Уверенный ответ не даёт разрешения менять запись. Сначала запросите предложение, затем подтвердите его точное содержание и после выполнения снова прочитайте запись. Если за время согласования исходное значение изменилось, остановитесь и пересмотрите предложение.

При массовой корректировке проверяйте условия отбора не менее внимательно, чем новые значения. Даже верное изменение ошибочно, если применено к другому клиенту. Для общей проверки доступа пригодится чек-лист безопасности MCP.

Удалённый CRM-сервер или локальный Developer MCP?

Удалённый сервер нужен для подключения к CRM. Отдельный Developer MCP server HubSpot работает локально через CLI и предназначен для разработки приложений и CMS. В официальной инструкции используется hs mcp setup; среди поддерживаемых клиентов указаны VS Code и Claude Code. Актуальные требования смотрите в руководстве по установке Developer MCP.

Выбирайте инструмент по задаче: справка о клиенте требует доступа к CRM, разработка расширения HubSpot — инструментов разработчика. Установка локального сервера сама по себе не создаёт удалённое подключение к CRM. Разницу размещения объясняет сравнение локальных и удалённых MCP-серверов.

Как подключить безопасно

1. Начните с чтения. Определите аккаунт HubSpot, обычного пользователя с нужными правами и знакомую запись. Зафиксируйте разрешённый вопрос и необходимые поля. Не используйте аккаунт администратора только ради обхода ошибки доступа.
2. Для Claude выберите коннектор. В Settings откройте Connectors, найдите HubSpot через каталог и подключите нужный аккаунт. Соблюдайте порядок согласования приложений в организации. Требования к аккаунтам и платной подписке Claude приведены в инструкции HubSpot.
3. Для собственного клиента создайте подключение. В HubSpot откройте Development → MCP Connectors → Create MCP connector. Следуйте руководству по удалённому серверу. Укажите callback URL, который требуется вашему клиенту.
4. Настройте клиент и авторизацию. Адрес удалённого сервера — https://mcp.hubspot.com. В VS Code запустите MCP: Add Server, выберите HTTP и пройдите авторизацию выбранного клиента. Порядок добавления сервера описан в документации VS Code. HubSpot требует OAuth с PKCE; официальный пример авторизации показывает клиентские реквизиты и совпадение callback URL. Не отправляйте секреты в чат и не сохраняйте их в репозитории.
5. Проверьте предоставленный доступ. Вызовите get_user_details для проверки аккаунта и прав, как показано в примере авторизации. Scopes определяются доступными инструментами сервера и разрешениями при установке, а не задаются вручную при создании подключения. Это поясняет раздел о правах HubSpot.
6. Включите подтверждение записи. В настройках инструментов коннектора HubSpot в Claude установите для Write tools значение Needs Approval, как рекомендует HubSpot. В другом редакторе проверьте механизм согласования и оставьте инструменты изменения данных выключенными, пока порядок проверки не готов.
7. Проверьте весь путь. Прочитайте знакомую запись и сравните ответ с HubSpot. Затем подготовьте предложение об изменении без сохранения. После согласованного действия проверьте ответ инструмента и повторно прочитайте запись, прежде чем объявлять работу завершённой. Для редактора полезно руководство по MCP в VS Code.

Когда это не работает

Ошибка авторизации. Проверьте поддержку PKCE, callback URL и обновление токена, прежде чем расширять права CRM. Эти проверки описаны в примере авторизации HubSpot. Повторение рабочего запроса не исправит невалидное подключение.

Ожидаемые данные недоступны. Новые scopes могут требовать переустановки подключения. Если в аккаунте включён Sensitive Data, удалённый сервер блокирует доступ к действиям и переписке. Сверьтесь с актуальным описанием доступа, прежде чем считать пустую историю доказательством отсутствия событий.

Поиск выглядит неполным. Согласно документации CRM Search, изменения могут появляться в поиске с задержкой, а архивные записи исключаются. Проверьте фильтры и саму запись до предложения создать дубликат. Пустая выдача характеризует конкретный запрос, а не все отношения с клиентом.

Результат записи неясен. Примите правило: перед повтором действия сначала проверять целевую запись. Тайм-аут не должен превращать согласованную заметку в дублирующиеся заметки. Сохраните предложение и идентификаторы записей для выяснения результата владельцем.

Где здесь Tvijo

По состоянию на 30 октября 2026 года расширение DSHREM для VS Code служит входом в задачи с выбранным контекстом и проверяемым результатом. TvijoCode включает расширение в тестовую сборку редактора на базе Code - OSS; описанная Windows-сборка не подписана и обновляется вручную.

Tvijo MCP предоставляет MCP-клиенту возможность обращаться за консультацией к Tvijo. Проверка переданного diff подготовлена, но в датированном отчёте публикация ещё ожидается; интеграция с редактором и безопасное делегирование остаются запланированными. Эти компоненты не означают наличия готового коннектора HubSpot. Их роли объясняет технологическая карта.

Сценарий с HubSpot потребует отдельно согласованного и проверенного подключения: разрешённый CRM-контекст для продаж или поддержки, предложение результата и проверка человеком перед обновлением. Начните с обезличенной справки и явного критерия приёмки.

На странице предложений Tvijo по состоянию на 30 октября 2026 года Try стоит $0: до 5 задач, 50 000 токенов или $0.05 спонсируемого использования — до достижения любого из этих пределов; общий дневной пул $1 финансирует TVIJO. Service credit указан как $10 для запроса предоплаченного кредита; использование услуг провайдера тарифицируется по факту с сервисной наценкой 8%. Приём платежей не активирован, оформление заказа не является списанием. Это предложения Tvijo, отдельные от требований к подпискам HubSpot и клиента.

Частые вопросы

Нужен ли локальный сервер для работы с HubSpot в Claude?

Для CRM используйте коннектор HubSpot. Локальный Developer MCP предназначен для разработки приложений и CMS: выбирайте его для соответствующей задачи. Различие описано в документации HubSpot.

Стоит ли разрешать агенту самостоятельно менять стадию сделки?

Оставьте решение уполномоченному сотруднику. Требуйте точную запись, исходное и новое значения и основание перехода, а после сохранения проверяйте результат.

Что запросить до включения изменений?

Начните с ограниченной справки по знакомым записям без записи в CRM. Проверьте аккаунт, ссылки на записи, фильтры и пробелы в данных. Переходите к согласованному изменению только после такой проверки.

HubSpot — товарный знак правообладателя. Tvijo не связан с ним и не одобрен им.