Zendesk MCP Server KON について
Zendesk MCP Server KONは、ZendeskをMCP対応AIアプリに接続し、チケット、ヘルプ記事、コミュニティの投稿を検索・要約します。OAuthログイン後はチケット編集やコミュニティ投稿も可能で、コミュニティへの書き込みにはプレビューとローカルでの一度限りの承認が必要です。
主な機能
- 01チケット・ヘルプ記事・投稿の検索
- 02チケットの要約と返信案の作成
- 03OAuthログイン後のチケット更新
- 04コミュニティ投稿とコメントの作成
- 05コミュニティ書き込み前のプレビューとローカル承認
活用シーン
- 01未解決の最近のチケットの検索
- 02チケットの要約と返信案の作成
- 03返金に関するヘルプ記事の検索
- 04コミュニティ投稿やコメントの作成
MCP 対応
ZendeskをMCP対応AIアプリに接続し、コンテンツの検索・読み取りと、制御された書き込み機能を提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Zendesk MCP
Codex などの AI アプリを Zendesk に接続して、チケット、ヘルプ記事、コミュニティでのディスカッションを検索・要約できます。
- 「最近の未解決チケットを探してください。」
- 「このチケットを要約して、返信の下書きを作成してください。」
- 「返金に関するヘルプ記事を探してください。」
新規インストールでは、OAuth ログイン後にチケットの更新や、コミュニティへの投稿・コメントの作成ができます。コミュニティへの書き込みには必ずプレビューとその都度のローカル承認が必要です。破壊的な操作、なりすまし、外部アップロードの操作は、デフォルトで無効になっています。
始める前に
- Zendesk アカウントと、MCP に対応した AI アプリが必要です。このガイドでは Codex を使用します。
- Git と uv をインストールします。uv がこのツールを実行します。
- コマンドは AI チャットではなく、お使いのコンピューターのターミナルで実行してください。macOS の場合は、ターミナルを開きます。
- 管理者に Zendesk のサブドメインと OAuth クライアント識別子を確認してください。
以下のブラウザーログインは macOS と Linux に対応しています。 Windows では、API トークンによるセットアップを使用してください。
クイックインストール
この方法では、テスト済みのソースリビジョンを直接使用します。リポジトリのクローンや、永続的な zendesk コマンドのインストールは行いません。コミット SHA によってサーバーのソースが固定されます。更新するには、レビュー済みの新しい SHA に置き換えてください。
1. Zendesk にログインする
2 つのサンプル値を管理者から受け取った値に置き換えてください。
your-company：your-company.zendesk.comの場合は、完全なアドレスやカスタムのヘルプセンタードメインではなく、your-companyのみを使用します。your-client-id：OAuth クライアント識別子です。メールアドレスや API トークンではありません。
uvx --from 'git+https://github.com/nicekon/zendesk-mcp-server-kon.git@457e674525a1e6bf40ef699b1cc433bfed3ea800' zendesk login --subdomain your-company --client-id your-client-id
開いたブラウザーでサインインし、アクセスを許可します。コードをコピーしたり、別のサーバーを起動したりする必要はありません。 接続情報はお使いのコンピューターに保存されるため、毎回ログインする必要はありません。
管理者向け：初回接続を準備する
Zendesk で パブリック OAuth クライアントを作成し、次の正確なリダイレクトアドレスを登録します。
http://127.0.0.1:3000/oauth/callback
クライアントシークレットではなく、サブドメインとクライアント識別子をユーザーに共有してください。
デフォルトのログインでは、検索に必要な読み取りアクセスに加え、デフォルトのチケット機能とコミュニティ機能に必要な tickets:write と hc:write が要求されます。検索に必要な read 権限では、ユーザーのロールで許可されている他のデータの読み取りも可能です。
追加の設定については、詳細セットアップを参照してください。
2. 接続を確認する
uvx --from 'git+https://github.com/nicekon/zendesk-mcp-server-kon.git@457e674525a1e6bf40ef699b1cc433bfed3ea800' zendesk check --probe
結果に "ok": true、"configured": true、"verified_user" があることを確認してください。
エラーについては、以下の表を参照してください。トークンやパスワードをチャットに貼り付けないでください。
3. Codex に接続する
codex mcp add zendesk_mcp -- uvx --from 'git+https://github.com/nicekon/zendesk-mcp-server-kon.git@457e674525a1e6bf40ef699b1cc433bfed3ea800' zendesk
codex mcp list
zendesk_mcp が表示されれば、登録されています。Codex を再度開き、新しい会話で「Zendesk 接続を確認して」と尋ねてください。
登録コマンドが使用できない場合や、別のアプリを使用する場合は、アプリの接続設定を参照してください。
代替手段：ソースからインストールする
開発やローカルでの変更のためにローカルチェックアウトが必要な場合にのみ使用してください。
git clone https://github.com/nicekon/zendesk-mcp-server-kon.git
cd zendesk-mcp-server-kon
uv tool install .
ソースからインストールした場合は、上記の uvx --from ... zendesk コマンドの代わりに zendesk を使用してください。zendesk が見つからない場合は、uv tool update-shell を実行して、新しいターミナルを開いてください。
トラブルシューティング
| 問題 | 確認すること |
|---|---|
uvx が見つからない | uv をインストールしてから、新しいターミナルを開いてください。 |
ソースからインストールした後に zendesk が見つからない | uv tool update-shell を実行してから、新しいターミナルを開いてください。 |
| ログインが完了しない | ブラウザーの同意ページを確認してください。タイムアウトした場合は、もう一度ログインしてください。 |
401 または authentication_failed | もう一度ログインしてください。API トークンの場合は、サブドメイン、メールアドレス、トークンを確認してください。 |
403 または permission_denied | 管理者に、その機能へのアクセス権を確認してもらってください。 |
not_configured または unsupported | 追加の設定、または別の Zendesk プランが必要な場合があります。 |
| 編集がブロックされる | ZENDESK_WRITE_MODE=read_only が設定されていないか確認してください。ZENDESK_ENABLE_PUBLIC_WRITES=false を設定すると、コミュニティの投稿とコメントはブロックされますが、通常のチケット編集はブロックされません。 |
oauth_relogin_required | この OAuth 接続は、現在有効な機能で必要とされるスコープを含めずに作成されています。同じ機能設定で zendesk login を再度実行してください。トークンが自動的に変更されることはありません。 |
一部の機能には追加の設定が必要です。利用可否は、Zendesk のプランとユーザー権限によって異なります。 画像アップロードについては、実際のアカウントで発生する権限の問題がまだ解決されていません。
詳細情報
ライセンス：Apache-2.0
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。