Zendesk MCP Server Kon

🚀 Zendesk MCP サーバー KON

このプロジェクトは reminia/zendesk-mcp-server をベースにしたフォークプロジェクトで、追加機能のサポートと改善が行われています。

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

Zendesk のモデルコンテキストプロトコルサーバーです。このサーバーは Zendesk との完全な統合を提供します。以下の機能を含みます。

• チケットとコメントの検索と管理ツール
• コミュニティ記事、コメント、トピックの管理ツール
• チケット分析と返信草案の専門的なヒント
• Zendesk ヘルプセンター記事の完全な知識ベースへのアクセス

🚀 クイックスタート

このサーバーは、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 資格情報に置き換えてください。

• 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