Zendesk Help Center MCP Server

Zendesk 帮助中心 MCP 服务

一个对接 Zendesk Help Center API 的模型上下文协议（MCP）服务，可与 Claude Desktop 和其他兼容 MCP 的客户端集成。

功能

• 文章搜索：在 Zendesk Help Center 中搜索文章
• 文章详情：按 ID 获取特定文章的详细信息

前提条件

• Node.js（v18 或更高版本）
• 拥有 API 访问权限的 Zendesk 账户
• Zendesk API 令牌

安装

1. 克隆此代码仓库：

   git clone https://github.com/yourusername/zendesk-help-center-mcp-server.git
   cd zendesk-help-center-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 在根目录中创建 .env 文件，并填写你的 Zendesk 凭据：

   ZENDESK_SUBDOMAIN=your-subdomain
   [email protected]
   ZENDESK_API_TOKEN=your-api-token
   

   你可以复制 .env.example 文件并填写相关信息：

   cp .env.example .env
   

构建和运行

1. 构建项目：

   npm run build
   

2. 启动服务：

   npm start
   

服务将通过标准输入/输出运行，因此兼容 Claude Desktop 和其他 MCP 客户端。

可用工具

此服务提供以下工具：

1. searchArticles

在 Zendesk Help Center 中搜索文章。

参数：

• query（字符串，必填）：搜索关键词
• locale（字符串，可选）：区域设置代码（例如，'en'、'ja'、'en-us'）
• page（数字，可选）：页码
• per_page（数字，可选）：每页结果数（最多 100 条）

2. getArticle

按 ID 获取特定 Zendesk Help Center 文章的详情。

参数：

• id（数字，必填）：文章 ID
• locale（字符串，可选）：区域设置代码（例如，'en'、'ja'、'en-us'）

与 Claude Desktop 搭配使用

添加到 Claude 的 mcpServers 配置

将以下配置添加到 Claude 设置文件中的 mcpServers 部分：

{
  "mcpServers": {
    "zendeskHelpCenter": {
      "command": "npx",
      "args": ["-y", "github:hidechae/zendesk-help-center-mcp-server"],
      "env": {
        "ZENDESK_SUBDOMAIN": "your-subdomain",
        "ZENDESK_EMAIL": "[email protected]",
        "ZENDESK_API_TOKEN": "your-api-token"
      }
    }
  }
}

添加此配置后，你就可以在 Claude 中使用 Zendesk Help Center 工具。

开发

此项目使用 TypeScript，并遵循模型上下文协议规范。

在开发模式下运行并启用自动重载：

npm run dev

许可证

MIT

贡献

欢迎贡献！请随时提交 Pull Request。