Help Scout MCP Server — MCP-сервер для Claude Code: как установить
Сервер подключает Claude Code и другие редакторы к тикетам, клиентам и базе знаний Help Scout. Пригодится, чтобы разбирать переписку техподдержки прямо из чата с агентом.
claude mcp add --env HELPSCOUT_APP_ID=<HELPSCOUT_APP_ID> --env HELPSCOUT_APP_SECRET=<HELPSCOUT_APP_SECRET> --env REDACT_MESSAGE_CONTENT=<REDACT_MESSAGE_CONTENT> --transport stdio help-scout-mcp-server -- npx -y help-scout-mcp-serverЧто делает Help Scout MCP Server
Сервер открывает ассистенту доступ к тикетам, организациям, профилям пользователей и статьям Docs. Вместо того чтобы перегружать контекст модели десятками схем сразу, сервер объявляет три базовых инструмента чтения: search_help_scout для поиска операции, describe_help_scout для загрузки её схемы и read_help_scout для выполнения запроса. Через них доступно 55 операций чтения из Mailbox API и Docs API.
Для аутентификации Help Scout требует исключительно связку App ID и App Secret через протокол OAuth2 Client Credentials. Личные токены доступа не поддерживаются. Приложение работает с правами создавшего его пользователя, поэтому любые операции изменения данных (добавление заметок, черновики ответов или смену статусов) разработчик выключил по умолчанию через флаг подтверждения.
Если вам нужен доступ к статьям базы знаний, отдельно потребуется HELPSCOUT_DOCS_API_KEY, так как Docs API v1 работает независимо от почтовых ящиков. Объём передаваемых данных можно сократить переменной REDACT_MESSAGE_CONTENT.
Какие задачи решает
- Находить тикеты по статусу, тегам, клиентам и диапазону дат
- Загружать историю переписки и черновики перед ответом пользователю
- Искать статьи в базе знаний Help Scout Docs через Docs API
- Выгружать отчёты о продуктивности команды и метрики удовлетворённости клиентов
Примеры запросов агенту
- Найди в Help Scout открытые тикеты с тегом billing за последнюю неделю
- Выгрузи всю ветку сообщений по тикету 12845 и составь краткую выжимку
- Поищи в статьях Docs инструкции по настройке вебхуков
Как установить Help Scout MCP Server
Командой платформы
claude mcp add --env HELPSCOUT_APP_ID=<HELPSCOUT_APP_ID> --env HELPSCOUT_APP_SECRET=<HELPSCOUT_APP_SECRET> --env REDACT_MESSAGE_CONTENT=<REDACT_MESSAGE_CONTENT> --transport stdio help-scout-mcp-server -- npx -y help-scout-mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add help-scout-mcp-server --env HELPSCOUT_APP_ID=<HELPSCOUT_APP_ID> --env HELPSCOUT_APP_SECRET=<HELPSCOUT_APP_SECRET> --env REDACT_MESSAGE_CONTENT=<REDACT_MESSAGE_CONTENT> -- npx -y help-scout-mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"help-scout-mcp-server": {
"command": "npx",
"args": [
"-y",
"help-scout-mcp-server"
],
"env": {
"HELPSCOUT_APP_ID": "<HELPSCOUT_APP_ID>",
"HELPSCOUT_APP_SECRET": "<HELPSCOUT_APP_SECRET>",
"REDACT_MESSAGE_CONTENT": "<REDACT_MESSAGE_CONTENT>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"help-scout-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"help-scout-mcp-server"
],
"env": {
"HELPSCOUT_APP_ID": "<HELPSCOUT_APP_ID>",
"HELPSCOUT_APP_SECRET": "<HELPSCOUT_APP_SECRET>",
"REDACT_MESSAGE_CONTENT": "<REDACT_MESSAGE_CONTENT>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e HELPSCOUT_APP_ID=<HELPSCOUT_APP_ID> -e HELPSCOUT_APP_SECRET=<HELPSCOUT_APP_SECRET> -e REDACT_MESSAGE_CONTENT=<REDACT_MESSAGE_CONTENT> help-scout-mcp-server npx -y help-scout-mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Help Scout MCP Server
Как установить Help Scout MCP Server в Claude Code?
Выполните в терминале команду claude mcp add help-scout-mcp -e HELPSCOUT_APP_ID=<HELPSCOUT_APP_ID> -e HELPSCOUT_APP_SECRET=<HELPSCOUT_APP_SECRET> -- npx -y help-scout-mcp-server, подставив свои ключи из приватного приложения Help Scout.
Что делает Help Scout MCP Server?
Сервер связывает ИИ-ассистента с API Help Scout, позволяя искать разговоры, просматривать цепочки писем, проверять данные клиентов и статьи базы знаний без переключения в браузер.
Почему по умолчанию выключены операции записи?
Приватное приложение Help Scout использует OAuth2 Client Credentials и наследует все права создавшего его сотрудника. Чтобы ИИ случайно не изменил тикет или не отправил ответ клиенту, инструмент write_help_scout скрыт, пока вы явно не включите права на запись.
