HubSpot MCP Server

Что умеет сервер

HubSpot предлагает два разных MCP-сервера. Удалённый даёт ИИ-инструментам доступ к данным аккаунта: записям CRM (контакты, компании, сделки, тикеты, лиды и другие объекты), активностям (звонки, письма, встречи, заметки, задачи), контенту и маркетингу (блоги, лендинги, страницы сайта, кампании, письма и их аналитика), а также к данным разговоров и сведениям о пользователях.

На запись доступны создание и правка записей CRM и активностей, создание и публикация страниц и постов, кампании, черновики писем, воронки, пользовательские свойства и статические сегменты. Часть возможностей, например счета и предложения, помечена как бета и зависит от подписки.

Когда использовать

Удалённый сервер нужен, когда ассистент должен отвечать на вопросы по CRM («последние новости по компании Acme», сводка по сделкам на нужной стадии, последние тикеты клиента) или заполнять данные по описанию. Локальный сервер для разработчиков запускается через CLI HubSpot и помогает создавать проекты, расширения интерфейса и работать с документацией разработчика.

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

Ограничения и безопасность

Для удалённого сервера нужна платформа разработчиков HubSpot нового поколения и MCP-коннектор, созданный в аккаунте (Development, MCP Connectors). Клиент должен поддерживать OAuth с PKCE: без него вход не пройдёт. Все действия ограничены правами пользователя в HubSpot, а доступные области определяются инструментами сервера и теми правами, которые пользователь выдаст при установке.

Если в аккаунте включены чувствительные данные, активности и данные разговоров для MCP блокируются. Пользовательские свойства с особо чувствительными данными (например, медицинскими) сервер не отдаёт. Поиск работает поверх CRM Search API и не поддерживает векторный поиск.

Удалённый сервер

1. В аккаунте HubSpot откройте Development, затем MCP Connectors, нажмите Create MCP connector, введите имя и адрес перенаправления (Redirect URL) и создайте коннектор.
2. На странице коннектора возьмите идентификатор клиента и секрет.
3. Настройте MCP-клиент на адрес сервера и пройдите OAuth с PKCE:

https://mcp.hubspot.com

Для проверки подойдёт MCP Inspector: транспорт Streamable HTTP, адрес https://mcp.hubspot.com/ и данные коннектора. Если нужен адрес перенаправления для инспектора, добавьте в коннектор:

http://localhost:6274/oauth/callback/debug

После подключения выполните инструмент get_user_details: он покажет доступные объекты и инструменты.

Локальный сервер для разработчиков

Установите последнюю версию CLI HubSpot и выполните команду настройки, затем выберите поддерживаемые агентские инструменты:

hs mcp setup

Требуется Developer Platform v2025.2.