# Häufige Probleme

> Was du tust, wenn der Assistent sich nicht verbindet, die Verbindung verliert, ein Tool nicht anzeigt, in der falschen Community handelt oder eine Geld-Bestätigung ablehnt, und was MCP noch nicht kann.

Die häufigsten Probleme mit MCP, mit Ursache und Lösung. Die Schritt-für-Schritt-Anleitung für jeden Assistenten findest du unter [Claude verbinden](/mcp/conectar-o-claude), [ChatGPT verbinden](/mcp/conectar-o-chatgpt) und [Claude Code und Cursor verbinden](/mcp/conectar-claude-code-e-cursor).

## Die Verbindung

### „Nicht autorisiert", 401 oder „Token abgelaufen"

Der Assistent hat keinen gültigen Schlüssel.

| Ursache | Was du tust |
|---|---|
| Die Autorisierung wurde nicht abgeschlossen (das Fenster wurde vor **Erlauben** geschlossen) | Verbinde über den Assistenten neu |
| Du hast unter **Mein Konto › KI-Assistenten** getrennt, oder ein Administrator unter **Einstellungen** | Verbinde neu, falls sinnvoll |
| Die Verbindung war mehr als 30 Tage ungenutzt | Verbinde neu |
| Du hast die Community verlassen | Die Verbindung taugt nicht mehr; bitte darum, wieder aufgenommen zu werden |
| Memberfy hat die Verbindung aus Sicherheitsgründen beendet (ein bereits genutzter Schlüssel tauchte erneut auf) | Verbinde neu. Passiert es wieder, entferne den Connector und füge ihn neu hinzu |

Der Zugriffsschlüssel gilt 1 Stunde und wird automatisch erneuert; fragt der Assistent oft nach einer neuen Verbindung, entferne den Connector und füge ihn erneut hinzu.

### *„Diese Zugriffsanfrage ist ungültig"*

Der Autorisierungsbildschirm hat eine unvollständige Anfrage erhalten, oder eine mit einer Rückleitungsadresse, die nicht passt. Entferne den Connector im Assistenten, füge ihn erneut hinzu und verbinde.

### Die Community erscheint nicht auf dem Autorisierungsbildschirm

Das Konto, mit dem du angemeldet bist, ist dort kein Mitglied. Melde dich im Browser von Memberfy ab und mit dem richtigen Konto an, bevor du verbindest.

## Die Tools

### Ein Tool erscheint nicht

Der Assistent sieht nur die Tools, die deine Rolle nutzen darf. Ein Moderator sieht `create_plan` nicht; ein Mitglied nicht `list_members`; Finanzen nicht `request_payout`. Prüf deine Rolle mit *„in welcher Community und mit welcher Rolle bist du?"* und vergleiche mit [Tools](/mcp/ferramentas#wie-viele-jede-rolle-sieht).

Weitere Ursachen:

- Die Verbindung wurde **nur zum Lesen** autorisiert: Erstell- und Geld-Tools erscheinen nicht. Verbinde neu mit Lesen und Schreiben.
- Der Connector ist im Gespräch ausgeschaltet (Claude) oder nicht ausgewählt (ChatGPT).

### Der Assistent nutzt alte Namen wie `criar_post`

Am 6. Oktober 2026 haben die Tools englische Namen bekommen (`create_post`, `list_spaces`, `issue_certificate`). Ein Gespräch, das vorher geöffnet wurde, kann noch die alte Liste haben, und der Aufruf schlägt fehl, weil es das Tool nicht mehr gibt. Öffne ein **neues Gespräch**; wenn das nicht hilft, verbinde den Connector neu. Die aktuellen Namen stehen unter [Werkzeuge](/mcp/ferramentas).

### Ein Werkzeug fehlt, oder der Assistent sagt, dass es nicht existiert

Manche Assistenten behalten die Werkzeugliste von Memberfy vom Anfang des Gesprächs. Hat Memberfy den Server danach aktualisiert, arbeitet der Assistent mit der alten Liste weiter: Er sieht ein neues Werkzeug nicht oder versucht, eines zu nutzen, das umbenannt wurde.

1. Öffne ein **neues Gespräch**.
2. Wenn das nicht hilft, trenne den Memberfy-Connector im Assistenten und verbinde ihn neu.

Versucht der Assistent, ein umbenanntes Werkzeug oder eines außerhalb seiner Liste zu nutzen, sagt Memberfy das direkt in der Antwort: Es nennt den neuen Namen oder bittet darum, ein neues Gespräch zu öffnen oder neu zu verbinden.

Inhaber und Admins der Community können sehen, welche Version der Liste jede Verbindung bekommen hat und ob sie aktuell ist. Vorerst steht das in der API, in der [Verbindungsdiagnose](/api/referencia/mcp/get-oauth-connections-by-id-diagnostics), noch ohne Bildschirm im Dashboard. Siehe [Version des Servers und der Liste](/mcp/ferramentas#version-des-servers-und-der-liste).

### *„Deine Rolle (…) erlaubt diese Aktion in dieser Community nicht."*

Das Tool erscheint, aber diese konkrete Aktion wird abgelehnt. Beispiele:

- ein Mitglied, das in einem Bereich mit **Wer posten darf = Team** postet;
- ein Moderator, der `create_event` mit Ticket nutzt oder ohne einen bestehenden Bereich anzugeben;
- eine Aktion in einem Bereich, den deine Rolle nicht sieht.

### *„Die API hat abgelehnt (400): …"*

Ein ungültiger Wert: ein Preis von null, ein zu kurzer Titel, ein Datum ohne Zeitzone, die ID von etwas anderem. Die Meldung nennt das Feld. Bitte den Assistenten, es zu korrigieren und erneut zu versuchen.

### Ein kombiniertes Tool ist mittendrin fehlgeschlagen

Die Antwort sagt, welcher Schritt fehlgeschlagen ist und dass alles rückgängig gemacht wurde. Behebe die Ursache (nutze zum Beispiel einen Bereich mit dem richtigen Modul) und frag erneut. Sagt die Antwort, dass etwas **nicht** rückgängig gemacht werden konnte, prüf den genannten Eintrag im Dashboard und lösche ihn von Hand.

### *„Zu viele Aufrufe in kurzer Zeit"*

Die Grenze liegt bei 120 Tool-Aufrufen pro Minute und Verbindung. Das passiert bei großen Anfragen (auf 200 Kommentare auf einmal antworten). Warte eine Minute, oder frag in Teilen.

## Die falsche Community

Der Assistent hat etwas in der falschen Community angelegt, weil er mit ihr verbunden war. Jede Verbindung gehört zu genau einer Community.

1. Frag: *„mit welcher Community bist du verbunden?"*.
2. Schalte im Gespräch den Connector der falschen Community aus und den der richtigen ein. Gibt es keinen, lege eine [Verbindung für die andere Community](/mcp/autorizar-e-desconectar#community-wechseln) an.
3. Lösche im Dashboard, was am falschen Ort angelegt wurde (es gibt kein Lösch-Tool).

Zur Vorbeugung: Gib den Connectors klare Namen (*Memberfy · Schule*, *Memberfy · Coworking*) und lass pro Gespräch nur einen eingeschaltet.

## Die Bestätigung bei Geld und Löschen

### *„Bestätigung ungültig, abgelaufen, bereits verwendet oder mit anderen Argumenten"*

| Ursache | Was du tust |
|---|---|
| Zwischen Zusammenfassung und deinem Ja lagen mehr als 10 Minuten | Frag erneut: Der Assistent erstellt eine neue Zusammenfassung |
| Der Assistent hat beim zweiten Aufruf einen Wert geändert | Frag erneut; prüf, ob die neue Zusammenfassung die richtigen Werte hat |
| Der Code wurde schon benutzt (die Aktion ist schon passiert) | Prüf im Dashboard, bevor du erneut fragst, damit nichts doppelt passiert |

### Der Assistent hat ohne Nachfrage ausgeführt

Die Geld- und Lösch-Tools liefern immer zuerst eine Zusammenfassung. Hat der Assistent weitergemacht, ohne sie zu zeigen, hat er die Anweisungen nicht befolgt. Prüf im Dashboard, was passiert ist, trenne und verbinde neu, und sag zu Beginn des Gesprächs ausdrücklich: *„zeig mir immer die Zusammenfassung, bevor du irgendetwas mit Geld oder Löschen bestätigst"*.

Einladungen, Rollenwechsel, Einstellungen und das Ausstellen von Zertifikaten brauchen **keine** Bestätigung von Memberfy: Sie laufen beim ersten Aufruf. Wenn du vorher prüfen willst, bitte *„zeig es mir, bevor du es machst“*, und lass diese Tools in den Berechtigungen des Assistenten auf „vorher fragen“.

## Was noch nicht geht

MCP deckt noch nicht alles ab, was das Dashboard kann. Folgendes kommt später und bleibt bis dahin im Dashboard:

| Geht noch nicht | Bis dahin |
|---|---|
| Den Inhalt einer Lektion speichern (Text, Video) | Der Assistent legt die Lektion mit Titel, Typ und Dauer an; der Inhalt kommt über das Dashboard |
| Module und Lektionen bearbeiten oder löschen | Im Dashboard |
| Einen Beitrag planen | Der Beitrag erscheint sofort |
| Ticketkäufer auf die Teilnehmerliste setzen | Der Kauf schaltet den Bereich frei; die Zusage macht die Person selbst |
| Erstatten | Im Dashboard |
| Den Plan eines anderen Abonnenten wechseln | Nur wer abonniert, wechselt den eigenen Plan, in der [Abrechnung](/pagamentos/faturamento-do-membro#plan-wechseln) oder mit `change_my_plan` |
| Mehrere Einträge in einem Aufruf moderieren | Der Assistent moderiert einen Eintrag nach dem anderen, mit `moderate_item` |
| Domain, Sprache und Integrationen der Community ändern | Im Dashboard |
| Irgendetwas löschen | Im Dashboard |

## Verwandte Artikel

- [MCP im Überblick](/mcp/o-que-e-o-mcp)
- [Sicherheit und Grenzen](/mcp/seguranca)
- [Tools](/mcp/ferramentas)
