arush15june/zammad-mcp-go

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

11 stars 4 forks 品質 58 トレンド 8MIT

Repository Install

Zammad APIのMCPサーバー

概要

MCPの特長 Zammad API にアクセスするためのサーバー。 - チケットとユーザーリストの読み込み。 - 特定のチケットとユーザーの詳細情報を取得します。 - チケット・利用者の検索・新券の作成 - 既存のチケットにメモ(粒子)を追加。・チケットの通信履歴(粒子)の取得サーバは、次のMCPリソースとツールを公開します。リソースは、AI が URI を使用して構造化された方法で Zammad からデータを読み込むことを可能にします。 * リストチケット * 設定されたAPIトークンでアクセス可能なすべてのチケットをリストします。 * application/json * (Template) * ショーチケット(Resource) * {ticket id} で特定された特定のチケットの詳細を表示します。 * application/json * * リストユーザー * 設定された API トークンでアクセス可能なすべてのユーザーをリストします。 * application/json * (Template) * ユーザ (Resource) を表示 * {user id} で特定したユーザーの詳細を表示します。 * アプリケーション/json ツールは、AI が Zammad 内のアクションや特定のクエリを実行できるようにします。 * : Zammad の新しいチケットを作成します.

概要（AI 翻訳）

MCPの特長 Zammad API にアクセスするためのサーバー。

このサーバは、以下の機能を有効にします。

チケットとユーザーリストの読み込み。
特定のチケットとユーザーの詳細情報を取得します。
チケット・利用者の検索・新券の作成
既存のチケットにメモ(粒子)を追加。・チケットの通信履歴(粒子)の取得

機能

サーバは、次のMCPリソースとツールを公開します。

リソースは、AI が URI を使用して構造化された方法で Zammad からデータを読み込むことを可能にします。

※[zammad://tickets** 名前:リストチケット *** 説明: 設定された API トークンでアクセス可能なすべてのチケットをリストします。 ※MIMEタイプ: [[T1] ※[zammad://tickets/{ticket_id}* (テンプレート) 名前: ショーチケット(リソース) *** 説明:* [{ticket_id}] で特定されたチケットの詳細を表示します。 ※MIMEタイプ:** [[T4] ※[zammad://users** *** 名前:** リストユーザー *** 説明:** 設定された API トークンでアクセス可能なすべてのユーザーをリストします。 ※MIMEタイプ:** [[T6] [zammad://users/{user_id}* (テンプレート) 名前: ユーザを表示 (リソース) *** 説明:* [{user_id} で特定されたユーザーの詳細を表示します.

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

zammad-go-mcp

MCP Server for accessing the Zammad API.

This server enables:

Reading ticket and user lists.
Fetching details for specific tickets and users.
Searching for tickets and users.
Creating new tickets.
Adding notes (articles) to existing tickets.
Retrieving communication history (articles) for tickets.

Capabilities

The server exposes the following MCP Resources and Tools:

Resources allow the AI to read data from Zammad in a structured way using URIs.

zammad://tickets
- Name: List Tickets
- Description: Lists all tickets accessible by the configured API token.
- MIME Type: application/json
zammad://tickets/{ticket_id} (Template)
- Name: Show Ticket (Resource)
- Description: Shows details for a specific ticket identified by its {ticket_id}.
- MIME Type: application/json
zammad://users
- Name: List Users
- Description: Lists all users accessible by the configured API token.
- MIME Type: application/json
zammad://users/{user_id} (Template)
- Name: Show User (Resource)
- Description: Shows details for a specific user identified by their {user_id}.
- MIME Type: application/json

Tools

Tools allow the AI to perform actions or specific queries within Zammad.

create_ticket: Creates a new ticket in Zammad.
- Requires: title, group, customer (email or user ID), body.
- Optional: type (article type, default: “note”), internal (boolean, default: false).
search_tickets: Searches for tickets based on a query string.
- Requires: query.
- Optional: limit (default: 50).
add_note_to_ticket: Adds an internal note (article) to an existing ticket.
- Requires: ticket_id, body.
- Optional: internal (boolean, default: true).
get_ticket: Retrieves details for a specific ticket by its ID.
- Requires: ticket_id.
get_user: Retrieves details for a specific user by their ID.
- Requires: user_id.
search_users: Searches for users based on a query string (e.g., email, login, name).
- Requires: query.
- Optional: limit (default: 50).
get_ticket_articles: Retrieves all articles (communications) for a specific ticket.
- Requires: ticket_id.

Prerequisites

Go: Version 1.24 or higher installed.
Zammad Instance: Access to a running Zammad instance (URL).
Zammad API Token: An API token generated within your Zammad instance with sufficient permissions.

Getting a Zammad API Token

You need to generate an API token within Zammad to allow this MCP server to authenticate and interact with the API.

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
        "zammad": {
            "command": "<path-to>/zammad-go-mcp.exe",
            "args": [],
            "env": {
                "ZAMMAD_URL": "<zammad_url>",
                "ZAMMAD_TOKEN": "<zammad_token>"
            }
        }
    }
}