HubSpot MCP

HubSpot MCP

Реализация протокола контекста модели (MCP) для API HubSpot , предоставляющая стандартизированный интерфейс для доступа и управления данными CRM.

Функции

• Полный охват API HubSpot CRM
• Поддержка всех стандартных объектов CRM (компании, контакты, сделки и т. д.)
• Расширенное управление ассоциациями с помощью CRM Associations v4
• Конечные точки компании с проверкой свойств
• Пакетные операции для эффективного управления данными
• Расширенные возможности поиска и фильтрации
• Проверка параметров безопасности типов с помощью Zod

Предпосылки

Если у вас нет ключа API, следуйте инструкциям здесь, чтобы получить токен доступа. Поддержка OAuth запланирована как будущее улучшение.

Конфигурация клиента

Существует несколько вариантов настройки клиента MCP с сервером. Для настройки сервера на хосте/удалённом сервере используйте CLI Smithery с ключом API Smithery . Для локальной установки используйте npx или сборку из исходного кода. Каждый из этих вариантов поясняется ниже.

Удаленный сервер Smithery (рекомендуется)

Чтобы добавить удаленный сервер в config.json вашего клиента MCP, выполните следующую команду из Smithery CLI :

При появлении соответствующего запроса введите HUBSPOT_ACCESS_TOKEN .

Кузнечное дело SDK

Если вы разрабатываете собственное приложение-агент, вы можете использовать шаблонный код здесь .

Локальная установка NPX

Чтобы установить сервер локально с помощью npx , добавьте следующее в config.json вашего клиента MCP:

Сборка из исходного кода

1. Загрузить репозиторий:

2. Установить пакеты (внутри клонированного репозитория):

3. Добавьте следующее в config.json вашего клиента MCP:

Переменные конфигурации

Поддерживаемые инструменты

Основные объекты CRM

Базовые операции с объектами

• crm_list_objects : список объектов CRM с дополнительной фильтрацией и разбиением на страницы
• crm_get_object : Получить один объект CRM по идентификатору
• crm_create_object : Создать новый объект CRM
• crm_update_object : обновить существующий объект CRM
• crm_delete_object : Удалить объект CRM

Поиск и пакетные операции

• crm_search_objects : Поиск объектов CRM с использованием расширенных фильтров
• crm_batch_create_objects : Создание нескольких объектов в одном запросе
• crm_batch_update_objects : Обновление нескольких объектов за один запрос
• crm_batch_delete_objects : Удаление нескольких объектов за один запрос

Управление записями CRM

Компании

• Основные операции:
  • crm_create_company : Создать новую компанию с проверенными свойствами
  • crm_update_company : Обновить существующую компанию
  • crm_get_company : Получить одну компанию по идентификатору
  • crm_search_companies : Поиск компаний с определенными фильтрами
• Пакетные операции:
  • crm_batch_create_companies : Создание нескольких компаний в одном запросе
  • crm_batch_update_companies : Обновление нескольких компаний за один запрос
• Управление недвижимостью:
  • crm_get_company_properties : Получить все доступные свойства компании
  • crm_create_company_property : Создать новую собственность компании

Контакты

• Основные операции:
  • crm_create_contact : Создать новый контакт с проверенными свойствами
  • crm_update_contact : Обновить информацию о существующем контакте
  • crm_get_contact : Получить один контакт по идентификатору
  • crm_search_contacts : Поиск контактов с использованием определенных фильтров
• Пакетные операции:
  • crm_batch_create_contacts : Создание нескольких контактов в одном запросе
  • crm_batch_update_contacts : Обновление нескольких контактов за один запрос
• Управление недвижимостью:
  • crm_get_contact_properties : Получить все доступные свойства контакта
  • crm_create_contact_property : Создать новое свойство контакта

Лиды

• Основные операции:
  • crm_create_lead : создать новый лид с проверенными свойствами
  • crm_update_lead : обновить информацию о существующем лиде
  • crm_get_lead : Получить один лид по идентификатору
  • crm_search_leads : Поиск лидов с использованием определенных фильтров
• Пакетные операции:
  • crm_batch_create_leads : Создание нескольких лидов в одном запросе
  • crm_batch_update_leads : обновление нескольких лидов в одном запросе
• Управление недвижимостью:
  • crm_get_lead_properties : Получить все доступные свойства лида
  • crm_create_lead_property : создать новое свойство лида

Управление взаимодействием

Подробности помолвки

• Основные операции:
  • engagement_details_get : Получить сведения о конкретном взаимодействии
  • engagement_details_create : Создать новое взаимодействие
  • engagement_details_update : Обновить существующую вовлеченность
  • engagement_details_delete : Удалить участие
  • engagement_details_list : Список всех взаимодействий с фильтрацией
  • engagement_details_get_associated : Получить связанные вовлеченности

Звонки

• Основные операции:
  • calls_create : Создать новую запись вызова
  • calls_get : Получить детализацию звонка
  • calls_update : Обновить запись вызова
  • calls_archive : Архивировать вызов
  • calls_list : Список всех звонков
  • calls_search : Поиск звонков
• Пакетные операции:
  • calls_batch_create : Создать несколько вызовов
  • calls_batch_read : Чтение нескольких вызовов
  • calls_batch_update : обновление нескольких вызовов
  • calls_batch_archive : Архивировать несколько вызовов

Электронные письма

• Основные операции:
  • emails_create : Создать новую запись электронной почты
  • emails_get : Получить данные электронной почты
  • emails_update : Обновить электронную почту
  • emails_archive : Архивировать электронное письмо
  • emails_list : Список всех адресов электронной почты
  • emails_search : Поиск писем
• Пакетные операции:
  • emails_batch_create : Создать несколько писем
  • emails_batch_read : Чтение нескольких писем
  • emails_batch_update : Обновление нескольких писем
  • emails_batch_archive : Архивировать несколько писем

Встречи

• Основные операции:
  • meetings_create : Создать новую встречу
  • meetings_get : Получить сведения о встрече
  • meetings_update : Обновить встречу
  • meetings_delete : Удалить встречу
  • meetings_list : Список всех встреч
  • meetings_search : Поиск встреч
• Пакетные операции:
  • meetings_batch_create : Создать несколько встреч
  • meetings_batch_update : обновление нескольких встреч
  • meetings_batch_archive : Архивировать несколько встреч

Примечания

• Основные операции:
  • notes_create : Создать новую заметку
  • notes_get : Получить сведения о заметке
  • notes_update : Обновить заметку
  • notes_archive : Архивировать заметку
  • notes_list : Список всех заметок
  • notes_search : Поиск заметок
• Пакетные операции:
  • notes_batch_create : Создать несколько заметок
  • notes_batch_read : Чтение нескольких заметок
  • notes_batch_update : Обновить несколько заметок
  • notes_batch_archive : Архивировать несколько заметок

Задачи

• Основные операции:
  • tasks_create : Создать новую задачу
  • tasks_get : Получить сведения о задаче
  • tasks_update : Обновить задачу
  • tasks_archive : Архивировать задачу
  • tasks_list : Список всех задач
  • tasks_search : Поиск задач
• Пакетные операции:
  • tasks_batch_create : Создать несколько задач
  • tasks_batch_read : Чтение нескольких задач
  • tasks_batch_update : Обновление нескольких задач
  • tasks_batch_archive : Архивировать несколько задач

Ассоциации и отношения

Ассоциации CRM v4

• Основные операции:
  • crm_list_association_types : Список доступных типов ассоциаций
  • crm_get_associations : Получить все ассоциации между объектами
  • crm_create_association : Создать ассоциацию
  • crm_delete_association : Удалить ассоциацию
• Пакетные операции:
  • crm_batch_create_associations : Создание нескольких ассоциаций
  • crm_batch_delete_associations : Удалить несколько ассоциаций

Настройки связи

Управление подпиской

• Основные операции:
  • communications_get_preferences : Получить настройки контакта
  • communications_update_preferences : Обновить настройки контактов
  • communications_unsubscribe_contact : Глобальная отписка
  • communications_subscribe_contact : Глобальная подписка
  • communications_get_subscription_definitions : Получить определения подписки
• Массовые операции:
  • communications_get_subscription_status : Получить статус для нескольких контактов
  • communications_update_subscription_status : обновление статуса для нескольких контактов

Продукция

Основные операции:

• products_create : Создать продукт с заданными свойствами и вернуть копию объекта, включая идентификатор.
• products_read : Чтение объекта, идентифицированного по идентификатору
• products_update : Выполнить частичное обновление объекта, идентифицированного по ID. Свойства только для чтения и несуществующие свойства приведут к ошибке. Значения свойств можно очистить, передав пустую строку.
• products_archive : Переместить объект, идентифицированный по идентификатору, в корзину для переработки.
• products_list : Прочитать страницу продуктов. Управляйте тем, что возвращается, с помощью параметра запроса properties . after — это токен курсора постраничного просмотра последнего успешно прочитанного ресурса, который будет возвращен как свойство JSON paging.next.after постраничного ответа, содержащего больше результатов.
• products_search : Поиск продуктов

Пакетные операции:

• products_batch_create : Создать партию продуктов
• products_batch_read : Чтение партии продуктов по внутреннему идентификатору или уникальным значениям свойств. Извлечение записей по параметру idProperty для извлечения записей по пользовательскому уникальному свойству значения.
• products_batch_update : обновление партии продуктов по внутреннему идентификатору или уникальным значениям, указанным в параметре запроса idProperty .
• products_batch_archive : Архивировать партию продуктов по идентификатору

Внося вклад

Вклады приветствуются и поощряются! Пожалуйста, прочтите CONTRIBUTING.md для получения инструкций по вопросам, вкладам и контактной информации.