# Fehlerbehebung bei Verbindungen

> Abgelaufene Tokens, widerrufener Zugriff, das falsche Konto und Berechtigungsfehler – woran du sie erkennst und wie du sie behebst.

Ein Connector, der gestern noch lief und heute scheitert, ist meist über eine von fünf Ursachen gestolpert. Diese Seite ist die Kurzliste, in der Reihenfolge, in der sie auftreten.

## Hier anfangen

Öffne die Connectors des Agenten im [Agent Builder](/de/docs/build/agent-builder/). Eine Verbindung, die Aufmerksamkeit braucht, ist dort markiert, und die Lösung ist fast immer, sie erneut zu autorisieren.

**Erneutes Autorisieren behält deine Zuweisungen.** Verbindest du denselben Dienst mit demselben Konto, wird die bestehende Verbindung neu autorisiert, statt eine zweite anzulegen. Du musst sie danach also nicht jedem Agenten neu zuweisen.

## Die fünf Ursachen

### Die Autorisierung ist abgelaufen

Anbieter lassen den Zugriff nach einer gewissen Zeit ablaufen, manche schnell, manche erst nach Monaten. Die Verbindung wird dann mit dem Hinweis markiert, dass sie neu autorisiert werden muss, und die Tools des Agenten für diesen Dienst funktionieren nicht mehr.

**Lösung:** Verbinde dich erneut mit demselben Konto.

### Der Zugriff wurde beim Anbieter widerrufen

Jemand hat endue in den Einstellungen des Google-Kontos entfernt, die Slack-App deinstalliert oder das API-Token gelöscht. endue kann das erst beim nächsten Aufrufversuch von einem Ablauf unterscheiden.

**Lösung:** Autorisiere erneut oder erstelle ein neues Token und verbinde dich neu. War der Widerruf gewollt, entferne die Verbindung auch in endue, damit der Zustand stimmt.

### Du hast das falsche Konto verbunden

Der Klassiker: Du warst mit einem privaten Google-Konto angemeldet, als du einen Connector für die Arbeit autorisiert hast. Es gibt keinen Fehler, aber der Agent findet nichts, weil er im falschen Posteingang sucht.

**Lösung:** Melde dich beim Anbieter vom falschen Konto ab oder nutze ein privates Fenster und verbinde dich erneut mit dem gewünschten Konto. Prüfe, bevor du zustimmst, welches Konto der Zustimmungsbildschirm anzeigt.

### Dem Agenten fehlt der Zugriff auf die konkrete Ressource

Die Verbindung ist in Ordnung, aber die Ressource ist nicht mit ihr geteilt.

| Dienst | Symptom | Lösung |
| --- | --- | --- |
| **Slack** | „Nicht im Kanal“ beim Lesen des Verlaufs | Lade die App in Slack in diesen Kanal ein |
| **Notion** | Die Suche findet eine Seite nicht, die du sehen kannst | Teile die Seite in Notion mit der Integration |
| **GitLab** | Ein Projekt oder Issue wird als nicht gefunden gemeldet | Der Benutzer des Tokens hat eventuell keinen Zugriff. Prüfe die Berechtigungen, nicht die Schreibweise |
| **Google** | Eine Datei wird nicht gefunden | Das verbundene Konto hat eventuell keinen Zugriff darauf |

<Aside type="note" title="„Nicht gefunden“ heißt oft „nicht erlaubt“">
  Mehrere Anbieter melden bei Dingen, die du nicht sehen darfst, „nicht gefunden“ statt
  „nicht erlaubt“, um nicht zu verraten, dass es sie gibt. Behandle ein „nicht gefunden“
  bei etwas, das es sicher gibt, zuerst als Berechtigungsproblem.
</Aside>

### Ein selbst gehosteter Dienst ist umgezogen oder nicht erreichbar

Connectors, die nach einer Adresse fragen (GitLab, Jenkins, Discourse, WordPress, Mattermost, Grafana, Elasticsearch), brauchen eine Adresse, die aus dem Internet erreichbar ist.

**Lösung:** Prüfe, ob die Adresse stimmt und öffentlich erreichbar ist, und verbinde dich dann neu. Ein Dienst hinter einem VPN ist nicht erreichbar.

## Wenn der Connector funktioniert und der Agent trotzdem scheitert

- **Die Operation gibt es nicht.** Jeder Connector bietet einen festen Satz an Operationen, siehe [Verfügbare Connectors](/de/docs/connect/available-connectors/). Ein Agent kann keinen Teil der API eines Anbieters nutzen, den endue nicht anbietet.
- **Die Verbindung ist *diesem* Agenten nicht zugewiesen.** Verbinden geschieht auf Kontoebene, Nutzen pro Agent.
- **Die Tool-Gruppe ist ausgeschaltet.** Prüfe die [integrierten Tools](/de/docs/capabilities/built-in-tools/) des Agenten, wenn die fehlende Fähigkeit Gedächtnis, Outputs, Routinen oder Webabruf ist und kein Connector.
- **Die Aktion wurde an der Schranke für [Freigaben](/de/docs/work/approvals/) abgelehnt**, auch automatisch, wenn die Ausführung unbeaufsichtigt lief.

## Eine Verbindung entfernen

Entfernst du sie in endue, verlieren alle Agenten, denen sie zugewiesen ist, diese Tools sofort. Bestehende Unterhaltungen behalten ihren Verlauf, aber der Agent kann diese Aufrufe nicht mehr ausführen.

Eine Verbindung in endue zu entfernen, widerruft den Zugriff von endue beim Anbieter nicht. Für einen sauberen Schnitt erledige beides.

## Siehe auch

<CardGrid>
  <LinkCard
    title="Connectors im Überblick"
    href="/de/docs/connect/overview/"
    description="Wie Verbinden, Zuweisen und Widerrufen zusammenhängen."
  />
  <LinkCard
    title="Fehlerbehebung"
    href="/de/docs/troubleshooting/"
    description="Probleme, die nichts mit Verbindungen zu tun haben."
  />
  <LinkCard
    title="Sicherheit und Berechtigungen"
    href="/de/docs/account/security/"
    description="Was ein Agent erreichen kann und was nicht."
  />
</CardGrid>