basher83/zammad-mcp

Developer tools

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

48 stars 33 forks 品質 83 トレンド 33AGPL-3.0

Repository Install

basher83/zammad-mcp は [https://github.com/basher83/zammad-mcp.] からインポートされた MCP サーバー候補です

概要

basher83/zammad-mcp は [https://github.com/basher83/zammad-mcp.] からインポートされた MCP サーバー候補です

概要（AI 翻訳）

AIアシスタントをザマドに接続し、チケット、ユーザー、組織、添付ファイル、ナレッジベースコンテンツを管理するためのツールを提供します。

免責事項: このプロジェクトは、Zammad GmbH または Zammad Foundation によって承認または承認されていません。 Zammad API を使用する独立した統合です。

##特徴

ツール

チケット管理
[zammad_search_tickets - 複数のフィルタでチケットを検索
[zammad_get_ticket - 記事で詳細なチケット情報を取得する(ページネーションをサポート)。カスタムオブジェクト属性が含まれている
[zammad_create_ticket - 新しいチケットを作成する
[zammad_update_ticket] - custom_fieldsを介してカスタムオブジェクト属性を含むチケットのプロパティを更新する
[zammad_add_article - チケットにコメント/ノートを追加
[zammad_merge_tickets - チケットを別の(不可逆)にマージする
[zammad_add_ticket_tag/ zammad_remove_ticket_tag] - チケットタグの管理
[zammad_bulk_update_tickets - 1枚のチケットの故障報告で最大100枚のチケットを更新、割り当て、タグ、またはクローズアップ
[zammad_get_ticket_tags - 特定のチケットに割り当てられたタグを取得する

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

README

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

Zammad MCP Server

An MCP server that connects AI assistants to Zammad, providing tools for managing tickets, users, organizations, attachments, and knowledge base content.

Disclaimer: This project is not affiliated with or endorsed by Zammad GmbH or the Zammad Foundation. This is an independent integration that uses the Zammad API.

Features

Tools

Ticket Management
- zammad_search_tickets - Search tickets with multiple filters
- zammad_get_ticket - Get detailed ticket information with articles (supports pagination); custom object attributes are included
- zammad_create_ticket - Create new tickets
- zammad_update_ticket - Update ticket properties, including custom object attributes via custom_fields
- zammad_add_article - Add comments/notes to tickets
- zammad_merge_tickets - Merge a ticket into another (irreversible)
- zammad_add_ticket_tag / zammad_remove_ticket_tag - Manage ticket tags
- zammad_bulk_update_tickets - Update, assign, tag, or close up to 100 tickets in one call with per-ticket failure reporting
- zammad_get_ticket_tags - Get tags assigned to a specific ticket
- zammad_list_tags - List all tags defined in the system (requires admin.tag permission)
- zammad_export_tickets - Export tickets with their conversation articles to a JSONL file on the server host (requires ZAMMAD_EXPORT_DIR; see Ticket Export)
Attachment Support
- zammad_get_article_attachments - List attachments for a ticket article
- zammad_download_attachment - Download attachment content (base64-encoded)
User & Organization Management
- zammad_create_user - Create a Zammad user
- zammad_get_user / zammad_search_users - User information and search
- zammad_get_organization / zammad_search_organizations - Organization data
- zammad_get_current_user - Get authenticated user info
System Information
- zammad_list_groups - Get all available groups (cached for performance)
- zammad_list_ticket_states - Get all ticket states (cached for performance)
- zammad_list_ticket_priorities - Get all priority levels (cached for performance)
- zammad_get_ticket_stats - Get ticket statistics (optimized with pagination)
Webhook Events (HTTP transport only)

GitHub で README 全文を見る

インストール

uvx --from git+https://github.com/basher83/zammad-mcp.git mcp-zammad

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

設定

{
  "mcpServers": {
    "zammad": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/basher83/zammad-mcp.git", "mcp-zammad"],
      "env": {
        "ZAMMAD_URL": "https://your-instance.zammad.com/api/v1",
        "ZAMMAD_HTTP_TOKEN": "your-api-token"
      }
    }
  }
}