GoHighLevel MCP + Claude: настройка за 15 минут для агентств
Пошаговая настройка GoHighLevel MCP с Claude для агентств: подключение за 15 минут, 10 воркфлоу, мультиклиентская изоляция и безопасность данных. Старт здесь.
GoHighLevel MCP + Claude: настройка за 15 минут для агентств
Пятница, 17:30. Клиент просит отчёт по сделкам за месяц — прямо сейчас. Открываете GoHighLevel, фильтруете воронку, вручную считаете закрытые заявки, копируете цифры в таблицу, пишете письмо. Тридцать минут ушли. И это только один клиент.
Умножьте на пять аккаунтов, добавьте еженедельный аудит «зависших» лидов, ручную расстановку тегов и чистку контактов — выйдет несколько часов рутины каждую неделю. Работы, которая не требует ни стратегии, ни экспертизы. Только клики.
Официальный MCP-сервер GoHighLevel, запущенный в феврале 2026 года, меняет эту математику. Он подключает Claude напрямую к вашему CRM — и тогда лидами, воронкой и отчётами можно управлять через обычный текст, без Zapier, без кода, без технического background. В этом руководстве — точная последовательность настройки GoHighLevel MCP за 15 минут и десять воркфлоу, которые агентства запускают прямо сейчас.
Содержание
- Что такое GoHighLevel MCP и зачем это нужно агентству
- Claude + MCP против Zapier и нативных воркфлоу GHL
- Что нужно перед настройкой: PIT, Location ID и разрешения
- Пошаговая настройка: подключить Claude к GoHighLevel за 15 минут
- 10 воркфлоу для агентств, которые стоит запустить первыми
- Мультиклиентская настройка: несколько саб-аккаунтов без пересечения данных
- Официальный MCP-сервер против коммьюнити-серверов
- Устранение типичных ошибок GoHighLevel MCP
- Безопасность при работе с клиентскими данными
- Реальные результаты агентств: что меняется после подключения
- Часто задаваемые вопросы
Что такое GoHighLevel MCP и зачем это нужно агентству
MCP расшифровывается как Model Context Protocol — открытый стандарт от Anthropic, который даёт AI-моделям возможность подключаться к внешним сервисам и работать с реальными данными. Проще говоря: вместо того чтобы копировать данные из GoHighLevel в ChatGPT, Claude сам заходит в ваш аккаунт, берёт нужное и выполняет задачу.
Официальный MCP-сервер GoHighLevel расположен по адресу https://services.leadconnectorhq.com/mcp/ — запущен в феврале 2026-го. На старте включал 36 инструментов; дорожная карта предусматривает расширение до 250+ (официальная документация GoHighLevel, февраль 2026). Для подключения нужны только два параметра: Private Integration Token (PIT) и Location ID вашего саб-аккаунта.
GoHighLevel обслуживает более 1 миллиона компаний и обрабатывает свыше 1 миллиарда API-запросов ежедневно (taskvirtual.com, апрель 2026). Из 72 439 активных компаний на платформе около 19% работают в рекламе и маркетинге (technologychecker.io, апрель 2026). Крупнейшая концентрация агентств на одной платформе — поэтому MCP-интеграция здесь имеет такой потенциал.
Claude + MCP против Zapier и нативных воркфлоу GHL
Запутаться легко, потому что все три инструмента «автоматизируют GoHighLevel». Но механика принципиально разная.
Zapier и Make реагируют на события: новый контакт добавлен → отправить SMS → добавить тег. Триггерная автоматизация: быстрая, надёжная, но жёсткая. Если задача выходит за рамки предопределённого сценария — Zapier не справится.
Нативные воркфлоу GoHighLevel работают по той же логике: заранее прописанные условия и действия. Мощный инструмент для стандартных процессов, но он не рассуждает о данных — только реагирует на них.
Claude через MCP работает иначе. Вы описываете задачу на обычном языке — Claude разбирается в ней, запрашивает нужные данные из GHL, применяет логику и выполняет действие. Один запрос может охватывать несколько шагов, условий и решений.
«Claude с MCP работает в диалоговом режиме и по запросу. Вы задаёте вопрос или даёте инструкцию на естественном языке, Claude анализирует её, достаёт нужные данные из вашего GHL-аккаунта и выполняет задачу. Он обрабатывает многоступенчатую логику, условия и решения в рамках одной инструкции» (Netpartners Marketing, апрель 2026).
Эти подходы не исключают друг друга. Zapier закрывает событийную автоматизацию — например, автоматическую отправку welcome-SMS при добавлении контакта. Claude закрывает анализ по запросу, массовые операции и задачи, где нужно суждение: аудит базы, чистка воронки, формирование отчёта.
Что нужно перед настройкой: PIT, Location ID и разрешения
Прежде чем открывать Claude, подготовьте три вещи.
Private Integration Token (PIT). Это API-ключ для конкретного саб-аккаунта GoHighLevel. Создаётся в Settings → Private Integrations внутри нужного саб-аккаунта. При создании выбирайте только те scopes, которые действительно нужны — минимальный набор снижает риски при утечке токена.
Location ID. Уникальный идентификатор саб-аккаунта. Найдёте в URL при работе внутри аккаунта или в настройках. Строка из букв и цифр.
Claude Code. Терминальный интерфейс Claude от Anthropic, который умеет работать с MCP-серверами. Стоит $20 в месяц (тариф Pro). Claude Desktop тоже поддерживает MCP, но Claude Code удобнее для агентских воркфлоу: гибче при работе с несколькими конфигурациями.
Настройка GoHighLevel MCP не стоит дополнительно — доступ включён во все тарифы GoHighLevel, начиная со Starter ($97/месяц).
Пошаговая настройка: подключить Claude к GoHighLevel за 15 минут
Шаг 1. Создайте Private Integration Token
Зайдите в нужный саб-аккаунт GoHighLevel. Откройте Settings → Private Integrations → Create New Integration. Дайте токену понятное название (например, claude-crm-access). Выберите scopes для старта:
- Contacts — чтение и обновление контактов
- Opportunities — работа с воронкой
- Conversations — доступ к перепискам
- Tags — присвоение тегов
Скопируйте токен сразу после создания — GoHighLevel показывает его только один раз.
Шаг 2. Узнайте Location ID
В том же саб-аккаунте перейдите в Settings → Business Info. Location ID указан в разделе с идентификаторами аккаунта. Сохраните его рядом с токеном.
Шаг 3. Создайте конфигурационный файл для Claude Code
В корневой папке рабочего проекта создайте файл .mcp.json:
{
"mcpServers": {
"gohighlevel": {
"url": "https://services.leadconnectorhq.com/mcp/",
"headers": {
"Authorization": "Bearer ВАШ_PIT_ЗДЕСЬ",
"locationId": "ВАШ_LOCATION_ID_ЗДЕСЬ"
}
}
}
}
Замените ВАШ_PIT_ЗДЕСЬ и ВАШ_LOCATION_ID_ЗДЕСЬ на реальные значения из шагов 1 и 2.
Шаг 4. Запустите Claude Code и проверьте подключение
Откройте терминал в папке проекта, запустите Claude Code. Введите простой тестовый запрос:
Покажи список последних 10 контактов в моём GoHighLevel аккаунте
Если Claude вернул реальные данные — подключение работает. Если нет — проверьте синтаксис .mcp.json и убедитесь, что PIT скопирован без лишних пробелов.
Шаг 5. Протестируйте на staging до работы с реальными данными
Прежде чем давать Claude право редактировать контакты или воронку в боевом аккаунте, создайте несколько тестовых контактов и проверьте, как Claude работает на них. Это занимает 5 минут и страхует от случайных массовых изменений.
10 воркфлоу для агентств, которые стоит запустить первыми
Вот задачи, где разница между «делать руками» и «сказать Claude» ощущается сразу.
Воркфлоу 1: Аудит зависших лидов
Задача: найти контакты, которые заполнили форму заявки, но так и не получили ответа.
- Откройте Claude Code с подключённым GHL MCP.
- Введите:
Найди все контакты, которые заполнили форму заявки за последние 7 дней, но у которых нет ни одного залогированного разговора и которые не назначены ни на один этап воронки. - Claude запрашивает API контактов и разговоров GoHighLevel.
- Claude возвращает список с именами, датами заявок и контактными данными.
- Введите:
Поставь каждому из этих контактов тег needs-followup и назначь их на [имя менеджера].
Раньше такой аудит занимал час ручной работы. Теперь — один запрос.
Инструменты: Claude Code, GoHighLevel MCP (scopes: Contacts, Conversations, Tags)
Воркфлоу 2: Массовая чистка воронки
Лиды зависли в стадии «Предложение отправлено» больше двух недель без движения? Claude закроет это одним блоком инструкций.
Перемести все сделки в стадии "Предложение отправлено", у которых не было активности 14+ дней, в стадию "Заморожено".Добавь заметку к каждой: "Переведено в заморожено [дата] из-за 14 дней без активности".Поставь им тег cold-lead.
Claude выполняет все три операции за секунды, независимо от количества записей.
Инструменты: Claude Code, GoHighLevel MCP (scopes: Opportunities, Tags)
Воркфлоу 3: Отчёт по клиенту за пять минут
Агентство RSL/A — двое сотрудников, пять клиентов — раньше тратило 30 минут на еженедельный клиентский отчёт. После подключения Claude Code + GoHighLevel MCP время упало до 5 минут (rsla.io, май 2026).
Промпт для отчёта:
Покажи все закрытые сделки за этот месяц: общее количество, суммарную выручку,
средний размер сделки и сравни с прошлым месяцем.
Claude забирает данные через endpoint opportunities, считает и форматирует сравнение. Дальше можно попросить:
Напиши 3-предложное письмо клиенту с кратким итогом этих результатов.
Инструменты: Claude Code, GoHighLevel MCP (scopes: Opportunities, Conversations)
Воркфлоу 4: Таргетинг по SMS для незакрытых лидов
Найди все контакты, которые получили апрельскую email-рассылку, но не кликнули ни по одной ссылке и не забронировали звонок.- Claude сверяет данные разговоров и активности контактов.
Отправь им SMS: [текст сообщения].
Claude выполняет отправку через scope Conversations GoHighLevel MCP.
Инструменты: Claude Code, GoHighLevel MCP (scopes: Conversations, Contacts)
Воркфлоу 5: Чистка и стандартизация контактов
База контактов всегда обрастает мусором: дубли, пропущенные теги, нестандартные форматы номеров. Claude находит и исправляет системно:
Найди контакты без тега источника. Покажи их список.
Найди контакты с дублирующимися email-адресами и покажи, какие из них созданы позже.
Это займёт не один запрос, но заменит часы ручной проверки.
Инструменты: Claude Code, GoHighLevel MCP (scopes: Contacts, Tags)
Воркфлоу 6: Идентификация пробелов в расписании
Найди все лиды в стадии "Демо назначено", у которых нет запланированной встречи
на следующие 7 дней в GoHighLevel Calendar.
Результат — список контактов, которым нужно перезвонить для перебронирования, без ручного прохода по каждому.
Воркфлоу 7–10: Дополнительные сценарии
Остальные воркфлоу, которые агентства запускают регулярно:
- Анализ источников лидов: сравнить конверсию по источникам за квартал.
- Проверка активности менеджеров: найти менеджеров, у которых нет ни одного залогированного касания с лидом за последние 3 дня.
- Массовое добавление тегов по условию: пометить всех контактов из определённого города или с определённым ответом в форме.
- Подготовка к ревью с клиентом: собрать все открытые задачи и незакрытые сделки по конкретному клиенту одним запросом.
Мультиклиентская настройка: несколько саб-аккаунтов без пересечения данных
Если ведёте несколько клиентов в GoHighLevel, каждый саб-аккаунт требует отдельного PIT и Location ID. Работать с ними через один конфигурационный файл опасно — высок риск случайно применить изменения к не тому аккаунту.
Правильный подход: один .mcp.json на один клиентский проект.
Структура проектов:
/agency-clients/
/client-alpha/
.mcp.json ← PIT + Location ID клиента A
prompts/
/client-beta/
.mcp.json ← PIT + Location ID клиента B
prompts/
Когда работаете с конкретным клиентом, запускайте Claude Code из его папки. Конфигурация загружается только для нужного аккаунта.
Дополнительная защита: при создании PIT для каждого клиента включайте только те scopes, которые реально нужны. Не отправляете SMS для клиента B — не включайте scope Conversations в его токене.
Официальный MCP-сервер против коммьюнити-серверов
GoHighLevel предлагает официальный MCP-сервер с 36 инструментами. Для большинства агентских задач — контакты, воронка, разговоры, теги, отчёты — этого хватает.
Если нужно больше, коммьюнити-сервер от mastanley13 (GitHub: mastanley13/GoHighLevel-MCP) предлагает 269+ инструментов в 19 категориях, включая инвойсы, платежи, социальные сети, e-commerce и email-кампании. На май 2026 года репозиторий собрал 166 звёзд и 172 форка — показатель активного использования среди разработчиков.
Для агентств, которые только начинают, совет простой: стартуйте с официальным сервером. Он стабильнее, обновляется синхронно с платформой и покрывает 80% задач. Переходите на коммьюнити-сервер, когда конкретно упрётесь в ограничения официального.
Один практический нюанс: у коммьюнити-сервера конфигурация отличается — вместо удалённого HTTP-подключения он запускается локально через npx. Проверьте актуальную документацию в репозитории перед настройкой.
Устранение типичных ошибок GoHighLevel MCP
Большинство проблем при первом подключении GoHighLevel MCP связаны с токенами и разрешениями.
Ошибка 401 (Unauthorized). PIT недействителен или скопирован с ошибкой — лишний пробел, неполная строка. Создайте новый токен и скопируйте заново.
Ошибка 403 (Forbidden). Токен действителен, но у него нет нужного scope. Зайдите в Settings → Private Integrations, отредактируйте токен, добавьте нужное разрешение.
Ошибка 404 (Not Found). Неверный Location ID или URL MCP-сервера. Убедитесь, что Location ID принадлежит именно тому саб-аккаунту, с которым работаете. URL сервера: https://services.leadconnectorhq.com/mcp/ — без изменений.
Ошибка 429 (Too Many Requests). GoHighLevel допускает 100 запросов за 10 секунд (zeon.studio, май 2026). При массовых операциях на больших базах Claude может упереться в этот лимит. Решение: разбивайте задачу на части или добавьте паузу между блоками запросов.
Claude не находит инструменты GHL. Убедитесь, что .mcp.json находится в корневой папке проекта, из которого запущен Claude Code. Конфигурация привязана к рабочей директории.
Безопасность при работе с клиентскими данными
GoHighLevel хранит реальные данные реальных клиентов. Несколько правил, которые нельзя игнорировать.
Минимальные разрешения. При создании PIT включайте только те scopes, которые нужны для конкретных задач. Воркфлоу только читает данные — не давайте право на запись.
Ротация токенов каждые 90 дней. Устаревшие токены — стандартная точка уязвимости. Поставьте напоминание в календарь.
Тестирование на staging. Перед массовыми операциями в боевом аккаунте клиента протестируйте на тестовом саб-аккаунте с копией данных. Массовое перемещение сделок или удаление тегов необратимо.
Не храните PIT в Git. Файл .mcp.json с токеном не должен попасть в репозиторий. Добавьте его в .gitignore сразу.
Данные клиента и Anthropic. По условиям использования Anthropic, данные, переданные через Claude Code API, не используются для обучения моделей (если вы не дали явного согласия). При работе с чувствительными клиентскими данными уточните актуальную политику на сайте Anthropic.
Реальные результаты агентств: что меняется после подключения
RSL/A — маркетинговое агентство с двумя сотрудниками — работает с Claude Code через девять MCP-интеграций: GoHighLevel, Notion, Vercel, GitHub, Sanity CMS и Google Workspace. Их данные за 2026 год:
- Еженедельный клиентский отчёт: с 30 минут до 5 минут.
- Настройка новой воронки: с 1 часа до нескольких минут.
- Годовой выпуск контента: с 4 постов и 2 сайтов до 12 постов и 5 сайтов.
- Количество запущенных автоматизаций: с 10 до 30 за год.
- Суммарные расходы на AI-инструменты: менее $60 в месяц (rsla.io, май 2026).
«Claude Code стал третьим сотрудником RSL/A — он не ходит на встречи с клиентами и не принимает стратегических решений, но строит, разворачивает, генерирует, управляет и автоматизирует в темпе, который делает агентство из двух человек конкурентоспособным с командами в пять раз больше» (команда RSL/A, май 2026).
Анонимное агентство из руководства Netpartners Marketing запустило схожий сценарий: аудит всех контактов, заполнивших форму заявки без ответа, и массовый перевод сделок с 14-дневной неактивностью в стадию «Заморожено». Задачи, которые раньше требовали часы ручной навигации по дашборду GoHighLevel, теперь выполняются одним запросом за секунды (netpartners.marketing, апрель 2026).
Цифры объясняет одна деталь, которую RSL/A особо выделяют: эффективность Claude Code резко возрастает после создания файла CLAUDE.md — документа с контекстом бизнеса, структурой клиентов, соглашениями по именованию и предпочтениями по формату вывода.
«Без файла CLAUDE.md Claude Code выдаёт обобщённый результат. С ним — результат, который мог бы подготовить сотрудник, знающий бизнес изнутри» (команда RSL/A, май 2026).
Для агентства это значит: потратьте час на документирование контекста каждого клиента в CLAUDE.md — и каждый следующий запрос будет требовать меньше уточнений.
Что делать дальше
Начните с одного воркфлоу. Настройте подключение GoHighLevel MCP по инструкции выше — это займёт 15 минут. Потом запустите аудит зависших лидов: он даёт мгновенный, измеримый результат и не несёт рисков для данных (только чтение и присвоение тегов). Когда убедитесь, что Claude корректно работает с вашим аккаунтом — добавляйте следующие воркфлоу один за другим.
Файл CLAUDE.md с контекстом клиента создайте до того, как начнёте работать с реальными аккаунтами. Час на документирование сэкономит десятки часов уточнений в дальнейшем.
Часто задаваемые вопросы
Работает ли GoHighLevel MCP на тарифе Starter?
Да. MCP-доступ включён во все тарифы GoHighLevel, включая Starter за $97 в месяц. Никаких дополнительных платежей GoHighLevel за это не берёт. Единственные расходы — подписка на Claude Code ($20/месяц для тарифа Pro).
В чём разница между официальным MCP-сервером GHL и коммьюнити-версией?
Официальный сервер поддерживает 36 инструментов (с планируемым расширением до 250+), обновляется командой GoHighLevel и подключается удалённо через HTTP. Коммьюнити-сервер от mastanley13 предлагает 269+ инструментов в 19 категориях, включая инвойсы, платежи, e-commerce и email-кампании. Он запускается локально через npx и требует отдельной настройки. Для старта достаточно официального сервера.
Может ли Claude создавать автоматизированные воркфлоу внутри GoHighLevel через MCP?
Зависит от доступных инструментов в текущей версии сервера. Официальный MCP-сервер (36 инструментов) заточен под работу с контактами, воронкой, разговорами и тегами — но не под создание нативных GHL-воркфлоу. Коммьюнити-сервер расширяет эти возможности. Для сложных автоматизированных сценариев внутри GHL нативные воркфлоу GoHighLevel пока остаются основным инструментом.
Безопасно ли подключать Claude к аккаунту с данными клиентов?
Да, если соблюдать базовые правила: минимальные scopes в PIT, ротация токенов каждые 90 дней, тестирование на staging-аккаунте перед массовыми операциями. Файл .mcp.json не должен попадать в репозиторий — добавьте его в .gitignore.
Нужен именно Claude Code или подойдёт Claude Desktop?
Claude Desktop тоже поддерживает MCP — для базовых сценариев его хватит. Claude Code удобнее для агентских воркфлоу: гибче при работе с несколькими конфигурациями .mcp.json, лучше для многоэтапных задач и поддерживает Routines — запуск задач по расписанию (функция появилась в апреле 2026 года).
Как управлять несколькими клиентами, чтобы данные не пересекались?
Создайте отдельный файл .mcp.json в папке каждого клиента с его собственными PIT и Location ID. Запускайте Claude Code из папки нужного клиента — конфигурация загружается по рабочей директории. Так данные одного клиента физически изолированы от другого.
Готовы автоматизировать бизнес?
Обсудим процессы, автоматизация которых принесёт вашей команде максимум пользы.
Связаться с нами