Helpscout MCP Server


一 MCP服务器 这使AI助手可以直接访问您的Help Scout收件箱、对话、客户、组织和线程。无需离开编辑器或聊天窗口，即可搜索门票、提取客户和账户上下文、发现模式并获得答案。

由一位Help Scout客户创建，他希望为他的支持团队提供超能力。如果你在Help Scout中处理客户对话，并希望人工智能帮助你更快地工作，这是为你准备的。

你能做什么

• 搜索对话 按关键字、日期范围、状态、标签、电子邮件域或票号
• 查找客户 按名称、高级查询语法或确切的电子邮件地址
• 探索组织 通过直接客户和对话遍历
• 拉取完整的线程历史记录 在起草答复之前，先了解背景
• 获取对话摘要 包含原始客户信息和最新员工回复
• 监控收件箱活动 通过单个查询跨多个收件箱
• 保持合规 具有可选的PII编辑和范围收件箱访问

快速开始

克劳德·科沃克（推荐）

安装 helpscout领航员 插件。它自动启动MCP服务器，包括 导航技能 帮助Claude为您的查询选择合适的搜索工具。

1. 打开Cowork并转到 定制 > 浏览插件 > 个人
2. 点击 + > 从GitHub添加市场 并进入 drewburchfield/help-scout-mcp-server
3. 安装 helpscout领航员 来自市场
4. 添加您的Help Scout凭据(分步指南)

该插件在MCP服务器上捆绑了指导技能、会话挂钩和工具选择指南。其他安装方法为您提供工具；这也教会了人工智能如何很好地使用它们。

克劳德桌面

一键安装 使用 桌面扩展:

1. 下载最新 .mcpb 文件来自发布
2. 双击安装（或拖动到Claude Desktop）
3. 在提示时输入您的Help Scout应用程序ID和应用程序密码

克劳德代码

相同 helpscout领航员 该插件在Claude Code中工作，具有相同的导航技能。

1. 跑 /plugin 在克劳德代码中打开市场
2. 搜索 helpscout领航员 并安装它
3. 集 HELPSCOUT_APP_ID 和 HELPSCOUT_APP_SECRET 作为环境变量
4. 重新启动Claude代码

适用于游标、VS代码和其他MCP客户端

添加到MCP客户端的配置文件中（例如。， claude_desktop_config.json, .cursor/mcp.json):

{
  "mcpServers": {
    "helpscout": {
      "command": "npx",
      "args": ["help-scout-mcp-server"],
      "env": {
        "HELPSCOUT_APP_ID": "your-app-id",
        "HELPSCOUT_APP_SECRET": "your-app-secret"
      }
    }
  }
}

码头工人

docker run -e HELPSCOUT_APP_ID="your-app-id" \
  -e HELPSCOUT_APP_SECRET="your-app-secret" \
  drewburchfield/help-scout-mcp-server

获取API凭据

1. 首选 帮助童子军 > 我的应用 > 创建私人应用程序
2. 至少选择： 阅读 访问邮箱、对话、客户和组织
3. 复制您的 应用ID 和 应用程序密钥

Help Scout仅使用OAuth2客户端凭据流。不支持个人访问令牌。

替代名称 HELPSCOUT_CLIENT_ID / HELPSCOUT_CLIENT_SECRET 和遗产 HELPSCOUT_API_KEY 也得到了支持。

工具

我应该使用哪个工具？

服务器连接时会自动发现收件箱。AI代理会自动在指令中获取收件箱ID，因此不需要查找步骤。

配置

兼容性

适用于任何 MCP兼容 客户：

安全与隐私

与具有合规意识的团队一起构建：

• 可选的PII编辑。 默认情况下包含邮件正文。集 REDACT_MESSAGE_CONTENT=true 为了更严格的合规要求而隐藏它们。
• 客户和组织编辑。 启用邮件内容编辑时，客户联系人字段和组织联系人/位置字段也会被编辑。
• 安全身份验证。 OAuth2客户端凭据，具有自动令牌刷新功能。
• 费率限制处理。 对429个响应进行指数回退的自动重试。
• 范围访问。 可选的默认收件箱配置限制了AI可以搜索的内容。

故障排除

身份验证失败？ 直接使用Help Scout验证您的凭据是否有效：

curl -X POST https://api.helpscout.net/v2/oauth2/token \
  -d "grant_type=client_credentials&client_id=$HELPSCOUT_APP_ID&client_secret=$HELPSCOUT_APP_SECRET"

空搜索结果？ 常见原因：

• 使用错误的搜索工具（使用 searchConversations 为了上市， comprehensiveConversationSearch 用于关键字搜索）
• 收件箱ID不匹配。检查服务器指令中的ID，而不是猜测值。
• 搜索词太窄。尝试更广泛的术语或更长的时间范围。

需要更多细节吗？ 启用调试日志记录：

LOG_LEVEL=debug npx help-scout-mcp-server

发展

git clone https://github.com/drewburchfield/help-scout-mcp-server.git
cd help-scout-mcp-server
npm install && npm run build
npm start

npm test           # Run tests
npm run type-check # TypeScript validation
npm run lint       # Linting
npm run dev        # Development server with auto-reload

欢迎捐款。在提交PR之前，请确保测试、类型检查和测试通过。

支持

• 更新日志

许可证

MIT许可证-请参阅 许可证 了解详情。