Claude Media
Zendeskチケット分析 — ClaudeでAI下書き回答を作る

Zendeskチケット分析 — ClaudeでAI下書き回答を作る

ZendeskにClaudeの公式コネクタは無い。MCPサーバーreminia/zendesk-mcp-serverでチケット分析と返信下書きを実現する手順と限界を整理する。

ZendeskチケットをClaudeで分析・下書き回答する方法はあるか

結論から言うと、ZendeskにAnthropicの公式コネクタは存在しません。Claudeの一次統合はGoogle Drive・Gmail・Google Calendar・GitHub・Slack・Microsoft 365に限られ、Zendeskは含まれていません。Zendesk自身のAI機能(Zendesk AI Agents)もOpenAI・Microsoft Azure・Amazon Bedrock・Google Cloudのモデルを使う設計で、Anthropicは対応リストに入っていません。

それでも、ZendeskのチケットをClaudeに読ませて分析・下書き回答を作らせる方法は実在します。MCP(Model Context Protocol)経由のコミュニティ製サーバーを自分で追加するやり方です。本稿ではスター数が最も多いreminia/zendesk-mcp-server(GitHubスター114)を例に、できることとできないことを具体的に見ていきます。

reminia/zendesk-mcp-serverとは何か

reminia/zendesk-mcp-serverとは、ZendeskのチケットとコメントをClaudeから読み書きできるようにするMCPサーバーです。Apache License 2.0で公開され、Claude Desktop・Claude Codeの両方に対応します。

提供するツールは6つです。

ツール機能
get_tickets機能最新チケットをページネーション付きで取得
get_ticket機能ID指定でチケット詳細を取得
get_ticket_comments機能チケットの全コメント履歴を取得
create_ticket機能新規チケットを作成
create_ticket_comment機能チケットにコメントを追加(返信の投稿もここ)
update_ticket機能ステータス・優先度・担当者を更新

ツールに加えて、analyze-ticket(チケット詳細分析)とdraft-ticket-response(返信下書き作成)という2つの専用プロンプトが用意されています。単純なデータ取得ツールの寄せ集めではなく、「チケットを分析する」「返信を下書きする」というサポート担当者の作業単位に合わせてプロンプトが設計されている点が特徴です。汎用のMCPサーバーではなく、サポート業務のワークフローを想定して作られたツールだと分かります。

セットアップの3ステップ

ステップ1: Zendesk側でAPIトークンを発行する

ZendeskのAdmin Centerで「Apps and integrations > APIs > Zendesk API」を開き、トークンアクセスを有効化します。発行したトークンは1アカウントあたり最大256個まで保有できます。認証はBasic認証で、{メールアドレス}/token:{APIトークン}の形式をBase64エンコードしてAuthorizationヘッダーに載せます。

ステップ2: サーバーをセットアップする

リポジトリをクローンし、.envファイルに認証情報を設定します。.env.exampleが示す変数は次の3つです。

環境変数内容
ZENDESK_SUBDOMAIN内容Zendeskアカウントのサブドメイン
ZENDESK_EMAIL内容APIアクセス用のメールアドレス
ZENDESK_API_KEY内容ステップ1で発行したAPIトークン
git clone https://github.com/reminia/zendesk-mcp-server.git
cd zendesk-mcp-server
cp .env.example .env
# .envにZENDESK_SUBDOMAIN / ZENDESK_EMAIL / ZENDESK_API_KEYを書き込む
uv venv && uv pip install -e .

Dockerで動かす場合は、環境変数のみで完結する構成が用意されています。

docker build -t zendesk-mcp-server .
docker run --rm -i --env-file /path/to/.env zendesk-mcp-server

ステップ3: Claude側にMCPサーバーを登録する

Claude Desktopの場合、設定ファイルに以下を追加します。

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

Claude Codeの場合はclaude mcp addコマンドで登録します。

claude mcp add --transport stdio zendesk -- uv --directory /path/to/zendesk-mcp-server run zendesk

MCPサーバーの追加コマンドの構文・スコープ・認証まわりの詳細はClaude Code MCP設定ガイドで解説しています。設定を保存したら、Claude側で新規チャットを開き「未対応チケットを3件挙げて、優先度と対応方針を分析して」のように依頼すればget_ticketsanalyze-ticketが呼ばれます。

実際の分析・下書き回答ワークフロー

analyze-ticketプロンプトを使うと、Claudeは指定したチケットIDのコメント履歴をget_ticket_commentsで取得し、問い合わせの要点・感情トーン・過去の類似対応の有無を順に押さえます。続けてdraft-ticket-responseを呼べば、そのチケットの文脈を踏まえた返信文の下書きが生成されます。

ここで重要なのは、create_ticket_commentツールが実行されるまでは何も送信されない点です。下書きはチャット上のテキストとして返るだけで、実際にZendeskへ投稿するかどうかは人間が別途指示する必要があります。誤送信のリスクを抑える意味では、この2段階構成は理にかなっています。

現状のMCPサーバーでできないこと

reminia/zendesk-mcp-serverが公開しているツールは6つに限られます。README上で確認できる範囲では、次の機能は用意されていません。

  • 全文検索: get_ticketsは一覧取得のみで、キーワードや条件を指定した検索専用のツールはありません。特定の顧客名や商品名を含むチケットを横断的に探したい場合、まず一覧を取得してClaude側で絞り込む形になります
  • 添付ファイルの取り扱い: チケットに添付された画像・ファイルを直接読み込むツールはなく、テキストのコメント履歴が対象です
  • マクロ・トリガーの操作: Zendesk管理画面で設定するマクロや自動化トリガーを、MCP経由で参照・変更する手段はありません
  • 満足度評価(CSAT)の取得: クローズ済みチケットの満足度スコアを取得するツールも含まれていません

大量のチケットを横断的に分析したい場合や、添付ファイルの中身まで踏まえた判断が必要な場合は、現状のMCPサーバー単体では力不足です。個別チケットの深掘りと返信の下書き作成という、狙いを絞った用途で使うのが実態に合っています。

公式のZendesk AIとどう使い分けるか

Zendesk自体にもAIによる返信提案機能(Zendesk AI Agents)があります。両者は仕組みも守備範囲も異なるので、目的に応じて使い分けるのが現実的です。Zendesk AI AgentsはZendeskの管理画面内で完結する分、導入や運用の負担が小さいのが強みです。

用途Zendesk AI AgentsClaude + MCP
標準的な一次対応の自動化Zendesk AI Agents◎ Zendesk内で完結し運用が軽いClaude + MCP△ 都度チャットで依頼する手間がある
複雑な文脈を踏まえた下書きZendesk AI Agents△ プロンプト調整の自由度が低いClaude + MCP◎ Claudeの理解力で込み入った経緯も追える
他ツールの情報と横断分析Zendesk AI Agents△ Zendesk内のデータのみClaude + MCP◎ 同じチャットで他のMCP接続先とも突き合わせられる
導入の手軽さZendesk AI Agents◎ 管理画面から有効化するだけClaude + MCP△ サーバー構築とAPIトークン管理が要る

Zendesk AI Agentsは大量チケットの一次対応向け、Claude + MCPは個別の込み入った案件をエスカレーション前に深掘りする用途に向いています。両方を併用しているチームも珍しくありません。

よくあるつまずき

導入時に詰まりやすいポイントを4つ挙げます。

  • APIトークンのURLエンコード漏れ: メールアドレスに+や記号を含む場合、Basic認証の組み立てで文字化けしトークン認証が失敗することがあります。まずcurlで単体テストしてから接続するのが安全です
  • サブドメインの取り違え: ZENDESK_SUBDOMAINはフルURLではなくhttps://より前の部分だけを指定します。フルURLを入れると接続エラーになります
  • 権限不足によるツール失敗: APIトークンを発行したユーザーのZendesk上の権限(エージェント権限)が不足していると、update_ticketなど書き込み系ツールだけが失敗します。読み取り系は通るのに更新だけ失敗する場合はここを疑います
  • 下書きをそのまま送信してしまう: draft-ticket-responseの出力は下書きであり、顧客対応としてのトーン・事実確認は人間が最終チェックする前提です。とくに料金や契約に関わる回答は、そのままcreate_ticket_commentで投稿しない運用ルールを決めておくと安全です

よくある質問

Zendesk公式にClaude連携の予定はあるか

公式発表はありません。Zendesk AIは複数のLLMプロバイダーに対応する設計を明言していますが、対応表にAnthropicは含まれていないため、公式統合の有無は今後の発表を待つ必要があります。

複数のZendeskブランド(マルチブランド)に対応しているか

reminia/zendesk-mcp-serverの認証情報はサブドメイン単位です。複数ブランドを扱う場合は、ブランドごとに.envを分けて別々のMCPサーバーインスタンスを起動する構成になります。

大量のチケットを一度に処理させても大丈夫か

get_ticketsはページネーション対応ですが、Zendesk API自体にレート制限があります。短時間に大量のリクエストを送ると制限に引っかかる可能性があるため、数十件単位で区切って依頼し、様子を見ながら範囲を広げるのが安全です。バッチ処理を組みたい場合は、リクエスト間隔を空ける工夫も検討します。プランによって上限の水準が異なることもあるので、大量処理を常用する前に自組織の上限を確認しておくと安心です。

Zendesk以外のサポートツールでも同じことはできるか

同様の考え方でMCPサーバーが公開されているツールなら可能です。導入方法はツールごとに異なりますが、MCPサーバーをClaudeに登録する基本の流れは共通しています。全体像はClaude Connectorsとはで整理しています。

まとめ

ZendeskとClaudeの公式コネクタはまだ存在しません。それでも、reminia/zendesk-mcp-serverのようなコミュニティ製MCPサーバーを使えば、チケットの分析と返信下書きの生成は今日から実現できます。ポイントは3つです。①APIトークンはZendesk管理画面から発行し権限を確認する、②analyze-ticketdraft-ticket-responseの2段階構成で下書きは必ず人間が確認する、③大量の一次対応にはZendesk AI Agents、込み入った個別案件の深掘りにはClaude + MCPと使い分ける。サポート業務でメール下書きの自動化を検討しているなら、Claude Gmail連携の記事も合わせて参考になります。

この記事を共有:XはてブLinkedIn