Fehlerbehebung
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 AccountConnected apps, verbinden sich erneut und erlauben den Vollzugriff. Mit einem API-Schlüssel verwenden Sie einen Schlüssel mit Vollzugriff.
Ä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 AccountConnected 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.
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.
Eine E-Mail wird abgelehnt
Der Absender muss eine verifizierte Versanddomain 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 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.
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 ü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 oder schreiben Sie an support@emailit.com, mit dem Namen des Clients, dem fehlgeschlagenen Tool und dem Fehlertext.