basher83/zammad-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

48 stars 33 forks Качество 83 Тренд 33AGPL-3.0

Repository Install

basher83/zammad-mcp - кандидат на сервер MCP, импортированный из https://github.com/basher83/zammad-mcp.

Обзор

basher83/zammad-mcp - кандидат на сервер MCP, импортированный из https://github.com/basher83/zammad-mcp.

Обзор (машинный перевод)

Сервер MCP, который соединяет помощников ИИ с Zammad, предоставляя инструменты для управления билетами, пользователями, организациями, вложениями и контентом базы знаний.

Отказ от ответственности: Этот проект не связан с Zammad GmbH или Фондом Zammad. Это независимая интеграция с использованием Zammad API.

Особенности

Инструменты

** Управление билетами**

zammad_search_tickets - Поиск билетов с несколькими фильтрами
zammad_get_ticket - Получите подробную информацию о билетах со статьями (поддержка пагинации); атрибуты пользовательских объектов включены
[[Т2]] - Создание новых билетов zammad_update_ticket - Обновление свойств билетов, включая пользовательские атрибуты объектов через custom_fields
[[Т5]] - Добавить комментарии/примечания к билетам zammad_merge_tickets — слить билет в другой (необратимый)
zammad_add_ticket_tag / zammad_remove_ticket_tag - Управление билетными бирками zammad_bulk_update_tickets - Обновление, назначение, тег или закрытие до 100 билетов за один звонок с сообщением о сбое в билете zammad_get_ticket_tags - Получить теги, назначенные для конкретного билета

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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)

Открыть полный README на GitHub

Установка

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"
      }
    }
  }
}