osTicket MCP Server: Konfiguration

Alle Umgebungsvariablen des osTicket MCP Servers mit Standardwerten und Prüfregeln, Speicherort der .env-Datei sowie die festen Limits für Antwortgröße, Timeout, Anhänge und Logs.

English Version

Zurück zur Übersicht

osTicket MCP Server: Konfiguration

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Wo die Konfiguration liegt

Der Server liest Umgebungsvariablen in dieser Reihenfolge:

Variablen, die der MCP-Client dem Prozess übergibt (env in der MCP-Konfiguration). Sie haben Vorrang.
Die Datei ~/.claude/mcp-servers/osticket/.env, wenn sie existiert.
Existiert diese Datei nicht, eine .env im Arbeitsverzeichnis des Prozesses. Das ist für die Entwicklung gedacht.

Eine leere Variable zählt als nicht gesetzt und bekommt den Standardwert. Wenn du die Datei änderst, musst du den MCP-Client neu starten.

Umgebungsvariablen

Variable	Pflicht	Standard	Bedeutung
`OSTICKET_API_URL`	Ja	-	Basis-URL der osTicket-Instanz, zum Beispiel `https://tickets.example.com`
`OSTICKET_API_KEY`	Ja	-	API-Key, wird als Header `X-API-Key` gesendet. Darf nicht leer sein und keine Zeilenumbrüche enthalten
`OSTICKET_API_REJECT_UNAUTHORIZED`	Nein	`true`	TLS-Zertifikat prüfen. Nur der genaue Wert `true` lässt die Prüfung aktiv, jeder andere Wert schaltet sie ab
`OSTICKET_DEFAULT_NAME`	Nein	leer	Name, den `osticket_create_ticket` nutzt, wenn kein `name` übergeben wird
`OSTICKET_DEFAULT_EMAIL`	Nein	leer	E-Mail-Adresse für denselben Zweck. Wird beim Start auf ein gültiges Format geprüft
`OSTICKET_DEFAULT_TOPIC_ID`	Nein	`0`	Hilfethema-ID, wenn kein `topicId` übergeben wird. `0` bedeutet kein Hilfethema. Ein nicht numerischer Wert bricht den Start ab
`LOG_LEVEL`	Nein	`info`	`debug`, `info`, `warn` oder `error`. Ein anderer Wert wird nicht abgelehnt, dann werden alle Meldungen außer den Debug-Meldungen geschrieben
`ALLOW_HTTP`	Nein	nicht gesetzt	Nur der genaue Wert `true` erlaubt eine `http://`-URL. Sonst bricht der Start bei HTTP ab
`MCP_DEBUG`	Nein	nicht gesetzt	Der Wert `true` schaltet Debug-Meldungen des Loggers frei

ALLOW_HTTP und MCP_DEBUG stehen nicht in der Datei .env.example, der Server wertet sie aber aus.

Prüfungen beim Start

Der Server bricht beim Start mit einer Fehlermeldung ab, wenn:

OSTICKET_API_URL oder OSTICKET_API_KEY fehlt oder leer ist,
die URL ungültig ist oder http: nutzt, ohne dass ALLOW_HTTP=true gesetzt ist,
der API-Key einen Zeilenumbruch enthält,
OSTICKET_DEFAULT_EMAIL kein gültiges E-Mail-Format hat,
OSTICKET_DEFAULT_TOPIC_ID keine Zahl ist.

Ist OSTICKET_API_REJECT_UNAUTHORIZED nicht true, schreibt der Server eine Warnung auf stderr und ins Log, arbeitet aber weiter.

Der Server baut alle Endpunkt-URLs aus dem Host der OSTICKET_API_URL und dem festen Pfad /api/.... Ein Pfadanteil in der Basis-URL, etwa https://example.com/support, geht dabei verloren. osTicket muss deshalb unter der Wurzel des Hosts erreichbar sein.

Feste Limits

Diese Werte sind im Code festgelegt und nicht einstellbar.

Limit	Wert
Timeout je Anfrage	10 Sekunden
Wiederholungen bei vorübergehenden Fehlern	bis zu 2, Wartezeit 500 ms und 1000 ms
Größe einer osTicket-Antwort	höchstens 10 MB, größere Antworten werden abgebrochen
Länge einer Ergebnisliste in der Tool-Antwort	etwa 25.000 Zeichen, danach wird die Liste gekürzt
Standard und Maximum für `limit`	20 und 100
Anhänge je Aufruf	5 Dateien, je 10 MB, zusammen höchstens 50 MB
Cache der Statusliste	5 Minuten
Log-Datei	Rotation nur beim Start, wenn die Datei größer als 10 MB ist. Die letzten 5 rotierten Dateien bleiben erhalten. Im laufenden Betrieb wächst die Datei weiter

Beispiel

OSTICKET_API_URL=https://tickets.example.com
OSTICKET_API_KEY=dein-api-key
OSTICKET_API_REJECT_UNAUTHORIZED=true

OSTICKET_DEFAULT_NAME=Claude
OSTICKET_DEFAULT_EMAIL=claude@example.com
OSTICKET_DEFAULT_TOPIC_ID=1

LOG_LEVEL=info