# MCP-Fehlerbehebung

> Beheben Sie häufige Probleme mit dem Emailit-MCP-Server, von der Anmeldung und fehlenden Scopes bis zu falschen Workspaces, Admin-Tools und Clients, die zu viele Tools laden.

Fragen Sie Ihren Assistenten zuerst: „Mit welchem Emailit-Workspace bin ich verbunden?“ Er ruft `get-current-workspace` auf und nennt Ihnen den Workspace, Ihre Rolle und den gewährten Zugriff; das erklärt die meisten der folgenden Probleme.

## Die Anmeldeseite meldet, dass der Client unbekannt ist

Die Client-Registrierung ist veraltet. Entfernen Sie den Emailit-Server aus Ihrem KI-Tool und fügen Sie ihn erneut hinzu, damit er einen neuen Client registriert.

## Ein Tool meldet, dass es Vollzugriff braucht

Die Verbindung wurde nur mit dem Scope `sending` freigegeben. Clients, die Step-up-Autorisierung unterstützen, etwa ChatGPT, zeigen den Freigabebildschirm erneut an: Erlauben Sie dort Zugriff mit **full**. Bei anderen Clients widerrufen Sie die Verbindung unter **Account → Connected apps**, verbinden sich erneut und erlauben den Vollzugriff. Mit einem API-Schlüssel verwenden Sie einen [Schlüssel mit Vollzugriff](/de/docs/developers/api-keys/).

## Änderungen erfolgen im falschen Workspace

Nennen Sie den Workspace in Ihrer Anfrage, zum Beispiel „In Marketing die Domains auflisten“, oder lassen Sie den Assistenten wechseln: „Zu meinem Workspace Marketing wechseln“. API-Schlüssel wirken immer im Workspace, zu dem sie gehören.

## Ein Workspace fehlt

Die Verbindung umfasst nur die Workspaces, die Sie erlaubt haben. Öffnen Sie **Account → Connected apps**, wählen Sie **Edit access** und fügen Sie ihn hinzu oder wählen Sie **All workspaces**. Wenn Sie aus dem Workspace entfernt wurden, bitten Sie einen Admin, Sie erneut einzuladen.

## Ein Tool meldet, dass es die Rolle Admin braucht

Der Fehler `admin_role_required` bedeutet, dass Sie in diesem Workspace die Rolle Member haben und das Tool API-Schlüssel verwaltet oder eine Domain löscht. Bitten Sie einen Admin des Workspaces, das zu erledigen oder [Ihre Rolle zu ändern](/de/docs/workspaces/members-and-roles/).

## Der Client zeigt zu viele Tools an oder kann sie nicht laden

Manche Clients begrenzen die Anzahl der Tools. Laden Sie mit `?toolsets=` in der Server-URL oder dem Header `X-MCP-Toolsets` nur, was Sie brauchen, zum Beispiel `https://api.emailit.com/mcp?toolsets=emails,domains`. Siehe [Toolsets und Nur-Lesen-Modus](/de/docs/mcp/toolsets/).

## Eine E-Mail wird abgelehnt

Der Absender muss eine [verifizierte Versanddomain](/de/docs/domains/verification/) verwenden. Lassen Sie den Assistenten die Domain mit `get-domain` prüfen, fehlende Einträge anlegen und `verify-domain` ausführen. Solange Ihr Workspace keinen [Produktionszugang](/de/docs/workspaces/production-access/) hat, können Sie nur an die Konto-E-Mail-Adressen von Workspace-Mitgliedern senden.

## Erneutes Senden schlägt fehl

Nur gebouncte, fehlgeschlagene, gesperrte oder zurückgehaltene E-Mails lassen sich erneut senden, innerhalb von 30 Tagen und solange ihr Inhalt noch gespeichert ist. Siehe [Erneut senden und weiterleiten](/de/docs/email-api/retry-and-forward/).

## Der Client zeigt „Method not allowed“

Der Server ist zustandslos und akzeptiert nur `POST`-Anfragen. Aktualisieren Sie Ihren Client auf eine Version, die den Transport Streamable HTTP unterstützt, oder verwenden Sie den [lokalen Server](/de/docs/mcp/local-server/) über stdio.

## Der Client fordert Sie immer wieder zur Anmeldung auf

Das Refresh-Token ist nach 60 Tagen ohne Nutzung abgelaufen oder wurde wiederverwendet, oder die Verbindung wurde widerrufen. Melden Sie sich im Client erneut an. Wenn das wiederholt passiert, stellen Sie sicher, dass immer nur eine Instanz des Clients die Verbindung nutzt.

## Weiterhin Probleme?

Fragen Sie auf [Discord](https://discord.emailit.com) oder schreiben Sie an [support@emailit.com](mailto:support@emailit.com), mit dem Namen des Clients, dem fehlgeschlagenen Tool und dem Fehlertext.

---
Quelle: https://emailit.com/de/docs/mcp/troubleshooting/