helpdesk-mender-mcp

Helpdesk Mender MCP — 面向 AI Agent 的 Zendesk、Freshdesk 和 Help Scout 写入工具

免费的本地 MCP 服务，可在 Zendesk、Freshdesk 和 Help Scout 中创建工单、添加回复和备注，以及更改工单状态——三者使用统一的工具词汇，因此你无需手动编写三套不同的 helpdesk 集成。

如果你正在构建 AI 支持工作流，并且总要为 Zendesk 的 Basic/OAuth 身份验证、Freshdesk 的 API 密钥身份验证和 Help Scout 的 OAuth2 客户端凭据流程，反复重写相同的工单创建/回复逻辑，那么这款 MCP 服务正是为解决这个问题而打造的。

此工具解决的问题

Zendesk、Freshdesk 和 Help Scout 都提供了功能完善、支持写入的工单 API，但它们使用不同的身份验证方案、不同的字段名称，而且对“工单”本身的定义也各不相同（Help Scout 将其称为“对话”）。目前没有免费的开源工具能通过一套调用统一处理这三者。这就是这样一款工具。

工具

• create_ticket — 创建新的工单/对话。
• add_reply — 添加公开回复，客户可以看到。
• add_note — 添加私人备注，仅供内部查看（Freshdesk 和 Help Scout 支持；Zendesk 没有单独的备注接口——在该平台上直接使用 add_reply，并将评论设为非公开）。
• update_status — 更改工单/对话状态。
• list_tickets — 列出工单/对话。

设置

1. 安装 Node.js（v18+）：https://nodejs.org

2. 克隆并安装：

git clone https://github.com/headlessherm-creator/helpdesk-mender-mcp.git
cd helpdesk-mender-mcp
npm install

3. 获取所用平台的 API 凭据：

• Freshdesk： 在个人资料设置中获取 API 密钥。**重要提示：**Freshdesk 免费套餐的 API 速率限制为每分钟 0 次调用——使用 API 需要付费套餐（Growth 或更高）。参见 Freshdesk API 文档。
• Zendesk： 在 Admin Center → Apps and integrations → APIs → Zendesk API 下创建 API 令牌，或使用 OAuth。参见 Zendesk API 文档。
• Help Scout： 在 Your Profile → My Apps 下创建 OAuth2 应用，并使用 Client Credentials 流程。注意：Help Scout 的客户端凭据令牌会在 48 小时后过期，且没有刷新令牌——此服务会在缓存的令牌过期时自动重新请求新令牌，因此你无需自行处理。参见 Help Scout 身份验证文档。

4. 设置环境变量：

export FRESHDESK_DOMAIN=yourcompany
export FRESHDESK_API_KEY=your_api_key
export ZENDESK_SUBDOMAIN=yourcompany
export [email protected]
export ZENDESK_API_TOKEN=your_api_token
export HELPSCOUT_APP_ID=your_app_id
export HELPSCOUT_APP_SECRET=your_app_secret

你只需设置所用平台对应的变量。

5. 将 MCP 客户端指向此服务：

{
  "mcpServers": {
    "helpdesk-mender": {
      "command": "node",
      "args": ["/path/to/helpdesk-mender-mcp/src/index.js"],
      "env": {
        "FRESHDESK_DOMAIN": "yourcompany",
        "FRESHDESK_API_KEY": "your_api_key"
      }
    }
  }
}

常见客户端的设置文档：

• Claude Desktop：https://modelcontextprotocol.io/quickstart/user
• Cursor：https://docs.cursor.com/context/model-context-protocol
• Claude Code：https://docs.claude.com/en/docs/claude-code/mcp

安全说明

此服务会使用你提供的凭据，向 Zendesk、Freshdesk 和 Help Scout 的 API 发起真实网络请求——与完全本地的工具不同，你的数据会离开你的设备，直接发送到你正在使用的 helpdesk 服务商。此过程不涉及第三方、遥测或日志记录。

关键词

Zendesk MCP 服务、Freshdesk MCP 服务、Help Scout MCP 服务、helpdesk MCP 服务、支持工单自动化 MCP、客户支持 AI Agent、工单系统 MCP、Claude MCP 支持工具。

相关工具

秉持相同的本地优先理念，解决不同问题：

• polymath-megablaster-mcp — 确定性数学、日期、单位转换和网络功能
• json-mender-mcp — 修复格式错误的 JSON、验证 JSON Schema、测试正则表达式
• hiring-mender-mcp — BambooHR + Greenhouse ATS 写入工具，统一使用一套词汇

许可证

MIT