Zammad MCP

Zammad + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP に対応するあらゆるエージェント向け

非公式です。Zammad API 向けの、コミュニティが開発した Claude Code Skill および MCP サーバーです。Zammad GmbH との提携関係はなく、同社による承認や後援も受けていません。

_{スキルの全ページ - インストール方法、得られる成果、安全モデル。}

すべての Zammad チケット、記事、ナレッジベース操作をひとつの CLI と MCP サーバーにまとめています。さらに、チーム管理レイヤー（エージェントの負荷、顧客の健全性、滞留しているバックログ、エスカレーションのトリアージ、解約リスク、フィードバック分析）も備えており、Zammad API では 1 回の呼び出しで取得できない情報にも対応します。すでにお使いの AI で利用できます。ChatGPT（Plus/Pro+。このコネクターの再公開まで一時停止中です。詳しくは mcp-install.md を参照）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilotに加え、リモート経由でMicrosoft 365 Copilot / Copilot StudioおよびGoogle Geminiにも対応します。無料のオープンソースで、ノート PC 上で動作します。MSP のオーナー向けに開発されています。コードは不要です。

お使いのエージェントで利用できます

セキュリティに関する注意（このコネクターが再公開されるまで）。 HTTP モード （--transport http）は、localhost 上であっても実行しないでください。このビルドではトークンを確認しますが、 修正版リリースで追加されたリクエストサイズと時間の制限には対応していません。MCP ツールは、 お客様の認証情報を使って変更を加えることもできます。デフォルトの stdio トランスポートを使用してください。 リモートエージェント用にトンネルを設定している場合は、停止してください。修正版は近日公開予定です。

MSP オーナーが実際に使用している 6 つのエージェント（セルフサービスで、現在利用可能）：

お使いの AI エージェント	Zammad スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions で zammad-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	このコネクターの再公開まで一時停止中です。ChatGPT には HTTP モードが必要ですが、このビルドではトークンを確認する一方、リクエストサイズと時間の制限がまだありません。mcp-install.md のセキュリティに関する注意を参照してください。
Codex CLI	以下のインストール用プロンプトを貼り付けます。
Claude Code	以下のインストール用プロンプトを貼り付けます。
Claude Cowork	以下のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、servers キーの下にある mcp.json に zammad-mcp を追加してから、Agent モードを選択します。

ChatGPT にはリモート HTTPS サーバーが必要です。そのため、このコネクターの HTTP モードが必要になりますが、コネクターが再公開されるまで一時停止中です。このビルドではトークンを確認する一方、リクエストサイズと時間の制限がまだありません。mcp-install.md のセキュリティに関する注意を参照してください。

Microsoft と Google のスタックにも対応

多くの環境に導入されていますが、正直にお伝えすると、こちらはリモート／エンタープライズ向けの方法であり、先ほどインストールしたローカルバイナリを使うものではありません。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	このコネクターが再公開されるまで一時停止中です。Copilot Studio では HTTP モードが必要ですが、このビルドの同モードはトークンを確認する一方で、リクエストサイズや実行時間の制限がまだありません。mcp-install.md のセキュリティに関する注意をご覧ください。
Google Gemini	Gemini CLI はローカルで動作し、Claude Code と同様です。Gemini アプリはリモートで動作し、ChatGPT と同じく一時停止中の HTTP モードが必要です。mcp-install.md をご覧ください。

スキルネイティブのエージェントにも対応しています： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み込み、MCP にも対応しています。インストール方法については、以下の各セクションをご覧ください。Cursor、Windsurf、Cline、Continue.dev、Zed でも MCP 経由で動作します。各ツールの詳しい接続方法については、docs/which-agent.md をご覧ください。

複数のエージェントを使っていますか？ 1つのコマンドで、サポート対象の51以上のエージェントすべてにインストールできます：npx skills add Servosity/msp-skills@latest（Node.js が必要です。その後、CLI／MCP バイナリ用のスキル別インストーラーを実行してください）。docs/which-agent.md をご覧ください。

60秒でインストール

Claude Desktop で最速の方法 - ワンクリック .mcpb

Claude Desktop バンドル： .mcpb は macOS（Intel と Apple Silicon）、Windows x64、Linux x64 で起動します。すべてのツールは、付属の zammad-cli をシェル経由で実行します。2026-09-18以降に公開されたリリースでは、この CLI がバンドルに含まれています。それ以前のバンドルには MCP サーバーのみが含まれているため、付属の CLI がない場合は、先に以下のインストーラーで Path A または Path B を実行するか、既存のバイナリを ZAMMAD_CLI_PATH に設定してください。詳細： #331。

Zammad MCP（.mcpb）をダウンロード - 次に Claude Desktop > Settings > Extensions を開き、ファイルを選択します。ワンクリックで完了し、JSON もシェルも不要です。（リリースページですべての Zammad リリースを確認できます。）

Claude Code プラグインを使いたい場合は、マーケットプレイスを一度追加してからインストールしてください。ディレクトリの一覧表示は不要で、すぐに使えます：

/plugin marketplace add Servosity/msp-skills
/plugin install zammad@msp-skills

Path A - AI エージェントにプロンプトを1つ貼り付ける（推奨）

これを Claude Code、Codex CLI、または Claude Cowork にコピーしてください：

このエージェントのワークスペースに、Servosity/msp-skills から Zammad スキルと MCP サーバーをインストールしてください。このワークスペースが POSIX シェル（macOS、Linux、WSL、または Bash）を使う場合は、bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/zammad/install.sh) を実行してください。Windows PowerShell を使う場合は、iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/zammad/install.ps1 | iex を実行してください。その後、README に従って認証し、zammad-cli --help を実行して機能を確認してください。

シェルを実行できるエージェントであれば、同じプロンプトを使えます。

Path B - インストーラーを自分で実行する

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/zammad/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/zammad/install.sh)

インストーラーは zammad-cli（CLI）と zammad-mcp（MCP サーバー）の両方を、ユーザーの bin パスに配置します。Claude Code、Codex、Cowork は、このディレクトリ内の SKILL.md を使ってスキルを検出します。

確認：

zammad-cli --version

最新バージョンにアップグレードする

インストーラーは常に最新リリースを取得します。アップグレードするには、もう一度実行してください：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/zammad/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/zammad/install.ps1 | iex

Claude Desktop の .mcpb ユーザー：最新の .mcpb（このセクションの先頭）をダウンロードし、Settings > Extensions で再度選択してください。Claude Code プラグインのユーザー：/plugin update zammad@msp-skills。

Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot、または別の MCP クライアントに追加する

インストーラーの実行後、エージェントごとの接続方法については mcp-install.md と docs/which-agent.md をご覧ください。エージェントごとにセクションがあり、GitHub Copilot の servers キーや、Microsoft 365 Copilot／Copilot Studio のリモート接続方法も記載されています。Claude Desktop では「設定」>「拡張機能」パネルを使うのが最も簡単です。JSON を編集したいユーザー向けの MCP 設定ブロックは mcp-install.md に記載されています。

Hermes にインストールする

Hermes CLI から実行します。

hermes skills install servosity/msp-skills/skills/zammad --force

Hermes のチャットセッション内で実行します。

/skills install servosity/msp-skills/skills/zammad --force

Hermes は MCP をネイティブにサポートしているため、zammad-mcp サーバーも直接使用できます。インストール方法も環境変数も同じです。

OpenClaw にインストールする

OpenClaw エージェントに次の内容を伝えてください（コピーして使います）。

https://github.com/servosity/msp-skills/tree/main/skills/zammad から zammad スキルをインストールしてください。このスキルでは、必須 CLI（zammad-cli）を openclaw: フロントマターブロック経由でインストールする方法を定義しています。

OpenClaw はまだ一般公開されていません。フロントマターの接続設定はあらかじめ組み込まれており、OpenClaw の公開と同時に有効になります。

認証する

CLI に必要な認証情報を設定します（Zammad ポータルから取得してください）。

ZAMMAD_API_TOKEN=<value> zammad-cli doctor

doctor は、データを操作するコマンドを実行する前に、認証情報が機能することを確認します。認証情報が拒否された場合でも終了コード 0 を返すため、スクリプトでは --fail-on error を追加してください。

このスキルでできること

チームでよく尋ねられる質問	コマンド
現在、サポートチームで負荷が高いのは誰ですか？	zammad-cli agent-load --json
各エージェントのキューは増えていますか、それとも減っていますか？	zammad-cli agent-trend --weeks 4 --json
困っていて、優先的な対応が必要な顧客はどこですか？	zammad-cli customer-health --at-risk --json
長期間オープンのままになっているチケットはどれですか？	zammad-cli overdue --days 3 --json
不満を抱えているようで、エスカレーションすべき顧客はどこですか？	zammad-cli escalate --json
解約リスクが高まっているアカウントはどれですか？その理由は何ですか？	zammad-cli churn-risk --json
顧客は何を求めていますか（機能、価格、コンプライアンス）？	zammad-cli feedback-scan --bucket pricing --json
オープンチケットを検索して読み取る（organization_id:N で顧客を絞り込む）	zammad-cli tickets search --query "state:open" --json
メモを記録する、またはナレッジベースを検索する	zammad-cli ticket note 12345 --body "..." --internal · zammad-cli kb search "restore" --json

コマンドの完全なリファレンスは guide.md をご覧ください。AI エージェントの運用規約（--agent、--dry-run、変更を加える前に確認すべきタイミング）については、AGENTS.md をご覧ください。

このスキルの特長

ほとんどの Zammad 連携や MCP サーバーは、質問ごとにライブ API 呼び出しへ中継します。単一のレコードを扱うには問題ありません。しかし、「オープンチケット全体を見て、チームで負荷が高い人は誰か」や「今四半期、対応が長引いていて不満が最も強いスレッドを持つ顧客はどこか」といった質問をするようになると、規模が大きくなるにつれて対応できなくなります。こうした質問に単一のエンドポイントで答えられる Zammad API はないからです。

このスキルは Zammad のデータを、全文検索に対応したローカルの SQLite ミラーに同期します。集計を伴う質問はローカル SQL の結合処理 1 回で済むため、即座にオフラインで結果を得られ、AI には生データではなく回答が渡されます。agent-load、churn-risk、feedback-scan などの複合コマンドは、チケット、記事、組織、ユーザーを横断して結合します。これはステートレスな API ラッパーではできない処理です。

このツールで解消する課題

r/msp でチケット管理ツールについて繰り返し聞かれる不満は、いつも同じです。ダッシュボードではキューの「中身」はわかっても、チケットを横断して集計できません。エージェントごとの負荷、何度も再オープンする顧客、ひそかに解約へ向かっているアカウントなどはわからないのです。そのため、毎週チケットをスプレッドシートにエクスポートし、答えを手作業で集計することになります。そのうえ、解約を実際に予測する2つの兆候、つまり不満を募らせた顧客の声や、記事のスレッドに埋もれた機能・価格・コンプライアンスに関する要望は、アカウントがすでに失われるまで表面化しません。

• zammad-cli agent-load - 現在、負荷が高すぎるのは誰か、エージェントごとのオープン・保留中・バックログの状況を表示します。
• zammad-cli overdue --days 3 - 対応が長引いているすべてのチケットを、優先度順に重み付けし、最も深刻なものから表示します。
• zammad-cli escalate - 顧客からの受信メッセージに不満が表れている進行中のチケットを、該当するテキストとともに表示します。
• zammad-cli churn-risk - 解約に向かっているアカウントを、理由とともにスコア化して表示します。
• zammad-cli feedback-scan --bucket pricing - 顧客から繰り返し寄せられる要望を、元のチケットとともにカテゴリ別に表示します。

詳しい説明は pain-point.md をご覧ください。

よくある質問

ChatGPT で使えますか？

このビルドでは使えません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Education プラン。Free ではまだ Developer Mode を利用できません）が接続できるのは、HTTPS 経由のリモート MCP サーバーのみです。つまり、Zammad MCP サーバーを HTTP モードで実行する必要があります。このビルドの HTTP モードはトークンを確認しますが、リクエストサイズや時間の制限はまだありません。そのため、コネクターが再公開されるまでは実行せず、トンネルの背後にも配置しないでください。その理由については、mcp-install.md のセキュリティに関する注意事項をご覧ください。それまでは Claude Desktop、Claude Code、または Codex をお使いください。

Codex、Cursor、Windsurf、Cline、Copilot、Gemini で使えますか？

はい。どれも MCP に対応しています。各ツール向けのインストールコマンドは、上の一覧と docs/which-agent.md の詳しい説明をご覧ください。

コーディングの知識は必要ですか？

いいえ。推奨されるインストール方法は、Claude Code または Codex に一文を貼り付けることです。エージェントが SKILL.md を読み込んでインストールします。別の方法として、OS ごとに1行のインストーラー（bash または PowerShell）もあります。どちらの方法でもコードを書く必要はありません。Zammad の認証情報を一度入力するだけです。

Zammad のデータは安全ですか？

データはお使いのマシンから外に出ません。CLI と MCP サーバーはローカルのバイナリです。SQLite のミラーは、ユーザーアカウント内のディレクトリに保存されます。AI エージェントが参照するのは CLI の返す内容のみで、通常はクエリ結果であり、生の一括データではありません。認証情報は環境変数またはエージェントの設定から読み込まれます。このリポジトリに含められることも、MSP Skills によって外部へ送信されることもありません。

セルフホスト型でもホスト型でも、自分の Zammad インスタンスで使えますか？

どちらでも使えます。ZAMMAD_URL（例：https://support.yourcompany.com）で任意の Zammad インスタンスを指定し、ZAMMAD_API_TOKEN に個人用アクセストークンを設定してください。トークンは Profile → Token Access から作成します。特定のインスタンスに固定されているものはありません。

Zammad に組み込まれた AI 機能とは何が違いますか？

Zammad の AI（チケットの要約、文章作成アシスタント）は1件のチケット内で機能します。こちらはサービスデスク全体を横断し、チームの負荷、滞留期間の長いバックログ、顧客の状態、解約の兆候、フィードバックの傾向を分析して、すでにお使いの AI エージェントに構造化された JSON を渡します。

エスカレーション、解約、フィードバックの兆候は、AI による感情分析ですか？

いいえ。透明性のあるキーワードとタイミングに基づくヒューリスティックで、チケットと該当するテキストを抽出し、AI または人間が判断できるようにします。候補を示し、その根拠を表示しますが、それだけで結論を出すことはありません。

費用はかかりますか？

無料です。Apache-2.0 ライセンスです。費用がかかるのは、お使いの AI エージェント（Claude、ChatGPT、Codex など）の利用料のみで、請求元は当方ではなく AI プロバイダーです。

安全モデル

階層	例	推奨されるエージェントポリシー
読み取り	agent-load、agent-trend、customer-health、overdue、escalate、churn-risk、feedback-scan、tickets search/get、articles by-ticket、kb browse/search/get、search、sync	許可
書き込み（通常）	ticket note、tickets create/update、articles create、tags add/remove、organizations create/update、users create/update、kb answer-create/publish/internal、kb category-create	--dry-run でプレビューしてから、レビュー済みの書き込みを実行
破壊的操作／設定	tickets delete、kb answer-delete	必ず人間が介在

最も強力な制御は、Zammad の認証情報に付与するスコープです。CLI が実行できるのは、認証情報に許可された操作だけです。制限方法を含む詳細は、governance.md をご覧ください。

ステータス

実環境で検証済みです。メンテナーの Servosity が、自社の本番テナントで確認しています。ほかの MSP も、週次の Build Sessions で実環境に導入しています。compoundingteams.com/build-sessions から参加登録してください。

---

標準規格。 オープンな Agent Skills spec（Anthropic、2025 年 12 月、40 以上のエージェント）に準拠しています。MCP に対応しており、Hermes を含む、MCP 対応エージェントで動作します。OpenClaw に対応済み（frontmatter は事前に設定済みで、OpenClaw のリリース待ちです）。

Servosity がメンテナンスしています。Apache-2.0 ライセンスです。CLI Printing Press で構築しました。最終更新日：2026-07-11。