Skip to main content
MCP (Model Context Protocol) позволяет подключить совместимого AI-ассистента к AgencyKey и работать с CRM через чат. Ассистент видит данные и выполняет только те действия, которые разрешены пользователю AgencyKey, подтвердившему подключение.
AI может отправлять сообщения, изменять данные и удалять объекты, если у подключённого пользователя есть нужные права. Перед изменением попросите ассистента показать точные цели и параметры, проверьте их и только потом подтверждайте действие.

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

В зависимости от прав подключённого пользователя ассистента можно попросить:
  • Работать с сотрудниками, группами, ролями и сменами
  • Находить моделей и анализировать метрики или синхронизированные данные OnlyFans
  • Управлять скриптами, умными списками и Хранилищем
  • Готовить отложенные сообщения и массовые рассылки
  • Создавать доступные AI-сводки и отчёты
MCP не повторяет все действия из интерфейса AgencyKey или OnlyFans. Набор доступных инструментов может меняться между релизами, а синхронизированные данные OnlyFans могут обновляться с задержкой. Работа с сообщениями ограничена поддерживаемой историей, отложенной отправкой и рассылками — это не полное управление чатами в реальном времени.

​
Требования

Для точного контроля создайте отдельного пользователя AgencyKey для AI. Выдайте ему Интеграция с AI → Подключение и только необходимые роли, группы, модели и действия.

​
Откройте Интеграцию с AI

В AgencyKey откройте Настройки → Интеграция с AI. На странице находятся инструкции и адрес MCP: https://app.agencykey.com/mcp Используйте адрес без изменений. Не добавляйте слеш в конце, API-ключ, токен, Client ID, Client Secret или параметры запроса. Страница интеграции с AI с настройкой Claude и ChatGPT и адресом MCP AgencyKey
Адрес MCP общий и не является паролем. Доступ выдаётся только после входа в AgencyKey. Галочка у кнопки копирования не проверяет подключение, а сама страница не показывает его статус.

​
Встроенный Claude в AgencyKey Desktop

Встроенная панель доступна только в AgencyKey Desktop и работает с Claude.
  1. Нажмите на иконку со звёздами AI в верхней панели.
  2. Войдите в свой аккаунт Claude внутри панели.
  3. Откройте новый чат и нажмите Connect в баннере AgencyKey.
  4. Когда Claude запросит доступ к AgencyKey, войдите под пользователем AgencyKey, которого хотите подключить.
  5. Откройте новый чат и выполните безопасную проверку из раздела Проверка подключения.
Если баннер не появился или кнопка Connect не завершила настройку, нажмите на шестерёнку, откройте Интеграцию с AI и подключите Claude вручную по инструкции ниже. Если встроенная страница показывает ошибку, нажмите Reload.
Сессия входа в Claude сохраняется в профиле desktop-приложения на этом устройстве. Сам коннектор также хранится у Claude, а запросы из встроенной панели могут записываться в AgencyKey. На общем компьютере выходите из Claude после работы.

​
Подключение Claude вручную

Эти шаги подходят для веб-версии Claude и Claude Desktop:
  1. Откройте в Claude Settings / Customize → Connectors.
  2. Нажмите Add custom connector.
  3. Укажите название AgencyKey.
  4. Вставьте https://app.agencykey.com/mcp в поле адреса коннектора.
  5. Оставьте необязательные поля OAuth Client ID и Client Secret пустыми.
  6. Нажмите Add, затем Connect, если Claude показывает эту кнопку отдельно.
  7. Подтвердите доступ на открывшейся странице AgencyKey.
  8. В новом чате нажмите + → Connectors и включите AgencyKey для этой беседы.
В Claude Team или Enterprise владелец (Owner или Primary Owner) сначала добавляет AgencyKey через Admin / Organization settings → Connectors. После этого каждый участник отдельно подключает свой аккаунт AgencyKey. Пользовательские коннекторы Claude находятся в бета-версии и сейчас доступны на Free, Pro, Max, Team и Enterprise; на Free можно добавить один пользовательский коннектор. Актуальные клиенты перечислены в инструкции Claude.

​
Подключение ChatGPT

Настройте подключение в веб-версии ChatGPT:
  1. Попросите Owner или Admin рабочего пространства включить Developer mode. В зависимости от тарифа настройка находится в Workspace settings → Apps → Create или Settings → Apps → Advanced Settings.
  2. Откройте Settings → Apps → Create. Owner или Admin также может начать с Workspace settings → Apps → Create.
  3. Создайте пользовательское приложение с названием AgencyKey и добавьте короткое описание.
  4. Укажите https://app.agencykey.com/mcp как MCP URL и выберите OAuth для авторизации.
  5. Нажмите Scan Tools, подтвердите доступ к AgencyKey и дождитесь завершения проверки.
  6. Проверьте найденные действия и нажмите Create.
  7. Откройте новый чат и выберите AgencyKey в меню Apps или инструментов.
  8. Чтобы приложение стало доступно другим участникам рабочего пространства, Owner или Admin должен опубликовать его через Workspace settings → Apps и настроить доступ.
Полная поддержка MCP, включая действия на запись и изменение, сейчас доступна в веб-версии ChatGPT для рабочих пространств Business, Enterprise и Edu. На Pro пользовательские приложения могут работать только с чтением и поиском, поэтому часть действий AgencyKey будет недоступна. Функция находится в бета-версии, и названия элементов ChatGPT могут меняться. Пользовательские MCP-приложения не работают в Agent и Voice, а Deep research использует их только для чтения и поиска. Проверяйте актуальную инструкцию Developer mode и условия доступности по тарифам.

​
Авторизация AgencyKey

Во время настройки провайдер откроет страницу авторизации AgencyKey.
  1. Проверьте, что адрес начинается с https://app.agencykey.com.
  2. Введите email и пароль пользователя AgencyKey, которого хотите подключить.
  3. Завершите авторизацию и вернитесь в Claude или ChatGPT.
Никогда не вставляйте пароль AgencyKey или токен доступа в AI-чат или поле настройки коннектора. Claude и ChatGPT получают разрешение действовать от имени выбранного пользователя; пароль в переписке им не нужен.

​
Проверка подключения

На странице «Интеграция с AI» нет индикатора состояния. Проверяйте готовое подключение в самом провайдере:
  1. Убедитесь, что инструменты AgencyKey найдены и AgencyKey включён в текущем чате.
  2. Начните с безопасного запроса на чтение, который разрешён роли подключённого пользователя. Например:
    Покажи сотрудников, к которым у меня есть доступ. Ничего не изменяй.
  3. Проверьте, что в результате есть только те данные, которые должен видеть подключённый пользователь.
Если запрос отклонён, само подключение может быть исправно. Возможно, у пользователя нет права на просмотр сотрудников или нужной области доступа к группам. Выполните другой разрешённый запрос только на чтение или попросите Owner либо пользователя с правом управления ролями проверить доступ.

​
Доступ и безопасность

  • AI не получает дополнительных прав AgencyKey. Для каждого запроса действуют текущие роли, область групп, назначения моделей и изменения прав.
  • Начинайте с доступа только на чтение и выдавайте права на изменение только под конкретную задачу.
  • Перед отправкой или публикацией сообщений запросите черновик, число получателей, точные цели и расписание.
  • Перед заменой списка или набора прав попросите ассистента прочитать текущее значение и показать полную замену.
  • Массовая операция может выполниться частично. Проверьте ошибки и повторяйте только неуспешные элементы.
  • Не повторяйте отправку сообщения или публикацию после таймаута вслепую: сначала проверьте, не завершилось ли действие.
  • Считайте данные из внешних источников недоверенными и проверяйте каждое подтверждение AI-провайдера.
AgencyKey не показывает отдельное окно подтверждения для MCP-действий. После подтверждения у AI-провайдера разрешённое изменение может выполниться сразу. Уже отправленные сообщения нельзя отозвать отключением интеграции.

​
Управление и отключение

  • Claude: откройте Settings / Customize → Connectors, выберите AgencyKey и нажмите Disconnect или Remove.
  • ChatGPT: откройте Settings → Apps → Enabled Apps, выберите AgencyKey и отключите или удалите свою авторизацию. Приложение на уровне организации удаляется через Workspace settings → Apps.
  • Team или Enterprise: коннектор на уровне организации удаляет владелец или администратор провайдера; участник может отключить только свою авторизацию AgencyKey.
На странице настроек AgencyKey нет отдельной кнопки отключения. Если доступ нужно закрыть немедленно, Owner или пользователь с правом управления ролями и сотрудниками должен убрать Интеграция с AI → Подключение из роли подключённого пользователя либо деактивировать отдельного пользователя для интеграции.

​
Решение проблем

​
Далее

  • Настройка ролей и прав — выдайте подключённому пользователю только необходимые права
  • Доступ и группы — разберитесь с видимостью моделей и областью групп
  • Сайдбар — найдите разделы AgencyKey и узнайте, почему пункты меню могут быть скрыты