Zendesk MCP Server Kon

🚀 Zendesk MCP 服務器 KON

這是一個基於 reminia/zendesk-mcp-server 的分支項目，增加了對額外功能的支持和改進，是 Zendesk 的模型上下文協議服務器，可提供與 Zendesk 的全面集成。

](https://opensource.org/licenses/Apache-2.0)

🚀 快速開始

此服務器提供的集成功能包括：

• 工單和評論的檢索和管理工具
• 社區文章、評論和主題的管理工具
• 工單分析和回覆草擬的專業提示
• 對 Zendesk 幫助中心文章的知識庫完整訪問

📦 安裝指南

1. 安裝包

uv venv && uv pip install -e .

2. 在 Claude 桌面配置

{
  "mcpServers": {
    "zendesk": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/zendesk-mcp-server-kon",
        "run",
        "zendesk"
      ],
      "env": {
        "ZENDESK_SUBDOMAIN": "your-zendesk-subdomain",
        "ZENDESK_EMAIL": "your-zendesk-email",
        "ZENDESK_API_KEY": "your-zendesk-api-key"
      }
    }
  }
}

替換環境變量說明

• ZENDESK_SUBDOMAIN：您的 Zendesk 子域名（例如，如果您的 Zendesk URL 是 company.zendesk.com，則使用 company）
• ZENDESK_EMAIL：您的 Zendesk 管理員電子郵件地址
• ZENDESK_API_KEY：您的 Zendesk API 令牌

📚 詳細文檔

資源

• zendesk://knowledge-base，訪問整個幫助中心文章。

提示

analyze - ticket

分析一個 Zendesk 工單並提供詳細的工單分析。

draft - ticket - response

為一個 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）

社區管理

get_community_posts

通過篩選和排序檢索社區帖子

• 輸入：
  • filter_by (字符串，可選)：按狀態過濾帖子（planned, not_planned, completed, answered, none）
  • sort_by (字符串，可選)：按排序方式對帖子進行排序

get_community_post

通過其 ID 檢索社區文章

• 輸入：
  • id (整數)：要檢索的文章 ID

create_community_post

創建新的社區文章

• 輸入：
  • title (字符串)：文章標題
  • content (字符串)：文章內容
  • author_id (整數)：作者的用戶 ID
  • metadata (JSON 對象，可選)：文章元數據

update_community_post

更新社區文章

• 輸入：
  • id (整數)：要更新的文章 ID
  • title (字符串)：新標題
  • content (字符串)：新內容
  • metadata (JSON 對象，可選)：新的元數據

delete_community_post

刪除社區文章

• 輸入：
  • id (整數)：要刪除的文章 ID

評論管理

create_comment

創建評論

• 輸入：
  • parent_id (整數)：父元素的 ID（文章或評論）
  • content (字符串)：評論內容
  • author_id (整數)：作者的用戶 ID
  • metadata (JSON 對象，可選)：評論元數據

update_comment

更新評論

• 輸入：
  • id (整數)：要更新的評論 ID
  • content (字符串)：新內容
  • metadata (JSON 對象，可選)：新的元數據

delete_comment

刪除評論

• 輸入：
  • id (整數)：要刪除的評論 ID