--- title: "Probleme mit KI-Agenten-Verbindungen beheben | Metaintro" canonical: "https://www.metaintro.com/de/help/ai-agent-troubleshooting" language: "de" author: "Metaintro" published: "2026-10-20T20:26:12.823Z" modified: "2026-10-20T23:52:05.311Z" --- # Probleme mit KI-Agenten-Verbindungen beheben Häufige Probleme beim Verbinden eines KI-Agenten mit Metaintro lösen: Anmeldung, Nur-Lese-Zugriff, Organisationszugriff, Limits und fehlgeschlagene Aktionen. Letzte Aktualisierung: October 20, 2026[Fehlerbehebung](/de/help/category/troubleshooting) Füge es in Claude, ChatGPT, Codex, Cursor oder Pi ein. ## Der Agent kann sich nicht anmelden Wenn Ihre KI-App einen Anmeldefehler anzeigt oder immer wieder zum Verbinden auffordert: 1. Starten Sie die Verbindung in Ihrer KI-App neu. Geben Sie in Claude Code `/mcp` ein, wählen Sie die Metaintro-Verbindung und melden Sie sich erneut an. 2. Achten Sie darauf, sich mit dem Metaintro-Konto anzumelden, das der Agent nutzen soll. 3. Wählen Sie auf der Metaintro-Seite, die sich öffnet, **Erlauben**. Sehen Sie „Dieser Link ist abgelaufen“, gehen Sie zurück zu Ihrer KI-App und beginnen Sie von vorn. 4. Prüfen Sie die hinzugefügte Adresse. Sie sollte genau `https://www.metaintro.com/api/mcp` lauten, bzw. `https://www.metaintro.com/api/mcp/org/` für eine Organisation. **Erste Schritte** unter Einstellungen > Agenten oder im Tab **Meine KI-Agenten** in den Einstellungen Ihrer Organisation zeigt die richtige Adresse mit einer Schaltfläche zum Kopieren. Wenn Sie sich mit einem persönlichen Schlüssel verbunden haben, sieht der Agent möglicherweise: "Sign in through your AI client, or send a Metaintro personal API key…". Das bedeutet, dass der Schlüssel fehlt, falsch eingegeben, abgelaufen oder getrennt ist. Schlüssel gelten 90 Tage. Öffnen Sie unter [Einstellungen > Agenten](/settings/agents) in den **Ersten Schritten** den Tab **Andere Apps**, wählen Sie **API-Schlüssel erstellen** und aktualisieren Sie die Einrichtung Ihrer App. Führen Sie in Codex `codex mcp login metaintro` aus, in Pi `pi mcp login metaintro`. Für eine Organisation verwenden Sie den Namen ihrer Verbindung, etwa `metaintro-`. Mit der Erweiterung pi-mcp-adapter melden Sie sich stattdessen in Pi mit `/mcp-auth metaintro` an. Ob die App verbunden ist, zeigt `codex mcp list` oder `pi mcp list`. ## Der Agent kann lesen, aber nichts ändern Meldet der Agent **insufficient scope** oder sagt er, dass er keine Änderungen vornehmen kann, ist er als **Nur lesen** verbunden: **Ihre verbundenen Agenten** zeigt **Nur lesen** neben ihm an. Trennen Sie ihn und verbinden Sie ihn erneut. Bei einem API-Schlüssel wählen Sie unter **Was er tun darf** die Option **Lesen und handeln**. Wenn Sie sich über Ihre App anmelden, prüfen Sie, ob die Metaintro-Seite Änderungen in Ihrem Namen auflistet, bevor Sie **Erlauben** wählen. Lautet die Meldung "This credential cannot use the MCP server", wurde der Schlüssel ohne Agentenzugriff erstellt. Wählen Sie **API-Schlüssel erstellen** im Tab **Andere Apps** unter Einstellungen > Agenten, oder melden Sie sich erneut über Ihre KI-App an und erlauben Sie den Zugriff. ## "Organization keys name no person to act as" Organisations-API-Schlüssel (`mi_org_…`) können nicht mit KI-Agenten verwendet werden. Ein Agent handelt immer als eine bestimmte Person, damit jede Änderung unter einem Namen erfasst wird. Verwenden Sie einen persönlichen Schlüssel aus Einstellungen > Agenten oder melden Sie sich über Ihre KI-App an. ## "You aren't on this organization's staff" Die Verbindung einer Organisation (`/api/mcp/org/`) funktioniert nur für Personen mit einer Team-Rolle in dieser Organisation. Wenn Sie diese Meldung sehen: - Prüfen Sie den Namen der Organisation in der Adresse. - Fragen Sie einen Admin der Organisation, ob Sie eine Team-Rolle haben. Nur das Team sieht den Tab **Meine KI-Agenten** in den Einstellungen der Organisation. - Für Ihre eigene Jobsuche verwenden Sie die persönliche Adresse `https://www.metaintro.com/api/mcp`. ## "This connection only reaches…" Die Verbindung einer Organisation funktioniert nur in dieser Organisation. Versucht der Agent, mit einer anderen Organisation zu arbeiten, wird das abgelehnt. Fügen Sie über den Tab **Meine KI-Agenten** in den Einstellungen der anderen Organisation eine eigene Verbindung hinzu. ## Der Agent findet keine Werkzeuge für das Fallmanagement Die persönliche Verbindung reicht nur bis zu Ihrer eigenen Jobsuche. Um mit den Mitgliedern einer Organisation zu arbeiten, verbinden Sie sich mit der Adresse dieser Organisation. Siehe [KI-Agenten im Fallmanagement nutzen](/help/ai-agents-for-case-managers). ## "Too many calls from this key. Try again in N seconds." Damit Metaintro für alle schnell bleibt, hat jede Verbindung Limits pro Minute für Lesezugriffe, Änderungen, Cabinet-Anfragen und Gespräche mit dem Assistenten. Warten Sie die angezeigte Anzahl Sekunden und versuchen Sie es dann erneut. Passiert das häufig, bitten Sie Ihren Agenten, weniger, dafür größere Anfragen zu stellen. "Too many requests" oder "Metaintro is temporarily unavailable" löst sich meist innerhalb einer Minute. ## Eine Aktion wartet auf Genehmigung Sagt der Agent, dass eine Aktion **auf Genehmigung wartet**, hängt er nicht fest. Genehmigen oder lehnen Sie sie unter **Wartet auf Ihre Genehmigung** in Einstellungen > Agenten ab, oder im Tab **Meine KI-Agenten** in den Einstellungen Ihrer Organisation, wenn sie über die Verbindung dieser Organisation kam. Anfragen verfallen nach 7 Tagen. Siehe [Aktionen Ihres KI-Agenten genehmigen](/help/ai-agent-approvals). ## Eine Aktion ist nach Ihrer Genehmigung fehlgeschlagen Sehen Sie „Genehmigt, aber die Aktion ist fehlgeschlagen“, bitten Sie Ihren Agenten, die Anfrage zu prüfen. Er kann den Grund mit seinem Werkzeug für den Anfragestatus (`get_action_request`) lesen. Häufige Gründe: - Der Datensatz hat sich in der Zwischenzeit geändert. Bitten Sie den Agenten, ihn erneut zu lesen und es noch einmal zu versuchen. - Der Agent wurde getrennt, bevor Sie genehmigt haben, daher wurde nichts ausgeführt. - Sie haben keinen Zugriff mehr auf das, was die Aktion brauchte. ## Der Agent meldet, dass sich ein Datensatz geändert hat Manche Änderungen prüfen, ob der Agent die neueste Version eines Datensatzes hat. Hat jemand anderes ihn zuvor bearbeitet, wird die Änderung abgelehnt, damit nichts überschrieben wird. Bitten Sie den Agenten, den Datensatz erneut zu lesen und es noch einmal zu versuchen. ## Einen Agenten trennen oder neu verbinden 1. Gehen Sie zu [Einstellungen > Agenten](/settings/agents) oder zum Tab **Meine KI-Agenten** in den Einstellungen Ihrer Organisation. 2. Suchen Sie den Agenten unter **Ihre verbundenen Agenten** und wählen Sie sein Löschsymbol (Papierkorb). 3. Bestätigen Sie mit **Trennen**. Er funktioniert sofort und überall nicht mehr. Um ihn wieder zu nutzen, verbinden Sie ihn erneut aus Ihrer KI-App. ## Für KI-Agenten: die Verbindung prüfen Gehen Sie in dieser Reihenfolge vor: 1. Rufen Sie `whoami` auf. Funktioniert es, ist die Verbindung in Ordnung. Merken Sie sich, welche Verbindung es ist und welche Genehmigungseinstellung gilt. 2. Bei einem Anmeldefehler bitten Sie die Person, sich erneut anzumelden (`/mcp` in Claude Code, `codex mcp login metaintro` in Codex, `pi mcp login metaintro` in Pi (oder `/mcp-auth metaintro` in Pi mit der Erweiterung pi-mcp-adapter)). Prüfen Sie, ob die Adresse genau `https://www.metaintro.com/api/mcp` lautet. 3. Wird eine Änderung wegen **insufficient scope** abgelehnt, ist die Verbindung **Nur lesen**. Sagen Sie es der Person und versuchen Sie es nicht erneut. 4. Wenn Sie es nach einigen Sekunden erneut versuchen sollen, warten Sie so lange vor dem nächsten Aufruf. 5. Wird eine Änderung abgelehnt, weil sich der Datensatz geändert hat, lesen Sie ihn erneut und versuchen Sie es mit der neuen Version. ## Kommen Sie nicht weiter? [Kontaktieren Sie uns](/help/contact-us) und fügen Sie die Fehlermeldung bei. Enthält sie eine Anfrage-ID (request ID), geben Sie diese ebenfalls an. Das hilft uns herauszufinden, was passiert ist. ### War dieser Artikel hilfreich? ## Verwandte Artikel - [Sicherheit und Datenschutz bei KI-AgentenWas ein verbundener KI-Agent in Metaintro sehen und tun kann, wie sich Schlüssel und Anmeldung unterscheiden und wie Sie den Zugriff jederzeit entziehen.](/de/help/ai-agent-security-and-privacy) - [Aktionen Ihres KI-Agenten genehmigenLegen Sie fest, welche Aktionen eines Agenten auf Ihre Genehmigung warten, und genehmigen oder lehnen Sie Anfragen in der Liste „Wartet auf Ihre Genehmigung“ ab.](/de/help/ai-agent-approvals) - [KI-Agenten im Fallmanagement nutzenVerbinden Sie einen KI-Agenten mit einer Organisation, damit er bei Ihren Fällen hilft: Nachfassen, Notizen, Check-ins, Aufgaben, Joblisten und Antworten.](/de/help/ai-agents-for-case-managers) - [Einen KI-Agenten mit Metaintro verbindenLassen Sie Claude, ChatGPT, Cursor oder einen anderen KI-Agenten bei Ihrer Jobsuche in Metaintro helfen, mit Ihrem eigenen Konto und Ihren Berechtigungen.](/de/help/connect-ai-agents-to-metaintro) [Zurück zur Navigation](#main-navigation)