Diese Seite ergänzt die Anleitungen für Claude und ChatGPT.
Wenn es nicht funktioniert
Die meisten Probleme lösen die Schritte unten. Hilft keiner davon, führen Sie die Diagnose aus und senden ihren Bericht an den Support. Wenn Sie das Plugin nicht ausführen können, kopieren Sie den Diagnosetext und senden ihn im betroffenen Chat als Nachricht; die Anwendung erstellt damit denselben Bericht. Die Oberflächen von Claude und ChatGPT ändern sich laufend; weicht eine Bezeichnung ab, hilft meist die sinngemäß passende Schaltfläche.
Installation
ChatGPT: Plugins-Schalter fehlt
Symptom: Der Bereich Plugins fehlt in den Einstellungen, der Schalter lässt sich nicht einschalten, oder das Plugin erscheint nicht unter Anpassen > Plugins.
- Prüfen, dass die Desktop-App verwendet wird; im Browser (chatgpt.com) steht die Verbindung des Plugins nicht zur Verfügung. ChatGPT für Desktop herunterladen.
- Die Desktop-App auf die neueste Version aktualisieren.
- Unter Einstellungen > Allgemein den Schalter Plugins einschalten.
- Fehlt der Bereich auch danach, erlaubt Ihr Tarif oder Ihre Organisation keine Plugins. Die Freigabe erteilt der Anbieter beziehungsweise die Administration Ihrer Organisation.
macOS: Marketplace-Fehler in ChatGPT
Symptom: Beim Hinzufügen des Marketplaces in der macOS-App erscheint ein Fehler oder nichts passiert.
- Die macOS-App benötigt für das Hinzufügen eines Marketplaces die Xcode Command Line Tools. Installationsanleitung von Apple: Installing the Command Line Tools.
- Die ChatGPT-Desktop-App danach neu starten und den Marketplace erneut hinzufügen.
- Alternativ das Plugin ohne Marketplace installieren: Plugin-Installation per Zip-Datei.
Claude: Plugin nicht auffindbar
Symptom: Nach dem Synchronisieren bietet Claude das Plugin nicht an.
- Im Reiter Entdecken nach „EmpCo“ suchen.
- Prüfen, dass der Marketplace
agent-servicesunter + Hinzufügen > Marketplaces verwalten steht, und dort Nach Updates suchen wählen. - Fehlt der Marketplace, ihn mit der Schreibweise
agent-services-at/pluginserneut hinzufügen (Schritt 1 der Installation in Claude).
Marketplace oder Plugin-Installation fehlgeschlagen
Symptom: Der Marketplace lässt sich nicht hinzufügen oder das Plugin nicht installieren.
- Die Schreibweise
agent-services-at/pluginsprüfen. - Die Anwendung auf die neueste Version aktualisieren.
- Als Rückfall die Zip-Datei verwenden: Plugin-Installation per Zip-Datei. Bei einem Fehler zur Zip-Struktur die Datei erneut vom Server laden, statt sie zu bearbeiten.
Befehle doppelt oder verwechselt
Symptom: Befehle des Plugins erscheinen doppelt oder werden verwechselt.
In Claude ist vermutlich zusätzlich eine per Zip-Datei installierte Fassung mit demselben Namen vorhanden. Diese Fassung unter Anpassungen > Plugins > Meine über Entfernen löschen und das Plugin nur über den Marketplace verwenden.
Plugin-Installation per Zip-Datei
Ist der Marketplace nicht erreichbar, lässt sich dasselbe Paket als Zip-Datei installieren. Aktualisierungen kommen auf diesem Weg nicht automatisch; Sie installieren sie von Hand.
-
Datei herunterladen.
empco-uwg-monitor-plugin.zipherunterladen und nicht entpacken.- Liegt danach keine
.zip-Datei im Ordner Downloads, hat der Browser sie selbst entpackt und gelöscht (zum Beispiel Safari): Stattdessenempco-uwg-monitor-plugin.zip.pluginherunterladen und inempco-uwg-monitor-plugin.zipumbenennen.
-
Hochladen.
- Claude:
- Anpassungen > Plugins > Meine öffnen.
- Oben rechts + Hinzufügen > Plugin hochladen wählen.
- Die Zip-Datei auswählen.
- Den Konnektor wie in Schritt 3 der Installation in Claude verbinden.
- Ausprobieren wählen.
- ChatGPT:
- In der Desktop-App oder im Browser (chatgpt.com) Plugins > Hinzufügen > Plugin hochladen wählen.
- Die Zip-Datei auswählen.
- Die Anmeldung wie in Schritt 3 der Installation in ChatGPT abschließen.
- Claude:
Neue Fassung installieren
-
Claude: Ein per Zip-Datei installiertes Plugin lässt sich nicht zuverlässig überschreiben. Das Plugin zuerst unter Anpassungen > Plugins > Meine über Entfernen löschen und die heruntergeladene Zip-Datei hochladen. Erscheint die installierte Fassung nicht sofort, kann sie verzögert sein; nach einer Stunde erneut prüfen.
-
ChatGPT: Ein hochgeladenes Plugin aktualisiert ChatGPT auf Auftrag selbst. Diesen Text in der Desktop-App im Modus Work als Nachricht senden, danach einen neuen Chat beginnen:
Aktualisiere mein hochgeladenes Plugin „EmpCo-UWG Monitor“ (Manifestname empco-uwg-monitor) mit dem Plugin-Archiv unter https://claims.agent-services.at/downloads/empco-uwg-monitor-plugin.zip. Vor jeder Änderung: 1. Ermittle genau dieses Plugin in meinem Konto und nenne Plugin-ID, Version, Release-ID, Bereich (persönlich oder Arbeitsbereich), Sichtbarkeit und die gespeicherten Dateien. Eine Plugin-ID aus einer anderen Quelle verwendest du erst, nachdem das Konto sie bestätigt hat. 2. Lade das Archiv und prüfe, dass es sich vollständig entpacken lässt, nur sichere Pfade und lesbare Manifeste enthält und die Plattform es als Plugin-Paket annimmt. 3. Prüfe, dass Manifestname und Anzeigename des Archivs mit dem gefundenen Plugin übereinstimmen. 4. Nenne Abweichungen von Empfehlungen für Plugin-Pakete, die das Hochladen nicht verhindern. Brich ohne Hochladen ab, wenn das Ziel nicht eindeutig ist, ein Name abweicht oder das Archiv beschädigt ist. Aktualisiere dann genau dieses Plugin und verwende die Release-ID als Schutz vor gleichzeitigen Änderungen. Plugin-ID, Eigentümer, Bereich, Sichtbarkeit, Freigaben, MCP-Adresse und Anmeldung bleiben erhalten; vom Dienst erzeugte Kompatibilitätsdateien bleiben bestehen, auch wenn sie im Archiv fehlen. Ändere kein anderes Plugin. Lies das Plugin danach zurück und nenne alte und neue Release-ID, die Version, ob die Aktualisierung gelungen ist, Hinweise aus der Prüfung und ob ein weiterer Schritt nötig ist. Ein Testabruf über die Verbindung ist nicht nötig.Für ChatGPT ist der Marketplace der empfohlene Weg: Er aktualisiert ohne diesen Auftrag.
Verbindung und Anmeldung
Verbindung fehlt oder Sitzung abgelaufen
Symptom: Der Monitor meldet, dass die Verbindung zum Regelserver fehlt, der Konnektor zeigt nicht Verbunden, oder die Anmeldung ist abgelaufen.
Die Verbindung aktualisieren: in Claude oder in ChatGPT (dort über Authenticate). Danach eine Unterhaltung beginnen.
Zugangscode gesperrt oder abgelaufen
Symptom: Die Anmeldeseite meldet, dass der Zugangscode gesperrt oder abgelaufen ist.
Eine erneute Anmeldung mit demselben Code hilft nicht. Die Diagnose ausführen, den Support kontaktieren, ihren Bericht beifügen und die angezeigte Meldung nennen.
Anmeldung nicht abschließbar
Symptom: Die Anmeldung lässt sich nicht abschließen, oder der Monitor meldet auch nach der Anmeldung, dass die Verbindung fehlt.
Die Diagnose ausführen. Den Support kontaktieren und ihren Bericht beifügen. Der Monitor nennt dazu die im Plugin hinterlegte Supportadresse.
Prüfung und Aktualisierung
Befehl im Chat nicht verfügbar
Symptom: Nach der Installation erscheint /report-claim-risks im Chat nicht, oder der Monitor reagiert nicht auf den Befehl.
- Den empfohlenen Modus verwenden: in Claude eine Unterhaltung beginnen, in ChatGPT den Modus Work der Desktop-App.
- Eine Sitzung beziehungsweise einen Chat öffnen.
- Prüfen, dass das Plugin installiert ist und beim Konnektor Verbunden steht (Claude, ChatGPT).
- Hilft das nicht, können Sie das Plugin nicht ausführen. Den Diagnosetext kopieren, im selben Chat als Nachricht senden und den Bericht an den Support schicken.
Aktualisierung in Claude: Meldungen
- Der Hinweis „Ausführbare Dateien oder Einstellungen können von der Version abweichen, die du vor dieser Synchronisierung verwendet hast“ erscheint bei jeder neuen Version und ist keine Fehlermeldung.
- Der Marketplace gehört zum Claude-Konto: Wurde er auf claude.ai hinzugefügt, fehlt er in der Desktop-App unter Marketplaces verwalten möglicherweise, und Nach Updates suchen meldet dort „Konnte nicht nach Updates suchen“. Dann die Aktualisierung auf claude.ai im Browser auslösen.
Diagnose-Bericht an den Support
Die Diagnose prüft Verbindung, Versionen und Umgebung und erstellt daraus einen Bericht. Er enthält nur technische Angaben, nie geprüfte Texte oder Ergebnisse. Legen Sie ihn jeder Supportanfrage bei.
-
Im Chat dieses Schema eingeben (weitere Hinweise: Den passenden Skill starten):
/diagnose-monitor-plugin [optional: version | technik | voll]Wenn Sie das Plugin nicht ausführen können, weil der Befehl fehlt oder das Plugin nicht reagiert: den Diagnosetext kopieren und im selben Chat als Nachricht senden. Die Anwendung erstellt dann denselben Bericht.
-
Die eckige Klammer weglassen oder einen Zusatz anhängen:
version: nur Versionen und einfache Fähigkeitschecks,technik: ergänzt technische Details zu einem vorhandenen Prüflauf,voll: zusätzlich Werkzeugliste und lokale Umgebungsangaben. Enthält das Gespräch bereits eine Prüfung, wertet der Aufruf ohne Zusatz deren Ablauf mit aus.
-
Den Bericht (der Kasten mit dem Text) kopieren und an den Support senden.
Unterstützte Anwendungen
Das Plugin folgt der offenen Agent Plugins Spezifikation und läuft in jeder Anwendung, die sie unterstützt. Getestet und empfohlen ist es mit:
| Anwendung | Empfohlener Modus | Hinweis |
|---|---|---|
| Claude | Claude | Browser (claude.ai) und Desktop-App; Claude Code ist nicht vollständig getestet |
| ChatGPT | Work | nur Desktop-App; im Browser (chatgpt.com) steht die Verbindung des Plugins nicht zur Verfügung |
Welche Tarife Plugins unterstützen, legt der jeweilige Anbieter fest; empfohlen wird ein Tarif mit ausreichender Kapazität. Andere Anwendungen sind nicht getestet; die Nutzung erfolgt auf eigene Verantwortung.
Einrichtung für Organisationen ohne Einzelanmeldung
Für die IT-Administration. Einzelpersonen melden sich wie in der Anleitung ihrer Anwendung beschrieben an.
Organisationen können das Plugin mit einem Organisationstoken für alle Arbeitsplätze anbinden. Dann ist keine Anmeldung der einzelnen Personen nötig. Der Weg hängt von der Anwendung ab:
- Claude Code: Das Plugin liest den Token aus der Umgebungsvariable
EMPCO_MONITOR_TOKENund sendet ihn bei jeder Verbindung zum Server. Ohne Variable meldet sich jede Person einzeln an. - Codex: Das Plugin selbst darf in den Verbindungs-Headern keine Variablen tragen (so legt es die Agent-Plugins-Spezifikation fest). Die IT ergänzt deshalb in der Codex-Konfiguration einen Eintrag für den Server des Plugins, der den Token aus einer Umgebungsvariable liest.
- Claude (Browser und Desktop-App) und ChatGPT: für diesen Weg nicht geprüft; dort meldet sich jede Person einzeln an.
Einrichten
-
Den Organisationstoken beim Support anfordern: https://claims.agent-services.at/support.
-
Die Umgebungsvariable
EMPCO_MONITOR_TOKENmit dem Token als Benutzer- oder Systemvariable auf den Arbeitsplätzen setzen, etwa über die Geräteverwaltung (Jamf, Intune, Gruppenrichtlinie) unter macOS, Windows oder Linux. -
Nur für Codex: In der Konfigurationsdatei
config.tomlvon Codex diesen Eintrag ergänzen. Er trägt denselben Namen wie das Plugin, und Codex führt ihn mit dem Server des Plugins zusammen:[mcp_servers.empco-uwg-monitor] url = "https://claims.agent-services.at/v1/mcp" env_http_headers = { "X-Empco-Token" = "EMPCO_MONITOR_TOKEN" } -
Die Anwendung nach dem Setzen vollständig beenden und wieder öffnen, damit sie die Variable liest.
-
Das Plugin installieren, in Claude und ChatGPT nach deren Anleitung (Claude, ChatGPT). Beim Verbinden des Konnektors ist keine Anmeldung nötig. Zur Prüfung
/diagnose-monitor-pluginstarten: Die Diagnose zeigt die Verbindung zum Regelserver.
Fragt der Konnektor trotz gesetzter Variable nach einer Anmeldung, ist die Variable in der Anwendung nicht angekommen: Anwendung vollständig beenden und wieder öffnen und den Namen der Variable prüfen; bei Codex zusätzlich den Eintrag in config.toml. Sonst den Support kontaktieren.
Rotation und Rückruf: Bei Verlust oder Wechsel stellt der Support einen Ersatz-Token aus und sperrt den abgelösten Token. Danach die Variable auf allen Arbeitsplätzen ersetzen und die Anwendung vollständig beenden und wieder öffnen.
Vertraulichkeit: Der Token gilt für die ganze Organisation. Nicht in Chats, Tickets oder Repositories ablegen und einen Verlust sofort melden. Die Variable ist für Programme auf dem Arbeitsplatz lesbar, auch für Werkzeuge, die die Anwendung dem Assistenten bereitstellt, etwa eine Shell; ein präparierter Text in einem geprüften Dokument könnte versuchen, sie auszugeben. Der Support stellt dann einen neuen Token aus.
Geprüfter Stand (7. Oktober 2026): Mit Claude Code 2.1.272 verbindet sich das Plugin mit gesetzter Variable ohne Anmeldung und fragt ohne Variable nach der Anmeldung. Mit der Codex-CLI 0.156.1 funktioniert der Weg mit dem Eintrag in config.toml; das Plugin allein sendet den Header dort nicht. Claude (Browser und Desktop-App) und die ChatGPT-Desktop-App sind für diesen Weg nicht geprüft.
Technischer Hintergrund
Das Plugin ist ein einziges Paket für Claude, ChatGPT und Codex. Es enthält die Verbindung zum EmpCo-UWG Wissensdatenbank-Server (Model Context Protocol, MCP), über die der Monitor die Prüfregeln abruft, und die Skills, die festlegen, wann und wie er sie abruft. Ohne angemeldete Verbindung steht das Werkzeug fetch_claims_monitor_step nicht zur Verfügung und keine Prüfung ist möglich.
- Öffentliche Dokumentation der Schnittstelle: https://claims.agent-services.at/docs/mcp
- Stand dieser Anleitung: 3. Oktober 2026, geprüft mit Claude (Browser und Desktop-App) und der ChatGPT-Desktop-App.