Как подключить HubSpot к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → HubSpot, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

HubSpot + Gemini

Дайте ИИ работать в HubSpot CRM: искать и обновлять контакты, компании, сделки и тикеты, видеть, кто с чем связан, проверять воронки и ответственных, добавлять заметки и задачи. Один аккаунт, через сервисный ключ, который вы создаёте сами.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

HUBSPOT_ACCESS_TOKEN

Шаг 1 — Получите учётные данные

1. В HubSpot откройте Development на левой боковой панели, затем Keys → Service keys и нажмите Create service key. Для этого нужны права суперадминистратора или доступ к инструментам разработчика (Developer tools).
2. Задайте имя ключа (например, «AnythingMCP»), нажмите Add new scope, отметьте перечисленные ниже scopes, затем нажмите Update и Create.
3. Откройте ключ, нажмите Show, затем Copy. Сервисные ключи начинаются с pat- (например, pat-eu1-...).
4. Вставьте ключ в HUBSPOT_ACCESS_TOKEN без слова Bearer, затем установите коннектор.
5. Начните с hubspot_get_account: инструмент показывает, к какому аккаунту HubSpot (Hub ID) относится ключ, а также часовой пояс и валюту этого аккаунта.

Устаревшие частные приложения: в старых аккаунтах может ещё оставаться частное приложение (Development → Legacy apps, раньше Settings → Integrations → Private Apps). Его токен доступа работает так же: вставьте его в HUBSPOT_ACCESS_TOKEN.

Разрешения (scopes):

• Чтение: crm.objects.contacts.read (охватывает также заметки и задачи), crm.objects.companies.read, crm.objects.deals.read, crm.objects.tickets.read, crm.objects.owners.read.
• Запись: crm.objects.contacts.write (нужен также для заметок и задач), crm.objects.companies.write, crm.objects.deals.write, crm.objects.tickets.write.

Только чтение: дайте ключу только scopes для чтения и отключите hubspot_create_object, hubspot_update_object, hubspot_associate_records, hubspot_create_note и hubspot_create_task.

Выключены при установке: hubspot_archive_object. Включайте его, только если ИИ должен удалять записи. Архивированные записи попадают в корзину HubSpot, и в течение 90 дней их можно оттуда восстановить.

Настройки конфиденциальности данных: если в вашем аккаунте HubSpot включена защита персональных данных (GDPR), HubSpot требует для каждого нового контакта правовое основание обработки, то есть свойство hs_legal_basis. Сообщите ИИ, какое правовое основание указывать при создании контактов; без него HubSpot отвечает «The following required properties were missing».

Лимиты: HubSpot допускает 100 запросов за 10 секунд на один ключ в тарифах Free и Starter (в Professional и Enterprise больше), 250 000 запросов в день на аккаунт и 5 поисковых запросов в секунду. При превышении лимита HubSpot отвечает 429: подождите несколько секунд и повторите попытку.

Частые ошибки: 401 означает, что ключ неверный, истёк или был заменён новым: скопируйте его заново. В ответе 403 указан недостающий scope: добавьте его к ключу через Edit. 404 означает неверный идентификатор или тип объекта. 400 VALIDATION_ERROR указывает, какое свойство или фильтр задан неверно, например неизвестное имя свойства или значение раскрывающегося списка, которого нет среди его вариантов.

Коннектор не работает с маркетинговыми рассылками, формами, списками, рабочими процессами (workflows), файлами, коммерческими предложениями и ценами позиций, не объединяет записи и не выполняет пакетную запись.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты HubSpot.

Доступные инструменты

Примеры запросов

• «Какие сделки в воронке продаж должны закрыться в этом месяце и кто за них отвечает?»
• «Найди контакт [email protected] и покажи её компанию и открытые сделки.»
• «Переведи сделку Acme Corp на следующий этап и добавь заметку с кратким итогом сегодняшнего звонка.»
• «Создай для меня задачу на повторный контакт по сделке Globex со сроком до следующей пятницы.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse