Zendesk Help Center MCP Server

Zendesk Help Center MCP Server

site icon
2025.04.17 1
TypeScript客户支持知识库管理交流协作
Zendesk Help Center MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,用于与 Zendesk Help Center API 进行交互,实现与 Claude Desktop 及其他 MCP 兼容客户端的集成。该服务主要用于搜索和获取 Zendesk 帮助中心中的文章信息。
View on GitHub

Overview

基本能力

产品定位

Zendesk Help Center MCP Server 是一个用于与 Zendesk 帮助中心 API 交互的中间件服务,旨在为 MCP 兼容客户端(如 Claude Desktop)提供 Zendesk 帮助中心内容的访问能力。

核心功能

  • 文章搜索:在 Zendesk 帮助中心中搜索文章
  • 文章详情:通过文章 ID 获取特定文章的详细信息

适用场景

  • 在 Claude Desktop 或其他 MCP 客户端中集成 Zendesk 帮助中心内容
  • 需要程序化访问 Zendesk 帮助中心文章的应用程序
  • 构建自定义的客户支持界面或知识库系统

工具列表

  1. searchArticles
  2. 功能:在 Zendesk 帮助中心中搜索文章
  3. 参数:

    • query (必填):搜索关键词
    • locale (可选):语言代码
    • page (可选):页码
    • per_page (可选):每页结果数(最大100)
  4. getArticle

  5. 功能:通过 ID 获取特定文章的详细信息
  6. 参数:
    • id (必填):文章 ID
    • locale (可选):语言代码

常见问题解答

  • 需要 Node.js v18 或更高版本
  • 需要有效的 Zendesk 账户和 API 访问权限
  • 需要在 .env 文件中配置正确的 Zendesk 凭证

使用教程

使用依赖

  1. 安装 Node.js (v18 或更高版本)
  2. 准备有效的 Zendesk 账户和 API token

安装教程

  1. 克隆仓库: bash git clone https://github.com/yourusername/zendesk-help-center-mcp-server.git cd zendesk-help-center-mcp-server

  2. 安装依赖: bash npm install

  3. 创建 .env 文件并配置 Zendesk 凭证: bash cp .env.example .env 然后在 .env 文件中填写: ZENDESK_SUBDOMAIN=your-subdomain [email protected] ZENDESK_API_TOKEN=your-api-token

调试方式

  1. 构建项目: bash npm run build

  2. 启动服务器: bash npm start

  3. 开发模式(自动重载): bash npm run dev

许可证

该项目遵循 MIT 开源许可条款。