Подключение ИИ-ассистента к Helpdash через MCP

Helpdash предоставляет сервер Model Context Protocol (MCP), так что ИИ-ассистент может работать прямо внутри вашего рабочего пространства, а не заставлять вас копировать обращения в окно чата. Спросите «какие обращения сегодня нарушают SLA?» или «сделай выжимку этой переписки для передачи смены» — и ассистент обратится к самому Helpdash.

Эта статья описывает, что предоставляет коннектор, как его подключить и — часть, которую стоит прочитать дважды, — чего ему делать не разрешено.

Что предоставляет коннектор

Сервер несёт 46 инструментов, четыре готовые подсказки и один ресурс, перечисляющий все значения перечислений, которые принимают инструменты. Инструменты охватывают обращения, живой чат, базу знаний, шаблоны ответов, проекты и коллег, панель, CSAT, правила автоматизации, вебхуки, настройки, журнал действий и биллинг.

Чтение и запись — всегда разные инструменты. Нет универсального инструмента api_request с параметром method: поиск обращений и изменение обращения — разные инструменты с разными правами, поэтому ассистент с доступом на чтение не сможет ничего изменить, подставив другой аргумент.

Четыре подсказки — это сценарии, которые стоит иметь заранее написанными:

• Разобрать обращение — предлагает приоритет, категорию и исполнителя. Ничего не меняет.
• Подготовить ответ клиенту — составляет текст на основе вашей базы знаний и шаблонов ответов. Отправить не может; ответ возвращается вам на проверку.
• Сделать выжимку переписки — сжимает длинное обращение или расшифровку чата для передачи смены.
• Еженедельный отчёт поддержки — объём, SLA, CSAT и то, что требует внимания.

Подключение клиента

Откройте Настройки → ИИ-коннекторы (MCP) и выпустите токен. Дайте ему понятную вам метку, для первого токена оставьте все переключатели записи выключенными и скопируйте ключ — он показывается ровно один раз.

Затем зарегистрируйте его. Для Claude Code:

claude mcp add --transport http helpdash https://your-workspace.helpdash.io/mcp \
  --header "Authorization: Bearer hd_mcp_..."

Для любого клиента, читающего .mcp.json:

{
  "mcpServers": {
    "helpdash": {
      "type": "http",
      "url": "https://your-workspace.helpdash.io/mcp",
      "headers": { "Authorization": "Bearer hd_mcp_..." }
    }
  }
}

Оба фрагмента создаются для вас, уже заполненные адресом вашего пространства, на том же экране, где появляется токен.

Клиенты, которым удобнее вход через браузер, могут использовать OAuth 2.1 вместо статического токена: сервер публикует стандартные документы обнаружения, поддерживает PKCE и динамическую регистрацию клиентов и показывает экран согласия, где перечислены ровно запрашиваемые области доступа. Ни токена копировать, ни ключа хранить на диске.

Чего он не может

Коннектор — не вторая, более свободная API. Каждый вызов проходит те же четыре проверки, что и запрос человека.

Он действует от вашего имени. Токен привязан к сотруднику, который его выпустил. Он в точности наследует его роли и права: если вы не можете открыть обращение в приложении, ассистент с вашим токеном тоже не сможет. И он привязан к одному рабочему пространству: нет аргумента, который дотянется до данных другого арендатора.

Только чтение, пока вы не скажете иначе. Новый токен со всеми выключенными переключателями может искать, читать и строить отчёты — и не более. Доступ на запись выдаётся по областям — менять обращения, отвечать в живом чате, править базу знаний, управлять проектами, приглашать коллег, менять настройки, менять правила автоматизации — и только по тем, что вы отметили. Чтение включено всегда, потому что ассистент, который умеет писать, но не читать, бесполезен.

Инструменты записи сначала спрашивают. Каждый инструмент, меняющий данные, помечен как разрушительный, поэтому корректно написанный клиент спрашивает вас перед каждым вызовом, а не действует молча. Инструменты, которые доходят до клиента, говорят об этом в своём описании: сообщение в живом чате доставляется мгновенно и не может быть отозвано, а комментарий к обращению по умолчанию является внутренней заметкой, так что ничего не попадёт к клиенту случайно.

Секреты остаются на сервере. Чтение ваших настроек через коннектор возвращает учётные данные интеграций замаскированными. Нет аргумента, который бы их раскрыл.

Текст клиента огорожен. Описания обращений, комментарии и расшифровки чатов пишут другие люди, и ящик поддержки — ровно то место, где кто-то попытается подложить инструкции для читающего их ИИ. Helpdash оборачивает такой текст в явный блок недоверенного содержимого и сообщает модели в собственных инструкциях сервера, что ничто внутри не является командой.

Всё пишется в журнал. Каждый вызов фиксируется с указанием сотрудника, инструмента и результата — в том же журнале аудита, что и остальное рабочее пространство. Если однажды понадобится ответить на вопрос «что ассистент на самом деле делал во вторник?», запись на месте.

Отзыв действует немедленно. Удаление токена в настройках останавливает уже следующий запрос ассистента. Мы храним только SHA-256-хеш ключа, поэтому восстановить его для вас не можем — потеряли, выпускаете новый.

Как ещё сузить токен

Стоит знать про два необязательных ограничения. У токена может быть срок действия — самый простой способ дать короткому эксперименту убраться за собой. И у него может быть список разрешённых IP, чтобы токен, предназначенный одному серверу, нельзя было использовать откуда-то ещё. Оба поля есть в той же форме создания.

Разумный первый токен

Выпустите токен без областей записи и дайте ассистенту неделю только на чтение. Попросите его находить риски по SLA, делать выжимки шумных переписок и готовить черновики ответов, которые вы отправите сами. Это покрывает большую часть пользы без какого-либо риска. Когда поймёте, какая именно область записи вам нужна, выпустите второй токен только с ней — расширить существующий токен намеренно нельзя.

Каждое утверждение выше описывает поведение, доступное сегодня; коннектор доступен в любом рабочем пространстве Helpdash.