Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Der Server liest Umgebungsvariablen in dieser Reihenfolge:
env in der MCP-Konfiguration). Sie haben Vorrang.~/.claude/mcp-servers/osticket/.env, wenn sie existiert..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.
| 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_HTTPundMCP_DEBUGstehen nicht in der Datei.env.example, der Server wertet sie aber aus.
Der Server bricht beim Start mit einer Fehlermeldung ab, wenn:
OSTICKET_API_URL oder OSTICKET_API_KEY fehlt oder leer ist,http: nutzt, ohne dass ALLOW_HTTP=true gesetzt ist,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_URLund dem festen Pfad/api/.... Ein Pfadanteil in der Basis-URL, etwahttps://example.com/support, geht dabei verloren. osTicket muss deshalb unter der Wurzel des Hosts erreichbar sein.
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 |
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