Probleme mit KI-Agenten-Verbindungen beheben

Der Agent kann sich nicht anmelden

Wenn Ihre KI-App einen Anmeldefehler anzeigt oder immer wieder zum Verbinden auffordert:

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.
Achten Sie darauf, sich mit dem Metaintro-Konto anzumelden, das der Agent nutzen soll.
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.
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/<org-slug> 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 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-<org-slug>. 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/<org-slug>) 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.

"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.

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

Gehen Sie zu Einstellungen > Agenten oder zum Tab Meine KI-Agenten in den Einstellungen Ihrer Organisation.
Suchen Sie den Agenten unter Ihre verbundenen Agenten und wählen Sie sein Löschsymbol (Papierkorb).
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:

Rufen Sie whoami auf. Funktioniert es, ist die Verbindung in Ordnung. Merken Sie sich, welche Verbindung es ist und welche Genehmigungseinstellung gilt.
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.
Wird eine Änderung wegen insufficient scope abgelehnt, ist die Verbindung Nur lesen. Sagen Sie es der Person und versuchen Sie es nicht erneut.
Wenn Sie es nach einigen Sekunden erneut versuchen sollen, warten Sie so lange vor dem nächsten Aufruf.
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 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.