Zendesk MCP

Name: Zendesk MCP
Author: markusvankempen

ローカル

github.comビジネス・マーケティング020 週間前に更新

リポジトリ公式サイト

Zendesk MCP について

Zendesk MCP は、Zendesk を使う AI エージェントやサポートチーム向けに、14 種類のチケット操作を提供します。TypeScript と Python の実装があり、チケット作成時に実際の顧客を依頼者に設定して返信を正しく届けます。

主な機能

01チケットの作成・更新・検索
02チケットの割り当て・解決・再開
03コメントの閲覧と追加
04ユーザーとチケット指標の検索
05TypeScript と Python のサーバー実装

活用シーン

01顧客を依頼者としてチケットを作成
02チケットの仕分けと担当者・グループへの割り当て
03会話、SLA 時間、最近のチケットの確認
04顧客への返信や内部メモの追加

MCP 対応

MCP サーバーとして、作成、検索、割り当て、コメント、指標確認など14種類の Zendesk チケット操作を公開します。ローカルの stdio とリモートの SSE によるデプロイに対応します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "markusvankempen-zendesk": {
      "command": "npx",
      "args": [
        "-y",
        "@markusvankempen/zendesk-mcp-server"
      ],
      "env": {
        "ZENDESK_SUBDOMAIN": "<ZENDESK_SUBDOMAIN>",
        "ZENDESK_EMAIL": "<ZENDESK_EMAIL>",
        "ZENDESK_API_TOKEN": "<ZENDESK_API_TOKEN>"
      }
    }
  }
}

起動コマンドnpx -y @markusvankempen/zendesk-mcp-server

設定が必要な環境変数

ZENDESK_SUBDOMAINYour Zendesk subdomain (e.g. mycompany for mycompany.zendesk.com)

ZENDESK_EMAILZendesk service account email address used for API authentication

ZENDESK_API_TOKENシークレットZendesk API token (Admin → Apps and integrations → APIs → Token access)

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@markusvankempen/zendesk-mcp-server1.0.2stdio

ツール

掲載時のツール一覧 · 3 週間前に更新

パラメーター	型	必須	説明
tags	string	いいえ
subject	string	はい
priority	enum	いいえ	urgent \| high \| normal \| low
description	string	はい
requester_name	string	いいえ
requester_email	string	はい

詳細

Zendesk MCP

Zendesk Support 向けの Model Context Protocol（MCP）サーバー — Cursor、VS Code、Claude Desktop、watsonx Orchestrate、IBM Code Engine の AI エージェントを、14 種類のチケットツール（作成、検索、割り当て、クローズ、コメント、メトリクス）に接続します。インストール：npx @markusvankempen/zendesk-mcp-server · pip install zendesk-mcp-server-py

zendesk · mcp · cursor · github-copilot · claude · ai-agents · customer-support · helpdesk · watsonx-orchestrate · typescript · python

Model Context Protocol（MCP）を介して AI エージェントを Zendesk に接続する汎用インテグレーションです。TypeScript と Python によるサーバー実装に加え、IDE、IBM Code Engine、watsonx Orchestrate 向けのデプロイ例を提供します。

作者： Markus van Kempen
メール： [email protected] · [email protected]
ウェブサイト： markusvankempen.github.io
小さなバグも、奇妙な構文も見逃しません。

概要

Zendesk MCP は、14 種類のサポートチケット操作を MCP ツールとして公開しているため、Cursor、VS Code、Claude Desktop、watsonx Orchestrate、IBM Code Engine の AI エージェントが自然言語でチケットを管理できます。

コア設計では、リクエスターの帰属先の問題を解決します。チケットは（API サービスアカウントではなく）実際の顧客をリクエスターとして作成されるため、Zendesk のメール返信が正しく送信されます。

graph TB
    subgraph clients [MCP Clients]
        Cursor[Cursor / VS Code]
        WxO[watsonx Orchestrate]
        CE[Code Engine / Remote]
    end

    subgraph servers [Servers]
        TS["TypeScript npm"]
        PY["Python FastMCP"]
    end

    ZD[Zendesk REST API v2]

    Cursor -->|stdio| TS
    WxO -->|stdio| PY
    CE -->|SSE| TS
    CE -->|SSE| PY
    TS --> ZD
    PY --> ZD

📖 ドキュメントハブ → docs/ · MCP 設定例 → examples/mcp/ · パブリックリポジトリとプライベートリポジトリ → docs/PUBLIC_REPO.md · コントリビューション → CONTRIBUTING.md · セキュリティ → docs/SECURITY.md

ドキュメント一覧

このリポジトリにあるすべての Markdown ファイルの完全な一覧です。

ルート

ドキュメント	説明
README.md	プロジェクト概要、クイックスタート、デプロイの概要（このファイル）
task.md	プロジェクトの当初の要件と参考メモ

コアドキュメント（`docs/`）

ドキュメント	説明
docs/README.md	ドキュメントハブ — まずはこちらをご覧ください
docs/ide/README.md	IDE のセットアップ — ローカルの `npx` とリモートの Code Engine
docs/reference/ARCHITECTURE.md	システム設計、stdio/SSE/WxO のトポロジー、認証フロー
docs/reference/TOOLS.md	14 種類すべての MCP ツール — パラメーター、戻り値、使用例
docs/guides/SCENARIOS.md	リクエスターのモード、ロールエージェント、17 のシナリオ、E2E
docs/reference/FILES.md	ファイルの完全な一覧
docs/deployments/README.md	デプロイメントドキュメントの一覧

パッケージの README（`packages/`）

ドキュメント	説明
packages/zendesk-mcp-server/README.md	TypeScript/npm サーバー — インストール、環境変数、SSE モード、ソースからのビルド
packages/zendesk-mcp-server-py/README.md	Python FastMCP サーバー — セットアップ、SSE モード、WxO インポートの案内

デプロイメントの README（`deployments/`）

ドキュメント	説明
deployments/vscode-extension/README.md	VS Code / Cursor / Open VSX 拡張機能 — コマンド、設定、公開
deployments/code-engine/README.md	IBM Code Engine — Dockerfile、SSE エンドポイント、リモート MCP クライアント設定
deployments/code-engine/DEPLOYMENT-GUIDE.md	Code Engine — ライブデプロイ、テスト／管理 UI、ローカルとデプロイ済みの `mcp.json`
deployments/watsonx-orchestrate/README.md	WxO ツールキットのデプロイ、4 種類のロールエージェント、シナリオランナー、CLI テストコマンド

トピック別クイックナビゲーション

トピック	こちらから
IDE のセットアップ（ローカル `npx`）	docs/ide/README-local.md
IDE のセットアップ（Code Engine）	docs/ide/README-remote.md
アーキテクチャとトランスポート	docs/reference/ARCHITECTURE.md
ツールのパラメーターと例	docs/reference/TOOLS.md
WxO エージェントとテストシナリオ	docs/guides/SCENARIOS.md
すべてのファイルの説明	docs/reference/FILES.md
npm / TypeScript サーバー	packages/zendesk-mcp-server/README.md
Python / FastMCP サーバー	packages/zendesk-mcp-server-py/README.md
IDE 拡張機能のセットアップ	deployments/vscode-extension/README.md
Code Engine へのデプロイ	deployments/code-engine/README.md
WxO のデプロイと E2E	deployments/watsonx-orchestrate/README.md

リポジトリの構成

zendesk-mcp/
├── docs/                         # Documentation hub
│   ├── README.md                 # Start here
│   ├── ide/                      # IDE setup guides (local + remote)
│   ├── reference/                # ARCHITECTURE, TOOLS, FILES
│   ├── guides/                   # SCENARIOS
│   └── deployments/              # Deployment index
├── packages/
│   ├── zendesk-mcp-server/       # TypeScript MCP server (npm)
│   └── zendesk-mcp-server-py/    # Python MCP server (FastMCP)
├── deployments/
│   ├── vscode-extension/         # VS Code / Cursor / Open VSX extension
│   ├── code-engine/              # IBM Code Engine (SSE) + mcp-client JSON
│   └── watsonx-orchestrate/      # WxO toolkit + 4 role agents
└── .github/workflows/            # CI + npm/marketplace publish

クイックスタート（TypeScript / npm）

export ZENDESK_SUBDOMAIN=your-subdomain
export [email protected]
export ZENDESK_API_TOKEN=your_token

npx @markusvankempen/zendesk-mcp-server

ワンクリックインストール： Cursor · VS Code — その後、MCP の設定で ZENDESK_* の認証情報を設定してください。

コピー＆ペーストでセットアップ： Bob · Antigravity（インストール用ディープリンクはまだありません。examples/mcp/ を使用してください）：

IDE の設定に追加します — examples/mcp/ からコピーしてください：

IDE	ファイル
Cursor	examples/mcp/cursor-local.json → `~/.cursor/mcp.json`
VS Code	examples/mcp/vscode-local.json → `User/mcp.json`
Bob	examples/mcp/bob-local.json
Antigravity	examples/mcp/antigravity-local.json
Claude Desktop	examples/mcp/claude-desktop-local.json

または、VS Code 拡張機能を使用してください。API トークンを OS のキーチェーンに保存し、MCP の設定を自動で書き込みます。詳しくは deployments/vscode-extension/README.md をご覧ください。

GitHub にプッシュする前に、npm run check:secrets を実行してください。詳しくは docs/SECURITY.md をご覧ください。

クイックスタート（Python）

pip install zendesk-mcp-server-py

export ZENDESK_SUBDOMAIN=your-subdomain
export [email protected]
export ZENDESK_API_TOKEN=your_token

zendesk-mcp-server-py

MCP ツール（14）

ツール	説明
`create_ticket`	適切なリクエスター情報を付けてチケットを作成
`get_ticket`	IDでチケットを取得
`update_ticket`	ステータス、優先度、タグ、またはコメントを更新
`search_tickets`	Zendesk 検索クエリー構文
`list_recent_tickets`	最近更新されたチケット
`list_all_tickets`	管理者向けの全チケット一覧
`list_tickets_for_requester`	リクエスターのメールアドレスに紐づくチケット
`get_ticket_comments`	チケットの会話を読む
`add_ticket_comment`	公開返信または内部メモを追加
`get_user_by_email`	Zendesk ユーザーを検索
`close_ticket`	チケットを解決済みにする
`reopen_ticket`	解決済み／クローズ済みのチケットを再開
`get_ticket_metrics`	SLA／所要時間の指標
`assign_ticket`	グループまたはエージェントに割り当て

→ パラメーターと例を含むツールの完全なリファレンス

デプロイ

シナリオ	ディレクトリ	トランスポート	ドキュメント
VS Code / Cursor / Open VSX	`deployments/vscode-extension/`	`npx` 経由の stdio	README
IBM Code Engine	`deployments/code-engine/`	SSE	README
watsonx Orchestrate	`deployments/watsonx-orchestrate/`	stdio サブプロセス	README · シナリオ

watsonx Orchestrate — ロール別エージェント

エージェント	ロール
`zendesk_end_user_agent`	セルフサービス — 自分のチケットの作成／一覧表示／コメント
`zendesk_support_agent`	アナリスト — トリアージ、調査、指標、割り当て
`zendesk_admin_agent`	管理者 — キューの概要、SLA、割り当て
`zendesk_mcp_agent`	ジェネラリスト — すべてのツール、プロトタイピング

cd deployments/watsonx-orchestrate
./deploy_and_test.sh                              # full deploy + E2E
RUN_LIVE=1 ./run_agent_scenarios.sh               # 17 role scenarios

リクエスター情報の付与（重要な設計）

sequenceDiagram
    autonumber
    actor User
    participant WxO as WxO Agent
    participant MCP as MCP Server
    participant ZD as Zendesk

    User->>WxO: "Create a ticket — account locked"
    Note over WxO: wxo_email_id available
    WxO->>MCP: create_ticket(requester_email=wxo_email_id)
    MCP->>ZD: Find/create user + create ticket
    ZD-->>MCP: ticket_id=42, requester=real customer
    MCP-->>WxO: JSON result
    WxO-->>User: "Ticket #42 created"

接続資格情報（ZENDESK_*）は API の認証に使用します。ユーザー ID（wxo_email_id）はエージェントによってツールの引数に割り当てられます。MCP サーバーが WxO のセッションコンテキストを直接参照することはありません。

→ シナリオの完全なドキュメント

開発

npm install
npm run build          # TypeScript server + VS Code extension
npm run build:server   # TypeScript server only
npm run build:extension

認証情報

.env ファイルや API トークンをコミットしないでください。

デプロイ先	シークレットの保存場所
IDE 拡張機能	VS Code `SecretStorage`（OS のキーチェーン）
Code Engine	`ibmcloud ce` のシークレット／環境変数
WxO	`orchestrate connections set-credentials`
ローカル開発	`packages/zendesk-mcp-server-py/.env`

変数	用途
`ZENDESK_SUBDOMAIN`	テナントのプレフィックス（`mycompany` → `mycompany.zendesk.com`）
`ZENDESK_EMAIL`	API 認証に使うサービスアカウントのメールアドレス
`ZENDESK_API_TOKEN`	Zendesk API トークン

リファレンス実装

WxO-ToolBox/vsc/test_tools/zendesk_mcp_server から抽出し、汎用化しました。由来の対応関係については、docs/reference/FILES.md を参照してください。

→ すべてのドキュメント · task.md（元の要件）

コントリビューション

CONTRIBUTING.md と CODE_OF_CONDUCT.md を参照してください。

トピックとキーワード

zendesk · zendesk-api · zendesk-mcp · zendesk-support · zendesk-tickets · mcp · mcp-server · model-context-protocol · cursor · claude · claude-desktop · github-copilot · vscode · vscode-extension · open-vsx · ai-agent · ai-agents · tool-calling · function-calling · llm-tools · customer-support · customer-service · helpdesk · help-desk · service-desk · support-tickets · ticketing · crm · watsonx · watsonx-orchestrate · ibm-cloud · ibm-code-engine · typescript · python · fastmcp · stdio · sse · npx · npm-package · automation

公開配布用リポジトリ — サーバーのソースは含まれていません。npx -y @markusvankempen/zendesk-mcp-server または pip install zendesk-mcp-server-py でインストールしてください。プライベートな開発ワークフローについては、docs/PUBLIC_REPO.md をご覧ください。

Markdown 対応

ログインしてコメント

基本情報

作者: markusvankempen
言語: node
バージョン: 1.0.2
トランスポート: stdio
掲載日: 2026年6月10日
最終更新: 20 週間前
公式 Registry: io.github.markusvankempen/zendesk-mcp

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

Zendesk MCP

Zendesk MCP について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

Zendesk MCP

概要

ドキュメント一覧

ルート

コアドキュメント（docs/）

パッケージの README（packages/）

デプロイメントの README（deployments/）

トピック別クイックナビゲーション

リポジトリの構成

クイックスタート（TypeScript / npm）

クイックスタート（Python）

MCP ツール（14）

デプロイ

watsonx Orchestrate — ロール別エージェント

リクエスター情報の付与（重要な設計）

開発

認証情報

リファレンス実装

コントリビューション

ライセンス

リンク

作者のその他のプロジェクト

トピックとキーワード

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？

コアドキュメント（`docs/`）

パッケージの README（`packages/`）

デプロイメントの README（`deployments/`）