Democruit-MCP-Fehler beheben und Zugriff widerrufen

Um eine fehlgeschlagene Democruit-MCP-Aufgabe wiederherzustellen, ermitteln Sie zunächst, ob das Problem mit der Autorisierung, den Berechtigungen, den Tool-Eingaben, einem Produktkontingent oder der Anfragehäufigkeit zusammenhängt. Für jedes Problem ist eine andere Lösung erforderlich. Eine erneute Verbindung erhöht kein Tarifkontingent, und ein Upgrade behebt keine fehlende Berechtigung. Um den Zugriff eines Clients zu beenden, öffnen Sie die Democruit-Einstellungen, suchen Sie Verbundene Agenten und wählen Sie Zugriff widerrufen.

Schritt 1: Lesen Sie den Fehler, bevor Sie es erneut versuchen

Notieren Sie den Client, das angeforderte Tool, die Fehlermeldung und ob die Aufgabe bereits ein Ergebnis zurückgegeben hat. Wiederholen Sie keine Schreibanfrage, solange unklar ist, ob sie ausgeführt wurde. Prüfen Sie zuerst das betroffene Dokument oder den Status der Aktion, damit Sie eine verzögerte Antwort nicht mit einer fehlgeschlagenen Änderung verwechseln.

Wählen Sie anhand dieser Tabelle den nächsten Schritt:

Wählen Sie anhand des zurückgegebenen Fehlers die passende Wiederherstellungsmaßnahme, bevor Sie es erneut versuchen.

Schritt 2: Autorisierung wiederherstellen oder Berechtigungen korrigieren

Wenn die Autorisierung fehlt, schließen Sie den OAuth-Anmelde- und Zustimmungsablauf des Clients ab. Vergewissern Sie sich, dass der Endpunkt https://mcp.democruit.com/mcp lautet und Sie das gewünschte Konto verbinden. Die Anleitung zum Verbinden von Claude, ChatGPT und Gemini beschreibt die Einrichtung für jeden Client. Wenn der Server in Gemini CLI eine Autorisierung benötigt, verwenden Sie /mcp auth democruit und schließen Sie anschließend die Anmeldung im Browser ab.

Zugriffstoken sind eine Stunde lang gültig. Ein Client kann den Zugriff erneuern, solange sein Aktualisierungstoken gültig ist. Eine einstündige Gültigkeitsdauer des Zugriffstokens bedeutet daher nicht unbedingt, dass Sie sich jede Stunde anmelden müssen. Aktualisierungstoken sind mit offline_access gleitend 30 Tage und absolut 90 Tage gültig, ohne diesen Berechtigungsbereich gleitend sieben Tage und absolut 30 Tage.

Wenn das Aktualisierungstoken abgelaufen oder die Verbindung widerrufen wurde, autorisieren Sie sie erneut. Autorisierungscodes sind fünf Minuten lang gültig. Starten Sie die Anmeldung neu, wenn ein noch nicht abgeschlossener Codeaustausch abläuft. Fügen Sie keine Token in einen Chat ein, um einen Autorisierungsfehler zu umgehen.

Prüfen Sie bei FORBIDDEN die erforderlichen Berechtigungen des Tools und die dem Client erteilten Berechtigungsbereiche. Lese- und Schreibberechtigungen sind je nach Produktbereich getrennt. Ein kombinierter Workflow für das Anwendungspaket erfordert Schreibberechtigungen für Lebenslauf, Anschreiben und ATS. Für eine Verbindung, die nur eine kleinere Aufgabe ausführen soll, sind möglicherweise nicht alle erforderlich. Fordern Sie nur den Zugriff an, den Sie für die geplante Arbeit benötigen.

Schritt 3: Tool-Eingaben korrigieren

Bitten Sie den Assistenten bei INVALID_ARGUMENTS, die Eingabeanforderungen des Tools zu prüfen und fehlende Angaben zu ermitteln. Geben Sie den ausgewählten Dokumentverweis, die Stellenbeschreibung oder andere angeforderte Informationen an. Lassen Sie den Assistenten keine Berufserfahrung erfinden oder ein Dokument allein aufgrund eines unsicheren Titels auswählen.

Eine fehlende Eingabe ist kein Abrechnungsproblem. Ergänzen Sie diese Eingabe, bevor Sie eine Tarifänderung in Erwägung ziehen. Lesen Sie bei TOOL_EXECUTION_FAILED die zurückgegebene Erklärung und prüfen Sie, ob ein Dokument oder eine ausstehende Aktion existiert, bevor Sie einen weiteren Schreibvorgang starten.

Schritt 4: Produktkontingent und Upgrade-Link prüfen

Ein Produktkontingent begrenzt die Nutzung von Funktionen im Rahmen Ihres Democruit-Tarifs. Für MCP gelten dieselben Tarifkontingente wie für die App. Wenn ein Tool ein Tariflimit meldet, prüfen Sie die Nutzung der betroffenen Funktion in Ihrem Konto. Vergleichen Sie die verfügbaren Kontingente unter Democruit-Preise, bevor Sie sich für ein Upgrade entscheiden.

Die verfügbaren Funktionen und Kontingente hängen von Ihrem aktuellen Tarif ab. Gehen Sie nicht davon aus, dass jede App-Funktion über ein MCP-Tool verfügt oder dass eine erneute Verbindung, das Löschen eines Dokuments oder eine Minute Wartezeit ein bereits verbrauchtes KI-Kontingent wiederherstellt.

Beispielsweise setzt das erneute Verbinden von Claude ein ausgeschöpftes ATS-Prüfungskontingent nicht zurück. Prüfen Sie Ihre ATS-Nutzung und die aktuellen Tarife, bevor Sie entscheiden, wie Sie fortfahren. Prüfen Sie nach einem Upgrade die Kontonutzung und wiederholen Sie den gewünschten Vorgang einmal. Wenn er weiterhin blockiert ist, wenden Sie sich mit dem zurückgegebenen Fehler an den Support.

Schritt 5: Bei einer Ratenbegrenzung weniger Anfragen senden

Das standardmäßige API-Ratenlimit beträgt 500 Anfragen pro Minute. Das ist dasselbe Standardlimit wie in der Democruit-App. Für OAuth-Registrierungs- und Token-Endpunkte gelten eigene, strengere Limits. Der Wert von 500 Anfragen ist daher kein Kontingent für wiederholte schnelle Anmeldeversuche. Reduzieren Sie wiederholte Anfragen, insbesondere häufige Statusabfragen, während eine Aufgabe wartet. Ein HTTP-429 bedeutet, dass zu viele Anfragen gesendet wurden. Halten Sie sich an eine angegebene Wartezeit und verlangsamen Sie Ihre Anfragen, bevor Sie es erneut versuchen. Ein Kontingent- oder Ratenbegrenzungsfehler kann auch innerhalb von TOOL_EXECUTION_FAILED auftreten. Lesen Sie daher die Erklärung, statt sich nur auf diesen allgemeinen Fehlercode zu verlassen.

Das Warten auf ein Zeitfenster für die Ratenbegrenzung füllt kein ausgeschöpftes Produktkontingent wieder auf. Einer Verbindung kann noch Funktionskontingent zur Verfügung stehen, obwohl sie Anfragen zu schnell sendet. Prüfen Sie, welches Limit in der Fehlermeldung tatsächlich beschrieben wird.

Eine gekürzte Antwort ist ein anderer Fall. Umfangreiche Antworten werden in Gruppen zu je 20 Elementen paginiert oder zusammengefasst, sofern detail=true nicht angegeben ist. Fahren Sie mit den zurückgegebenen Seiteninformationen fort oder fordern Sie Details an, wenn die Aufgabe den vollständigen Inhalt erfordert. Eine kurze Seite allein weist nicht auf einen Kontingentfehler hin.

Schritt 6: Ausstehende Bestätigung oder abgelaufenen Upload bearbeiten

Destruktive Tools warten auf eine Bestätigung im Democruit-Dashboard. Öffnen Sie den zurückgegebenen Link und prüfen Sie die genaue Aktion. Der Assistent kann get_action_status abfragen. Er sollte eine Löschung nicht als abgeschlossen melden, solange die Genehmigung noch aussteht.

Eine ausstehende Bestätigung ist kein Fehler. Über den zurückgegebenen Genehmigungslink wird die Aktion in Democruit geöffnet. Prüfen Sie das Ziel, bevor Sie die Aktion genehmigen. Eine abgelehnte Aktion meldet DENIED, eine nicht entschiedene Aktion läuft schließlich mit dem Status EXPIRED ab.

Die Bestätigung läuft nach zehn Minuten ab. Wenn Sie die Aktion nach Ablauf weiterhin ausführen möchten, starten Sie eine neue Bestätigungsanfrage und prüfen Sie sie erneut. Auch Uploads sind zehn Minuten lang gültig und dürfen maximal 10 MB groß sein. Für den Lebenslaufimport und den ATS-Upload wird nur PDF akzeptiert. Erstellen Sie einen neuen Upload, wenn der vorherige abläuft, und verwenden Sie den angeforderten Dateityp sowie die genaue Dateigröße.

Schritt 7: Verbindung trennen und Zugriff widerrufen

1. Öffnen Sie die Democruit-Kontoeinstellungen.
2. Suchen Sie den Client unter Verbundene Agenten und prüfen Sie die aufgeführten Berechtigungsbereiche.
3. Wählen Sie bei der Verbindung, die Sie beenden möchten, Zugriff widerrufen.
4. Warten Sie auf die erfolgreiche Bestätigung des Widerrufs. Wenn die Einstellungsseite einen Fehler meldet, versuchen Sie es dort erneut oder wenden Sie sich an den Support.
5. Entfernen oder deaktivieren Sie den Democruit-Server in Ihrem KI-Client, wenn dieser keine Tools mehr anbieten oder zur Anmeldung auffordern soll.
6. Wenn Sie den Client später erneut verbinden, schließen Sie die Autorisierung ab und prüfen Sie die angeforderten Berechtigungsbereiche erneut.

Widerrufen Sie die Berechtigungsnachweise in Democruit und entfernen Sie den Server aus Ihrem Client, wenn Sie ihn nicht mehr verwenden.

Durch den Widerruf werden die Autorisierungsfreigabe, Zugriffstoken und Aktualisierungstoken des Clients für Ihr Konto deaktiviert. Das Entfernen eines Servereintrags aus dem Client ist ein separater Konfigurationsschritt. Verwenden Sie die Democruit-Steuerung Zugriff widerrufen, um die Berechtigungsnachweise ungültig zu machen.

Durch den Widerruf bleibt Ihr Democruit-Konto mit seinen Dokumenten bestehen. Er verhindert, dass künftig autorisierte Anfragen mit diesen Berechtigungsnachweisen gestellt werden. Wenn der KI-Client bereits Inhalte erhalten hat, prüfen Sie dessen Verlauf und Datenschutzeinstellungen. Dieser Widerruf legt keine Lösch- oder Aufbewahrungsregeln für einen anderen Dienst fest. Weitere Informationen zu den veröffentlichten Datenpraktiken von Democruit finden Sie in der Datenschutzerklärung.

Wenn die Aufgabe weiterhin blockiert ist

Wenden Sie sich unter [email protected] an den Support und nennen Sie den Clientnamen, den Toolnamen und die Fehlermeldung. Beschreiben Sie, ob Sie sich angemeldet, ein Dokument gelesen, eine Änderung gespeichert oder auf eine Bestätigung gewartet haben. Geben Sie in Ihrer Supportnachricht keine Passwörter, Token oder vertraulichen Dokumentinhalte an.