Help Scout MCP Server

社区

将AI助手连接到Help Scout工单、客户与知识库

分类: 其他第 25 / 230
Stars: ★ 47 热门
传输方式: stdio（本地进程）
运行环境: Node.js · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 2 个月前
工具数: 4

67FMRS · C

一个成熟度较高的社区Help Scout集成：55个读取操作覆盖会话、客户、组织、报告与Docs，采用三工具网关设计避免schema过载；写入默认关闭且分级管控（客户可见操作需双重开关与显式确认），并提供脱敏、限流重试与可选收件箱范围。文档详尽，提供npm/Docker/MCPB多种安装方式，但为第三方实现而非Help Scout官方产品。

最强项 · 文档质量 17/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

15/20

维护活跃度

12/20

文档质量

17/20

安装易用性

14/20

查看各项评分依据

可靠性 9/20: README 描述了一个三工具网关模式（search_help_scout/describe_help_scout/read_help_scout），声称覆盖 55 个只读操作，并提到 npm test、type-check、lint 等命令，但本次仅提供 README 与 server.json，未包含实际源码、CI workflow 文件或测试文件内容，无法验证声明的行为与真实实现是否一致，也无法确认错误处理/依赖是否可控。按静态校准规则，缺乏可验证的执行证据（真实 CI + 覆盖关键路径的测试），可靠性上限为 12 分，因证据不足进一步扣分。
安全与权限 15/20: 凭据处理较为规范：OAuth2 App ID/Secret 及 Docs API Key 均标记为 isSecret，配置示例中使用占位符而非真实密钥。默认安装为只读，写操作需操作者显式设置环境变量开启；面向客户的高风险操作（sendReply/publishDraft）需要额外标志且每次调用必须携带 confirm/confirmOperation/targetId 三重确认，删除和管理员配置类写操作被明确排除。REDACT_MESSAGE_CONTENT 功能附带诚实说明——不是合规边界、不能移除全部客户标识符，这种坦率披露是加分项。但这些机制均来自 README/manifest 描述（不可信证据），静态审查无法验证代码是否真正强制执行确认逻辑，因此未给满分，也未发现红线问题。
维护活跃度 12/20: 项目使用 MIT 许可证，manifest 显示明确的版本号（2.1.0）并同时发布 npm 包与 Docker 镜像，说明具备一定的发布流程。但材料中缺少提交历史、发布节奏、议题响应时间、依赖更新策略或专门的安全响应渠道等证据；仅有 GitHub Issues/Discussions 作为支持入口，不能替代治理透明度证据。星标数和未解决议题数量仅作为发现信号，不计入加分，且证据缺失应被视为扣分而非默认最佳情况。
文档质量 17/20: 文档层次分明，覆盖多种客户端（Claude Desktop、Claude Code、Cursor/VS Code、Docker）的安装步骤、凭据获取流程、工具与操作对照表、写操作开关及确认协议的完整 JSON 示例、配置项及默认值表格、故障排查章节，并在安全章节中坦诚说明脱敏功能的局限性。扣分点在于文档引用了若干仓库内部指南文件（如 mcp-tool-contract.md）但本次评审未能看到其内容，且关于速率限制、成本的说明较为简略，仅提及自动重试机制。
安装易用性 14/20: 安装路径覆盖 mcpb 一键安装、Claude Code CLI 命令、通用 MCP 客户端 JSON 配置、Docker 运行示例，步骤清晰、配置示例完整，多平台兼容性说明明确。但由于本次审查未见到任何 CI workflow 或测试文件等可验证的执行证据，按静态校准规则，安装易用性得分上限为 15 分。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

使用Help Scout并希望让AI助手（尤其Claude）快速查询工单、客户与知识库的支持团队
希望在编辑器或聊天窗口内完成客户上下文查阅的工程师
需要只读默认、可审计开启写入的安全敏感团队

不适合谁

不使用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控制，共享凭据会扩大影响面

安装接入

准备工作

运行环境：Node.js · Docker

HELPSCOUT_APP_ID 必填密钥 Help Scout OAuth2 App ID（也可用 HELPSCOUT_CLIENT_ID），在 Help Scout > My Apps > Create Private App 获取，必填。

HELPSCOUT_APP_SECRET 必填密钥 Help Scout OAuth2 App Secret（也可用 HELPSCOUT_CLIENT_SECRET），与 App ID 同处获取，必填。

HELPSCOUT_DOCS_API_KEY 可选密钥可选的 Help Scout Docs API 密钥，用于知识库（Docs）工具。

其他可选配置项（8 个）

HELPSCOUT_DEFAULT_INBOX_ID 可选可选，将搜索范围限定到指定 inbox。

REDACT_MESSAGE_CONTENT 可选可选，设为 true 时用占位符替换消息正文。

HELPSCOUT_ENABLE_WRITES 可选可选，设为 true 启用 write_help_scout 写工具（tier-1 操作）。

HELPSCOUT_ENABLE_CUSTOMER_VISIBLE_WRITES 可选可选，需与 HELPSCOUT_ENABLE_WRITES 同时开启，才启用 sendReply 和 publishDraft 等客户可见写操作。

CACHE_TTL_SECONDS 可选可选，API 响应缓存时长，默认 300。

LOG_LEVEL 可选可选，日志级别（error/warn/info/debug），默认 info。

HELPSCOUT_BASE_URL 可选可选，Help Scout API 端点，默认 https://api.helpscout.net/v2/。

HELPSCOUT_DOCS_BASE_URL 可选可选，Help Scout Docs API 端点，默认 https://docsapi.helpscout.net/v1/。

在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"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "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"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add helpscout -e HELPSCOUT_APP_ID=your-app-id -e HELPSCOUT_APP_SECRET=your-app-secret -e HELPSCOUT_DOCS_API_KEY=optional-docs-api-key -- npx [email protected]

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端工具列表中确认出现 search_help_scout、describe_help_scout、read_help_scout 三个工具；然后用 read_help_scout 执行 searchConversations，如能返回对话结果即说明连接成功。

常见排障

认证失败：用curl向api.helpscout.net/v2/oauth2/token验证凭据
搜索结果为空：searchConversations是唯一搜索工具，关键词用contentTerms/subjectTerms；核对服务器指令中的收件箱ID而非猜测；放宽搜索词或时间范围
工具未出现（Cowork）：更新桌面应用至最新版本并开启新会话
需要更多细节：以LOG_LEVEL=debug运行

试试这样问

连接成功后，可以直接对 AI 助手这样说：

显示本周活跃的支持工单
查找关于账单错误的对话
找到邮箱为 [email protected] 的客户
显示组织 456 的支持历史

工具能力 4

search_help_scout 只读

按意图查找Help Scout操作（如“客户会话历史”、“满意度报告”）。

describe_help_scout 只读

加载所选操作的完整输入schema。

read_help_scout 只读

执行一个读取操作，如getThreads、searchConversations、searchCustomersByEmail等。

write_help_scout 写入

可选的写入工具（需操作者启用），包含11个一级会话操作；客户可见操作（sendReply、publishDraft）需额外开关及确认参数。

使用场景

按关键词、状态、标签、邮箱域名或工单号搜索会话

按姓名或邮箱查找客户并查看联系渠道

查看组织的成员及其支持历史

拉取完整线程历史后再起草回复

搜索并检索Docs知识库文章

获取公司、渠道、生产力、满意度等报告与元数据

在多个收件箱中监控活动（可脱敏）

支持客户端

Claude Desktop

Claude Code

Cursor

VS Code

Windsurf

Continue

Goose

Claude Cowork

Codex

Gemini CLI

OpenCode

依据项目文档列出，未经本站实测。

详细介绍

一个用于Help Scout的MCP服务器，提供对收件箱、会话、客户、组织、线程和Docs知识库的全面读取能力（覆盖Mailbox与Docs API的55个操作），并支持默认关闭的可选写入操作（起草回复、内部备注、标签、状态、分配、延后等）。通过search/describe/read三个网关工具保持紧凑的工具面，支持消息内容脱敏与收件箱范围限制。使用Help Scout OAuth2 Client Credentials认证，MIT许可，可经npm（npx）、Docker或Claude Desktop扩展（.mcpb）安装。