适合谁
- 使用Help Scout并希望让AI助手（尤其Claude）快速查询工单、客户与知识库的支持团队
- 希望在编辑器或聊天窗口内完成客户上下文查阅的工程师
- 需要只读默认、可审计开启写入的安全敏感团队
H
67FMRS · C
一个成熟度较高的社区Help Scout集成：55个读取操作覆盖会话、客户、组织、报告与Docs，采用三工具网关设计避免schema过载；写入默认关闭且分级管控（客户可见操作需双重开关与显式确认），并提供脱敏、限流重试与可选收件箱范围。文档详尽，提供npm/Docker/MCPB多种安装方式，但为第三方实现而非Help Scout官方产品。
一个用于Help Scout的MCP服务器，提供对收件箱、会话、客户、组织、线程和Docs知识库的全面读取能力（覆盖Mailbox与Docs API的55个操作），并支持默认关闭的可选写入操作（起草回复、内部备注、标签、状态、分配、延后等）。通过search/describe/read三个网关工具保持紧凑的工具面，支持消息内容脱敏与收件箱范围限制。使用Help Scout OAuth2 Client Credentials认证，MIT许可，可经npm（npx）、Docker或Claude Desktop扩展（.mcpb）安装。
工具能力
search_help_scout
按意图查找Help Scout操作（如“客户会话历史”、“满意度报告”）。
describe_help_scout
加载所选操作的完整输入schema。
read_help_scout
执行一个读取操作，如getThreads、searchConversations、searchCustomersByEmail等。
write_help_scout
可选的写入工具（需操作者启用），包含11个一级会话操作；客户可见操作（sendReply、publishDraft）需额外开关及确认参数。
安装接入
- 在Help Scout的My Apps中创建Private App，获取App ID与App Secret。2a. Claude Desktop/Cowork：从Releases下载最新.mcpb文件，双击安装，在扩展设置中填入凭据并重启；2b. Claude Code：运行 claude mcp add helpscout --env HELPSCOUT_APP_ID=... --env HELPSCOUT_APP_SECRET=... -- npx -y help-scout-mcp-server；2c. 其他MCP客户端：在配置文件的mcpServers中加入npx [email protected]及环境变量；2d. Docker：docker run并传入HELPSCOUT_APP_ID、HELPSCOUT_APP_SECRET环境变量。可选设置HELPSCOUT_DOCS_API_KEY以启用Docs工具，HELPSCOUT_ENABLE_WRITES=true以启用写入。
claude_desktop_config.json
{"mcpServers":{"helpscout":{"command":"npx","args":["[email protected]"],"env":{"HELPSCOUT_APP_ID":"your-app-id","HELPSCOUT_APP_SECRET":"your-app-secret","HELPSCOUT_DOCS_API_KEY":"optional-docs-api-key"}}}}
选型与风险
不适合谁
- 不使用Help Scout作为客服系统的团队
- 不需要或不愿授予支持数据访问权限的环境
- 期望开箱即有发送邮件/删除/管理员配置写入能力的用户（这些被刻意排除）
所需权限
- Help Scout OAuth2 App ID与App Secret（必需，以创建者用户身份与权限访问）
- 可选：HELPSCOUT_DEFAULT_INBOX_ID用于限定搜索范围
- 可选：HELPSCOUT_DOCS_API_KEY用于Docs知识库工具
- 可选：HELPSCOUT_ENABLE_WRITES及HELPSCOUT_ENABLE_CUSTOMER_VISIBLE_WRITES用于启用写入
风险与副作用
- AI可访问全部支持数据（会话内容、客户与组织信息），凭据泄露会带来数据外泄风险
- 消息默认不脱敏；REDACT_MESSAGE_CONTENT并非合规边界，也不能移除所有客户标识
- 写入功能开启后可能修改会话状态、标签、分配等；二级开关（sendReply/publishDraft）会向客户发送邮件，虽有确认机制仍需谨慎
- Help Scout认证以创建者权限生效，无独立scope控制，共享凭据会扩大影响面
常见排障
- 认证失败：用curl向api.helpscout.net/v2/oauth2/token验证凭据
- 搜索结果为空：searchConversations是唯一搜索工具，关键词用contentTerms/subjectTerms；核对服务器指令中的收件箱ID而非猜测；放宽搜索词或时间范围
- 工具未出现（Cowork）：更新桌面应用至最新版本并开启新会话
- 需要更多细节：以LOG_LEVEL=debug运行
使用场景
按关键词、状态、标签、邮箱域名或工单号搜索会话
按姓名或邮箱查找客户并查看联系渠道
查看组织的成员及其支持历史
拉取完整线程历史后再起草回复
搜索并检索Docs知识库文章
获取公司、渠道、生产力、满意度等报告与元数据
在多个收件箱中监控活动（可脱敏）
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Cursor完整支持
VS Code完整支持
Windsurf完整支持
Continue.dev完整支持
Goose完整支持
Claude Cowork完整支持
Codex完整支持
Gemini CLI完整支持
OpenCode完整支持