¶ osTicket MCP Server
¶ Inhaltsverzeichnis
- Systemanforderungen
- Installation
- Konfiguration
- Nutzung
- Verfügbare Tools
- Fehlerbehebung
- Technische Details
- FAQ
¶ Überblick
Der osTicket MCP Server ermöglicht Claude den direkten Zugriff auf deine osTicket-Instanz über die REST API. Verwalte Support-Tickets ohne deine Entwicklungsumgebung zu verlassen.
Model Context Protocol (MCP) ist ein offenes Protokoll, das KI-Assistenten wie Claude ermöglicht, mit externen Tools und Services zu interagieren. Dieser MCP Server stellt 11 Tools für komplettes osTicket-Ticket-Management inklusive Subticket-Beziehungen bereit.
Was macht diesen MCP Server unverzichtbar:
- ❌ Ohne MCP: Wechsel zwischen osTicket-UI und Claude Code, manuelle Ticket-Details-Kopie
- ❌ Ohne MCP: Keine automatisierten Ticket-Updates, zeitaufwändige manuelle Arbeit
- ✅ Mit MCP: Tickets direkt aus Claude verwalten, voller Kontext während Entwicklung, automatisierte Workflows
¶ Hauptfunktionen
- ✅ Tickets abrufen - Vollständige Tickets mit allen Messages abrufen
- ✅ Tickets auflisten - Tickets mit Filtern auflisten (Status, Department, Pagination)
- ✅ Tickets suchen - Volltextsuche über Ticket-Subjects und -Nummern
- ✅ Statistiken - Aggregierte Ticket-Statistiken (total, open, closed, overdue)
- ✅ Tickets erstellen - Neue Tickets mit Markdown-Support erstellen
- ✅ Tickets aktualisieren - Ticket-Eigenschaften ändern (Status, Department, Assignee, etc.)
- ✅ Tickets löschen - Tickets permanent löschen
- ✅ Subticket-Verwaltung - Eltern-Kind-Ticket-Beziehungen erstellen und verwalten
- ✅ MCP-Protokoll-konform - Funktioniert mit Claude Desktop, Claude CLI und anderen MCP-Clients
- ✅ Intelligente ID-Auflösung - Namen statt IDs verwenden (Status, Department, Topic, SLA, Staff)
¶ Anwendungsfälle
- Automatisiertes Support-Ticket-Management - Tickets auflisten, suchen, aktualisieren ohne Claude zu verlassen
- Kontextbewusste Entwicklung - Zugriff auf Ticket-Details während Coding
- Ticket-Erstellung aus Code-Issues - Tickets mit technischen Details in Markdown erstellen
- Batch-Operationen - Mehrere Tickets effizient aktualisieren
- Hierarchische Ticket-Organisation - Komplexe Issues mit Eltern-Kind-Ticket-Beziehungen verwalten
¶ Systemanforderungen
| Anforderung | Version | Hinweise |
|---|---|---|
| Node.js | 18+ | Empfohlen: Node.js 20 LTS für beste Kompatibilität |
| npm | 9+ | Oder pnpm 8+ / yarn 3+ |
| Claude Desktop | Latest | Oder Claude CLI / andere MCP-kompatible Clients |
| osTicket | 1.18.x | Mit aktivierter REST API |
| API Endpoints Plugin | Latest | Erforderlich für erweiterte API-Operationen |
| Subticket Manager Plugin | Latest | Erforderlich für Subticket-Verwaltungs-Tools |
¶ Installation
¶ Schritt 1: API Endpoints Plugin installieren
⚠️ Dieser MCP Server benötigt das API Endpoints Plugin auf deiner osTicket-Instanz.
cd /path/to/osticket/include/plugins
git clone https://github.com/markus-michalski/osticket-plugins.git
ln -s osticket-plugins/api-endpoints api-endpoints
# Im osTicket Admin Panel aktivieren
# Admin Panel → Manage → Plugins → API Endpoints → "Enable"
¶ Schritt 1b: Subticket Manager Plugin installieren (Optional aber empfohlen)
⚠️ Für Subticket-Verwaltungs-Features muss das Subticket Manager Plugin installiert sein.
cd /path/to/osticket/include/plugins
ln -s osticket-plugins/subticket-manager subticket-manager
# Im osTicket Admin Panel aktivieren
# Admin Panel → Manage → Plugins → Subticket Manager → "Enable"
Ohne dieses Plugin geben folgende Tools HTTP 501-Fehler zurück:
get_parent_ticketget_child_ticketscreate_subticket_linkunlink_subticket
¶ Schritt 2: MCP Server installieren
# MCP Server-Verzeichnis erstellen
mkdir -p ~/.claude/mcp-servers/osticket
# Repository klonen
git clone https://github.com/markus-michalski/claude-mcp-osTicket.git ~/.claude/mcp-servers/osticket
# Dependencies installieren
cd ~/.claude/mcp-servers/osticket
npm install
# TypeScript kompilieren
npm run build
¶ Schritt 3: osTicket API-Key erstellen
- Login im osTicket Admin Panel
- Navigiere zu Admin Panel → Manage → API Keys
- Klicke auf Add New API Key
- Konfiguriere:
- IP Address:
- Ohne api-key-wildcard Plugin: Trage spezifische IP deines Servers ein
- Mit api-key-wildcard Plugin: Kann
0.0.0.0verwenden
- Enable API: ✅ Ja
- Can Create Tickets: ✅ Ja
- IP Address:
- Klicke Add Key und kopiere generierten API-Key
¶ Schritt 4: API Endpoints Plugin-Berechtigungen konfigurieren
- Navigiere zu Admin Panel → Manage → Plugins
- Finde API Endpoints → Klicke auf Configure
- Wähle deinen API-Key aus Dropdown
- Aktiviere erforderliche Berechtigungen:
- ✅
can_read_tickets - ✅
can_search_tickets - ✅
can_update_tickets - ✅
can_delete_tickets - ✅
can_read_stats - ✅
can_manage_subtickets(falls Subticket Manager Plugin installiert)
- ✅
- Klicke Save
¶ Schritt 5: Umgebungsvariablen konfigurieren
Erstelle .env-Datei:
cd ~/.claude/mcp-servers/osticket
cp .env.example .env
Bearbeite .env:
# Erforderlich
OSTICKET_API_URL=https://tickets.example.com
OSTICKET_API_KEY=DEIN_API_KEY_HIER
OSTICKET_API_REJECT_UNAUTHORIZED=false # true für Produktiv mit gültigem SSL
# Optional: Defaults für Ticket-Erstellung
OSTICKET_DEFAULT_NAME=Claude AI
OSTICKET_DEFAULT_EMAIL=claude@example.com
OSTICKET_DEFAULT_TOPIC_ID=1
# Logging
LOG_LEVEL=info # debug, info, warn, error
¶ Schritt 6: Zu Claude Desktop hinzufügen
Bearbeite ~/.claude/config.json (oder Claude Desktop-Config):
{
"mcpServers": {
"osticket": {
"command": "node",
"args": ["/Users/deinname/.claude/mcp-servers/osticket/dist/index.js"]
}
}
}
Hinweis: Die .env-Datei wird automatisch vom Server geladen.
¶ Schritt 7: Claude neustarten
Starte Claude Desktop oder Claude CLI neu. Überprüfe mit /mcp - du solltest "osticket" mit Status "✓ connected" sehen.
¶ Konfiguration
¶ Umgebungsvariablen
| Variable | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
OSTICKET_API_URL |
✅ Ja | - | Basis-URL deiner osTicket-Instanz |
OSTICKET_API_KEY |
✅ Ja | - | API-Key für Authentifizierung |
OSTICKET_API_REJECT_UNAUTHORIZED |
❌ Nein | false |
SSL-Zertifikate validieren (auf true für Produktion setzen) |
OSTICKET_DEFAULT_NAME |
❌ Nein | - | Standard-User-Name für Ticket-Erstellung |
OSTICKET_DEFAULT_EMAIL |
❌ Nein | - | Standard-User-E-Mail für Ticket-Erstellung |
OSTICKET_DEFAULT_TOPIC_ID |
❌ Nein | - | Standard Help Topic-ID für Ticket-Erstellung |
LOG_LEVEL |
❌ Nein | info |
Logging-Level: debug, info, warn, error |
¶ Nutzung
¶ Basis-Kommandos
In Claude Desktop/CLI kannst du nun verwenden:
"Zeig mir alle offenen Tickets"
"Suche nach Tickets über Dashboard Widget"
"Hol Ticket #123456"
"Erstelle ein Ticket über den Bug, den ich gerade gefunden habe"
"Update Ticket #123456 auf Closed"
"Zeig mir alle Untertickets von #123456"
"Verknüpfe Ticket #234567 als Unterticket von #123456"
Der MCP Server handhabt automatisch API-Calls und gibt formatierte Ergebnisse zurück.
¶ Beispiel-Workflow
Bug suchen und fixen:
Du: "Suche in osTicket nach Tickets über Dashboard Widget"
Claude: *Sucht via search_tickets*
3 Tickets gefunden:
- #123456 "Dashboard Widget lädt nicht" (Open)
- #234567 "Widget zeigt falsche Daten" (Open)
- #345678 "Widget Performance-Problem" (Closed)
Du: "Zeig mir Ticket #123456 im Detail"
Claude: *Ruft via get_ticket ab*
Zeigt vollständiges Ticket mit allen Messages
Du: "Ich hab das Problem gefunden. Update auf In Progress und weise mir zu"
Claude: *Aktualisiert via update_ticket*
✅ Ticket #123456 aktualisiert
¶ Verfügbare Tools
¶ Tool-Übersicht
| Tool | Beschreibung | Erforderliche Berechtigung | Plugin erforderlich |
|---|---|---|---|
get_ticket |
Einzelnes Ticket mit allen Messages abrufen | can_read_tickets |
API Endpoints |
list_tickets |
Tickets mit Filtern auflisten | can_read_tickets |
API Endpoints |
search_tickets |
Volltextsuche | can_search_tickets |
API Endpoints |
get_ticket_stats |
Ticket-Statistiken abrufen | can_read_stats |
API Endpoints |
create_ticket |
Neues Ticket erstellen | can_create_tickets (native) |
- |
update_ticket |
Ticket-Eigenschaften aktualisieren | can_update_tickets |
API Endpoints |
delete_ticket |
Ticket permanent löschen | can_delete_tickets |
API Endpoints |
get_parent_ticket |
Eltern-Ticket eines Untertickets abrufen | can_manage_subtickets |
API Endpoints, Subticket Manager |
get_child_tickets |
Liste der Untertickets abrufen | can_manage_subtickets |
API Endpoints, Subticket Manager |
create_subticket_link |
Eltern-Kind-Beziehung erstellen | can_manage_subtickets |
API Endpoints, Subticket Manager |
unlink_subticket |
Eltern-Kind-Beziehung entfernen | can_manage_subtickets |
API Endpoints, Subticket Manager |
¶ get_ticket
Zweck: Vollständiges Ticket mit allen Messages abrufen
Parameter:
number(optional) - Ticket-Nummer (z.B. "123456")id(optional) - Ticket-ID
Beispiel:
{
"number": "123456"
}
¶ list_tickets
Zweck: Tickets mit optionalen Filtern und Pagination auflisten
Parameter:
status(optional) - Nach Status filtern (z.B. "open", "closed")departmentId(optional) - Nach Department-ID filternlimit(optional) - Maximale Ergebnisse (Standard: 20)offset(optional) - Pagination-Offset (Standard: 0)
Beispiel:
{
"status": "open",
"limit": 50
}
¶ search_tickets
Zweck: Volltextsuche über Ticket-Subjects und -Nummern
Parameter:
query(erforderlich) - Suchbegrifflimit(optional) - Maximale Ergebnisse (Standard: 20)
Beispiel:
{
"query": "Dashboard Widget",
"limit": 10
}
¶ get_ticket_stats
Zweck: Aggregierte Ticket-Statistiken abrufen
Parameter: Keine (leeres Objekt {})
Beispiel:
{}
¶ create_ticket
Zweck: Neues osTicket-Ticket erstellen
Parameter:
name(optional) - User-Name (nutztOSTICKET_DEFAULT_NAMEfalls nicht angegeben)email(optional) - User-E-Mail (nutztOSTICKET_DEFAULT_EMAILfalls nicht angegeben)subject(erforderlich) - Ticket-Subjectmessage(erforderlich) - Ticket-Message/Beschreibungformat(optional) - Message-Format:"markdown"(Standard),"html"oder"text"topicId(optional) - Help Topic-ID (nutztOSTICKET_DEFAULT_TOPIC_IDfalls nicht angegeben)
Markdown-Support:
Benötigt markdown-support Plugin. Ohne Plugin wird Content als HTML behandelt.
Beispiel:
{
"subject": "Bug Report",
"message": "## Kritischer Bug\\n\\n**Issue:** Fehler in Zahlungsberechnung\\n\\n```php\\n$total = calculateTotal();\\n```"
}
¶ update_ticket
Zweck: Ticket-Eigenschaften aktualisieren
Parameter:
number(erforderlich) - Ticket-NummerdepartmentId(optional) - Department-ID oder -NamestatusId(optional) - Status-ID oder -NametopicId(optional) - Help Topic-ID oder -NamestaffId(optional) - Staff-ID oder -UsernameslaId(optional) - SLA-Plan-ID oder -NameparentTicketNumber(optional) - Parent-Ticket-Nummernote(optional) - Interne Notiz hinzufügennoteTitle(optional) - Titel für Notiz (Standard: "API Update")noteFormat(optional) - Format: "text", "html", "markdown" (Standard: "markdown")
Intelligente ID-Auflösung:
✨ Du musst dir keine IDs merken! Der MCP Server löst Namen automatisch in IDs auf, indem er deine osTicket-Instanz abfragt.
Unterstützt für:
- Status: Verwende "Offen", "Geschlossen", "Gelöst", "Testing" oder deine individuellen Status-Namen
- Department: Verwende Department-Namen statt IDs
- Help Topic: Verwende Topic-Namen statt IDs
- SLA Plan: Verwende SLA-Namen statt IDs
- Staff: Verwende Usernames statt Staff-IDs
So funktioniert's:
- MCP Server lädt verfügbare Status/Departments/Topics von deiner osTicket-API beim ersten Aufruf
- Ergebnisse werden für die Session gecacht (schnelle nachfolgende Lookups)
- Namen werden case-insensitiv verglichen
- Falls Name nicht gefunden, bekommst du einen hilfreichen Fehler mit verfügbaren Optionen
Beispiel:
{
"number": "123456",
"statusId": "Geschlossen",
"departmentId": "IT Support",
"note": "## Lösung\\n\\nIssue behoben und deployed."
}
Numerische IDs funktionieren weiterhin:
{
"number": "123456",
"statusId": 3,
"departmentId": 5
}
¶ delete_ticket
Zweck: Ticket permanent löschen
⚠️ Warnung: Diese Operation ist unwiderruflich!
Parameter:
number(erforderlich) - Ticket-Nummer
Beispiel:
{
"number": "123456"
}
¶ get_parent_ticket
⚠️ Benötigt: Subticket Manager Plugin
Zweck: Eltern-Ticket eines Untertickets abrufen
Parameter:
number(erforderlich) - Unterticket-Nummer
Beispiel:
{
"number": "234567"
}
Antwort:
{
"success": true,
"parent": {
"ticket_id": 78,
"number": "123456",
"subject": "Hauptproblem",
"status": "Offen"
}
}
¶ get_child_tickets
⚠️ Benötigt: Subticket Manager Plugin
Zweck: Liste der Untertickets eines Eltern-Tickets abrufen
Parameter:
number(erforderlich) - Eltern-Ticket-Nummer
Beispiel:
{
"number": "123456"
}
Antwort:
{
"success": true,
"children": [
{
"ticket_id": 79,
"number": "234567",
"subject": "Unteraufgabe 1",
"status": "Offen"
},
{
"ticket_id": 80,
"number": "345678",
"subject": "Unteraufgabe 2",
"status": "Geschlossen"
}
],
"total": 2
}
¶ create_subticket_link
⚠️ Benötigt: Subticket Manager Plugin
Zweck: Eltern-Kind-Beziehung zwischen zwei Tickets erstellen
Parameter:
parentNumber(erforderlich) - Eltern-Ticket-NummerchildNumber(erforderlich) - Kind-Ticket-Nummer oder -ID
Beispiel:
{
"parentNumber": "123456",
"childNumber": "234567"
}
Antwort:
{
"success": true,
"parent": {
"ticket_id": 78,
"number": "123456",
"subject": "Hauptproblem",
"status": "Offen"
},
"child": {
"ticket_id": 79,
"number": "234567",
"subject": "Unteraufgabe 1",
"status": "Offen"
},
"message": "Subticket-Verknüpfung erstellt: 234567 ist nun Unterticket von 123456"
}
¶ unlink_subticket
⚠️ Benötigt: Subticket Manager Plugin
Zweck: Eltern-Kind-Beziehung entfernen (Ticket wieder unabhängig machen)
Parameter:
number(erforderlich) - Unterticket-Nummer zum Entfernen
Beispiel:
{
"number": "234567"
}
Antwort:
{
"success": true,
"child": {
"ticket_id": 79,
"number": "234567",
"subject": "Unteraufgabe 1",
"status": "Offen"
},
"message": "Unterticket 234567 wurde von seinem Eltern-Ticket getrennt"
}
¶ Fehlerbehebung
¶ Problem: MCP Server lädt nicht
Symptome:
- Claude Desktop zeigt keine MCP-Tools
- "Server failed to start"-Fehler
Prüfen:
- Node.js-Version:
node -v(muss 18+ sein) ~/.claude/config.jsonSyntax (valides JSON)- Umgebungsvariablen in
.env - Claude Desktop-Logs:
- macOS:
~/Library/Logs/Claude/mcp*.log - Windows:
%APPDATA%\\Claude\\logs\\mcp*.log
- macOS:
Lösung:
# Server neu bauen
cd ~/.claude/mcp-servers/osticket
npm run build
# Manuell testen
node dist/index.js
¶ Problem: "HTTP error! status: 401 Unauthorized"
Symptome: Ungültiger API-Key
Prüfen:
- API-Key in
.envüberprüfen - API-Key im osTicket Admin Panel prüfen
- Sicherstellen, dass API-Key aktiviert ist
- IP-Adresse korrekt überprüfen
Lösung: API-Key neu generieren und .env aktualisieren
¶ Problem: "HTTP error! status: 403 Forbidden"
Symptome: Fehlende Berechtigungen
Prüfen:
- Admin Panel → Plugins → API Endpoints → Configure
- Deinen API-Key auswählen
- Erforderliche Berechtigungen aktivieren:
- ✅
can_read_tickets - ✅
can_search_tickets - ✅
can_update_tickets - ✅
can_delete_tickets - ✅
can_read_stats - ✅
can_manage_subtickets(falls Subticket-Tools verwendet werden)
- ✅
- Save klicken
¶ Problem: "HTTP error! status: 404 Ticket not found"
Symptome: Ticket existiert nicht
Lösung:
- Ticket-Nummer korrekt überprüfen
- Prüfen, ob Ticket im osTicket Admin Panel existiert
- Sicherstellen, dass du Berechtigung für das Department des Tickets hast
¶ Problem: "HTTP error! status: 501 Not Implemented"
Symptome: Subticket-Tools geben 501-Fehler zurück
Lösung:
- Subticket Manager Plugin installieren
- Plugin im Admin Panel aktivieren
- API-Key-Berechtigungen konfigurieren (
can_manage_subticketsaktivieren)
¶ Problem: "Missing required environment variables"
Symptome: .env-Datei nicht gefunden
Lösung:
- Sicherstellen, dass
.envunter~/.claude/mcp-servers/osticket/.envexistiert - Aus
.env.examplekopieren - Alle erforderlichen Variablen ausfüllen
¶ Logs für Debugging
Server-Logs anzeigen:
# Live Tail
tail -f ~/.claude/mcp-servers/osticket/logs/server.log
# Debug-Logging in .env aktivieren
LOG_LEVEL=debug
¶ Technische Details
¶ Architektur
┌─────────────────────────────────────┐
│ Claude Code │
│ └─ MCP Protocol │
├─────────────────────────────────────┤
│ MCP Server (Node.js/TypeScript) │
│ ├─ Application Layer │
│ │ └─ Tool Handlers │
│ └─ Infrastructure Layer │
│ ├─ HTTP Client │
│ │ └─ Intelligente ID-Auflösung │
│ └─ Logger │
├─────────────────────────────────────┤
│ osTicket REST API │
│ └─ API Endpoints Plugin │
│ ├─ tickets-statuses.php │
│ ├─ tickets-subtickets-*.php │
│ └─ Weitere Endpoints │
└─────────────────────────────────────┘
¶ Projektstruktur
claude-mcp-osTicket/
├── dist/ # Kompiliertes JavaScript
├── src/
│ ├── index.ts # MCP Server Entry Point
│ ├── config/
│ │ └── Configuration.ts # Umgebungskonfiguration
│ ├── application/
│ │ └── handlers/
│ │ └── ToolHandlers.ts # Tool-Implementierungen
│ └── infrastructure/
│ ├── http/
│ │ ├── OsTicketApiClient.ts # REST API Client mit ID-Auflösung
│ │ └── types/
│ │ └── SubticketTypes.ts # TypeScript-Typen für Subtickets
│ └── logging/
│ └── Logger.ts # File-basierter Logger
├── package.json
├── tsconfig.json
├── .env # Konfiguration (nicht in Git)
└── .env.example # Template
¶ Verwendete API-Endpunkte
| Tool | API-Endpunkt | Methode |
|---|---|---|
| get_ticket | /api/tickets-get.php/:number.json |
GET |
| list_tickets | /api/tickets-search.php |
GET |
| search_tickets | /api/tickets-search.php?query=... |
GET |
| get_ticket_stats | /api/tickets-stats.php |
GET |
| create_ticket | /api/tickets.json |
POST |
| update_ticket | /api/tickets-update.php/:number.json |
PATCH |
| delete_ticket | /api/tickets-delete.php/:number.json |
DELETE |
| get_parent_ticket | /api/tickets-subtickets-parent.php/:number.json |
GET |
| get_child_tickets | /api/tickets-subtickets-list.php/:number.json |
GET |
| create_subticket_link | /api/tickets-subtickets-create.php/:parent.json |
POST |
| unlink_subticket | /api/tickets-subtickets-unlink.php/:child.json |
DELETE |
| ID-Auflösung | /api/tickets-statuses.php |
GET |
¶ Sicherheits-Features
-
API-Key-Verschlüsselung:
- Gespeichert in Umgebungsvariablen (nicht im Code)
- Übertragung nur via HTTPS
-
Input-Validierung:
- Alle Parameter vor API-Calls validiert
- Type-Checking mit TypeScript
-
Berechtigungssystem:
- Granulare Berechtigungen pro API-Key
- Konfiguriert im API Endpoints Plugin
¶ FAQ
¶ Allgemeine Fragen
F: Was ist MCP?
A: MCP (Model Context Protocol) ist ein Standard-Protokoll zur Verbindung von KI-Assistenten mit externen Tools. Dieser Server implementiert MCP, damit Claude mit osTicket interagieren kann.
F: Muss ich Claude nach Konfigurationsänderungen neustarten?
A: Ja. Claude Desktop und Claude CLI müssen neu gestartet werden, um MCP-Konfigurationen neu zu laden.
F: Kann ich das mit anderen KI-Assistenten nutzen?
A: Ja! Jeder MCP-kompatible Client kann diesen Server nutzen. Primär getestet mit Claude Desktop und Claude CLI.
¶ Kompatibilität
F: Ist es kompatibel mit Node.js 16?
A: Nein. Benötigt Node.js 18+ für ESM-Support und moderne JavaScript-Features.
F: Funktioniert es unter Windows?
A: Ja! Getestet auf macOS, Linux und Windows.
F: Funktioniert es mit osTicket 1.17?
A: Nicht getestet. Konzipiert für osTicket 1.18.x. Funktioniert möglicherweise mit 1.17, aber Kompatibilität nicht garantiert.
¶ Intelligente ID-Auflösung
F: Kann ich Status-Namen statt IDs verwenden?
A: Ja! Der MCP Server löst Status-Namen (wie "Offen", "Geschlossen", "Testing") automatisch in IDs auf, indem er den /api/tickets-statuses.php Endpoint abfragt. Das funktioniert mit deinen individuellen Status-Namen.
F: Was passiert, wenn ich einen ungültigen Status-Namen verwende?
A: Du bekommst eine hilfreiche Fehlermeldung, die alle verfügbaren Status-Namen deiner osTicket-Instanz auflistet.
F: Funktioniert die Namen-Auflösung auch für Departments, Topics und SLA-Pläne?
A: Ja! Die gleiche intelligente Auflösung funktioniert für:
- Status-Namen (via
/api/tickets-statuses.php) - Department-Namen
- Help Topic-Namen
- SLA-Plan-Namen
- Staff-Usernames
F: Werden die aufgelösten IDs gecacht?
A: Ja! Status-Namen werden einmal pro MCP Server-Session geladen und im Speicher gecacht für schnelle nachfolgende Lookups.
¶ Subticket-Verwaltung
F: Was sind Subtickets?
A: Subtickets ermöglichen es, Eltern-Kind-Beziehungen zwischen Tickets zu erstellen. Dies ist nützlich für die Organisation komplexer Issues in Haupt-Tickets mit Unteraufgaben.
F: Brauche ich das Subticket Manager Plugin für alle Tools?
A: Nein. Nur für die 4 subticket-spezifischen Tools (get_parent_ticket, get_child_tickets, create_subticket_link, unlink_subticket). Alle anderen Tools funktionieren ohne das Plugin.
F: Was passiert, wenn ich Subticket-Tools ohne das Plugin verwende?
A: Du erhältst einen HTTP 501-Fehler mit der Meldung "Subticket plugin not available".
F: Kann ein Ticket mehrere Eltern haben?
A: Nein. Jedes Ticket kann nur ein Eltern-Ticket haben. Wenn du versuchst, ein Ticket zu verknüpfen, das bereits ein Eltern-Ticket hat, erhältst du einen HTTP 422-Fehler.
¶ Sicherheit
F: Ist es sicher, 0.0.0.0 als API-Key-IP zu verwenden?
A: Nur in Entwicklung! Für Produktion immer spezifische IP-Adressen verwenden. Die 0.0.0.0-Option benötigt das api-key-wildcard Plugin und sollte nur hinter Firewalls genutzt werden.
F: Wo werden API-Keys gespeichert?
A: In der .env-Datei, die von Git via .gitignore ausgeschlossen ist. Niemals API-Keys in Versionskontrolle committen.
¶ Fehlerbehebung
F: Warum bekomme ich 403 Forbidden-Fehler?
A: Überprüfe Berechtigungen in Admin Panel → Plugins → API Endpoints → Configure. Stelle sicher, dass alle erforderlichen Berechtigungen für deinen API-Key aktiviert sind.
F: Kann ich Read-Only-API-Keys erstellen?
A: Ja! In der API Endpoints Plugin-Konfiguration aktiviere nur can_read_tickets, can_search_tickets und can_read_stats.
¶ 📄 Lizenz
Dieser MCP Server wird unter der MIT License veröffentlicht.
Details siehe LICENSE.
¶ 💬 Support
Für Fragen oder Probleme erstelle bitte ein Issue auf GitHub:
Issue Tracker: https://github.com/markus-michalski/claude-mcp-osTicket/issues
Beim Melden von Problemen bitte angeben:
- Node.js-Version (
node -v) - npm-Version (
npm -v) - osTicket-Version
- MCP Server-Version
- Claude Desktop/CLI-Version
- Betriebssystem
- Fehlermeldungen aus Logs
- Schritte zur Reproduktion
¶ 🤝 Mitwirken
Entwickelt von Markus Michalski
Beiträge willkommen!
- Repository forken
- Feature-Branch erstellen
- Pull Request einreichen
¶ Verwandte Links
- API Endpoints Plugin - Erforderlich
- Subticket Manager Plugin - Erforderlich für Subticket-Tools
- API Key Wildcard Plugin - Optional (für
0.0.0.0IP) - Markdown Support Plugin - Optional (für Rich-Formatierung)
- Model Context Protocol
- MCP Specification
¶ Changelog
Siehe CHANGELOG.md für Versionshistorie.