概要
Zammadオープンソースヘルプデスク: チケット、その記事、ユーザー、組織、グループに加え、チケット全体の全文検索。自分のZammad instance上のREST API v1、トークン認証。
ガイド付きセットアップ
Zammad を Cursor に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Zammad を接続して、MCP URL を Cursor に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Zammad のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Zammad をクリック、認証情報を貼り付け、MCP API キーを発行 — 完了です。Docker も
git cloneもローカルサーバーも不要。
Zammad + Cursor
Zammadオープンソースヘルプデスク: チケット、その記事、ユーザー、組織、グループに加え、チケット全体の全文検索。自分のZammad instance上のREST API v1、トークン認証。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
ZAMMAD_URL, ZAMMAD_API_TOKEN
ステップ 1 — 認証情報を取得
Getting a token
- Sign in to Zammad, open your avatar → Profile → Token Access, and switch token access on if an admin has not already.
- Create a token with the permissions the agent needs —
ticket.agentto read and answer tickets,adminonly if you really want the agent to change configuration. - Put it in
ZAMMAD_API_TOKENand your instance's base URL (no trailing slash, no/api) inZAMMAD_URL.
The Authorization header is Token token=…, Zammad's own scheme — not Bearer. This adapter sends it correctly; it is the first thing to check when hand-building a Zammad connector that 401s with a token you know is good.
…(continued in the in-app connector instructions)
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — Cursor にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Cursor は ~/.cursor/mcp.json から MCP サーバを読み込みます。次のエントリを追加してください:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API key を取得。
- ファイルを保存し Cursor を再起動。
- Cursor → Settings → MCP を開き、
Zammadが "Connected" として表示されることを確認。 - チャット開始 —
Zammadのすべてのツールが呼び出し可能になります。
利用可能なツール
| Tool | What it does |
|---|---|
zammad_get_me | Read the user the token belongs to, with their roles, group memberships and permissions |
zammad_list_tickets | List tickets, newest first, with state, priority, group, owner and customer |
zammad_search_tickets | Full-text search across tickets |
zammad_get_ticket | Read one ticket by number or id with all its attributes: state, priority, owner, customer, group, SLA and custom fields |
zammad_list_ticket_articles | Read the conversation on one ticket: every article in order, with sender, type, body and whether it is internal |
zammad_list_users | List users (agents and customers) with their name, e-mail, organization and active flag |
zammad_search_users | Find a user by name, e-mail or phone fragment — the usual first step before opening a ticket for somebody |
zammad_list_organizations | List organizations (the customer companies tickets are grouped under) with their domain, note and VIP flag |
zammad_list_groups | List the groups (queues) tickets are routed into, with their assignment and follow-up settings |
zammad_create_ticket | Open a real ticket in the live instance |
zammad_add_article | Add an article to an existing ticket |
FAQ
Cursor の Free プランでカスタム MCP サーバは使えますか? はい — Hobby/Pro/Business で利用可能です。
次のステップ
このガイドは役に立ちましたか?