Zendesk MCP Server

🚀 Zendesk MCP 服務器

這是一個與 Zendesk 全面集成的 Model Context Protocol 服務器，可用於檢索和管理 Zendesk 票件與評論，還能進行票件分析和響應草擬，並且可完全訪問 Zendesk 幫助中心文章知識庫。

🚀 快速開始

安裝與配置

1. 構建項目

可以使用以下命令構建項目：

uv venv && uv pip install -e .

也可以使用簡短命令：

uv build

2. 設置 Zendesk 憑據

在 .env 文件中設置 Zendesk 憑據，可參考 .env.example 。

3. Claude 桌面配置

在 Claude 桌面進行如下配置：

{
  "mcpServers": {
      "zendesk": {
          "command": "uv",
          "args": [
              "--directory",
              "/path/to/zendesk-mcp-server",
              "run",
              "zendesk"
          ]
      }
  }
}

✨ 主要特性

• 具備檢索和管理 Zendesk 票件及評論的工具。
• 提供特定於票件分析和響應草擬的提示。
• 可完全訪問整個 Zendesk 幫助中心文章知識庫。

📦 安裝指南

構建

• 完整命令：uv venv && uv pip install -e .
• 簡短命令：uv build

憑據設置

在 .env 文件中設置 Zendesk 憑據，參考 .env.example 。

桌面配置

在 Claude 桌面按如下 JSON 格式配置：

{
  "mcpServers": {
      "zendesk": {
          "command": "uv",
          "args": [
              "--directory",
              "/path/to/zendesk-mcp-server",
              "run",
              "zendesk"
          ]
      }
  }
}

💻 使用示例

資源訪問

可通過以下鏈接訪問整個幫助中心文章： zendesk://knowledge-base

提示使用

analyze-ticket

分析一個 Zendesk 票件並提供詳細的票件分析。

draft-ticket-respons

起草對一個 Zendesk 票件的響應。

工具使用

get_ticket

通過其 ID 檢索 Zendesk 票件。

• 輸入:
  • ticket_id (整數): 要檢索的票件 ID

get_ticket_comments

通過其 ID 檢索 Zendesk 票件的所有評論。

• 輸入:
  • ticket_id (整數): 要獲取評論的票件 ID

create_ticket_comment

在現有的 Zendesk 票件上創建新評論。

• 輸入:
  • ticket_id (整數): 要評論的票件 ID
  • comment (字符串): 評論文本/內容
  • public (布爾值，可選): 是否公開顯示評論（默認為 true）

📄 許可證

本項目採用 Apache 2.0 許可證。