Fehlerbehebung

Veraltete Tool-Liste, oder ein Tool fehlt

Der Server liefert jedes freigegebene i-Planner-Tool einzeln. tools_search (Funktionen finden) und die Sammelaufrufe tools_read und tools_write ergänzen diese Liste, ersetzen sie aber nicht. Zeigt die App nur diese drei Helfer und die zwei Dokumentations-Tools, kann sie noch die frühere, verkürzte Liste gespeichert haben. Aktualisiere die Tool-Liste in der App; im Einreichungsportal dient dazu der Scan.

Sagt die KI, ein Tool gebe es nicht, oder findet sie nur die Dokumentation und die System-E-Mail:

1. Bitte die KI, mit Funktionen finden zu suchen, auch mit anderen Worten.
2. Bitte eine Administratorin oder einen Administrator, unter Organisation → Einstellungen → KI & Agenten → Werkzeuge die Zeilen der gewünschten Tools zu prüfen: In der Spalte MCP muss Aktiviert stehen. Nicht verfügbar heißt, dass MCP dieses Tool nicht hat oder euer Tarif es nicht enthält.
3. Prüfe, ob deine Rolle MCP nutzen darf (MCP verwenden) und das Recht für den Bereich hat, wie auf der Seite in i-Planner; für E-Mails muss im Postfach Agenten-Zugriff an sein (unter Organisation → Accounts auf der Seite des Postfachs im Abschnitt Erlaubte Nutzung).

Ein neu freigegebenes Tool erscheint bei der nächsten Abfrage der MCP-Liste und wird von der Suche gefunden. Die Verbindung bekommt dadurch keine zusätzlichen Rechte. Wann eine KI-App ihre gespeicherte Liste aktualisiert, bestimmt sie selbst; eine lange Liste einzelner Tools ist kein Fehler.

Ruft die App ein Tool auf, das für dich nicht freigegeben ist, antwortet i-Planner mit tool_not_enabled und organization_or_role, auch über tools_read und tools_write: Unter Werkzeuge ist das Tool für MCP deaktiviert, oder deine Rolle hat es nicht. i-Planner führt es dann nicht aus. Auch ein gefundenes Tool prüft i-Planner bei jedem Aufruf erneut.

„MCP ist in diesem Tarif nicht enthalten“

Der Assistent meldet den Fehler mcp_not_in_plan. Der Tarif deiner Organisation enthält keinen MCP-Zugriff. Ein Wechsel ist unter Organisation → Abrechnung möglich.

„MCP ist für diese Rolle nicht aktiviert“

Der Assistent meldet den Fehler mcp_role_denied. Deine Rolle darf MCP nicht nutzen. Eine Administratorin oder ein Administrator kann das unter Organisation → Einstellungen → Team & Rollen → Benutzerrollen ändern.

Ein Postfach fehlt

Der Assistent sieht nur Postfächer, die dir zugeordnet oder für dich freigegeben sind. Fehlt ein Postfach, prüfe in i-Planner, ob du es dort öffnen kannst. Zum Senden muss das Postfach außerdem auf Senden oder Beides stehen.

Senden klappt nicht

Meldet der Assistent einen Erfolg, ist die E-Mail in der Versandwarteschlange. Ob sie zugestellt wurde, siehst du wie gewohnt im Postfach in i-Planner.

Anfrage zu groß

Eine Anfrage an i-Planner darf höchstens 4 MiB groß sein. Eine größere lehnt i-Planner mit dem HTTP-Status 413 Payload Too Large ab, bevor etwas gelesen oder ausgeführt wird.

Ein einzelner Tool-Aufruf darf höchstens 2.000 Einträge enthalten, Listeneinträge und Felder zusammengezählt. Darüber antwortet das Tool mit einem Fehler und führt nichts aus. Teile große Aufgaben auf mehrere Aufrufe auf.

Anmeldung schlägt fehl oder Verbindung bricht ab

• Melde dich einmal direkt in i-Planner an, um deinen Zugang zu prüfen.
• Widerrufe den Zugriff unter Organisation → Apps → Verbundene Apps mit Zugriff widerrufen und verbinde dich neu.
• Wurde dein Zugang deaktiviert, deine Rolle geändert oder hast du den Assistenten rund 90 Tage nicht genutzt, ist eine neue Anmeldung nötig.

Eigene App-Freigaben verwaltest du in der aktuellen Organisation. Inhaber und ausdrücklich für Apps verwalten berechtigte Administratoren können dort auch Freigaben anderer Mitarbeiter widerrufen, selbst wenn deren Benutzer nicht mehr verfügbar ist.

Häufige Fragen