Claude-Konnektor funktioniert nicht? Zwei Fehler erklärt
Claude zeigt zwei Hauptfehler, wenn ein benutzerdefinierter Konnektor ausfällt: "Couldn't reach the MCP server" (Der MCP-Server ist nicht erreichbar) und "Authorization with the MCP server failed" (Autorisierung beim MCP-Server fehlgeschlagen). Die meisten Ursachen liegen auf der Serverseite, deshalb sind deine nützlichen Schritte kurz. Prüfe, ob die URL genau die ist, die dir der Dienst gegeben hat, und ob dein Plan oder die Admin-Einstellung benutzerdefinierte Konnektoren erlaubt. Entferne den Konnektor und füge ihn erneut hinzu. Kopiere dann die Referenz-ID, die mit ofid_ beginnt, und schicke sie an die Person, die den Server betreibt.
Die wichtigsten Punkte
- Zwei Meldungen decken die meisten Verbindungsfehler ab. Eine dritte, "Unexpected error while invoking tool" (Unerwarteter Fehler beim Aufruf eines Tools), bedeutet, dass der Konnektor verbunden ist und ein Tool-Aufruf fehlgeschlagen ist.
- Die Anleitung zur Fehlerbehebung von Anthropic sagt, dass "Couldn't reach" "nicht immer ein Netzwerkfehler ist", und dass die Seite für den Entwickler des Servers geschrieben ist, nicht für dich.
- Im Free-Plan kannst du einen benutzerdefinierten Konnektor hinzufügen. Im Team-Plan können nur Owners und Primary Owners einen hinzufügen.
- Um die Einstellungen eines benutzerdefinierten Konnektors zu ändern, entfernst du ihn und fügst ihn erneut hinzu. Es gibt keinen Bearbeiten-Button.
- Eine Server-URL, die auf einen anderen Host weiterleitet, verliert den Anmeldeheader unterwegs, und Claude meldet dann den Autorisierungsfehler. Nur der Eigentümer des Servers kann dir die richtige URL nennen, und du musst den Konnektor vielleicht mit ihr erneut hinzufügen.
- Die
ofid_-ID in der Fehlermeldung ist zeitlich begrenzt. Kopiere sie direkt nach dem Fehler.
Was bedeuten die beiden Konnektor-Fehler von Claude?
Ein benutzerdefinierter Konnektor ist ein Dienst, den du über seine URL zu Claude hinzufügst, mit dem Model Context Protocol (MCP). Claude ruft ihn nicht von deinem Laptop aus auf. Die Anleitung zur Fehlerbehebung von Anthropic sagt, dass Konnektoren auf claude.ai „auf der Infrastruktur von Anthropic laufen und deinen Server über das öffentliche Internet erreichen“ (Übersetzung von uns). Viele Fehler kommen genau daher, denn der Server muss von außerhalb deines Netzwerks erreichbar sein, nicht nur von dir.
Dieselbe Seite listet die Meldungen und das, was sie abdecken. Sie beschreibt "Couldn't reach the MCP server" als Fehler, der erscheint, „wenn Claude den Verbindungs-Handshake nicht abschließen kann“ (Übersetzung von uns), und ergänzt: „Trotz des Wortlauts ist es nicht immer ein Netzwerkfehler“ (Übersetzung von uns). Sie beschreibt "Authorization with the MCP server failed" als Fehler, der „normalerweise erscheint, nachdem der OAuth-Ablauf begonnen hat“ (Übersetzung von uns). OAuth ist der Anmeldestandard, den Konnektoren verwenden.
| Meldung | Wann sie erscheint | Wer sie meist beheben kann | Quelle |
|---|---|---|---|
| Couldn't reach the MCP server | Claude kann den Verbindungs-Handshake nicht abschließen | Der Entwickler des Servers (DNS, Firewall, Anmeldeerkennung). Du kannst die URL prüfen, die du eingefügt hast. | Fehlerbehebung für deinen Konnektor |
| Authorization with the MCP server failed | Der Anmeldeablauf startet, wird aber nicht abgeschlossen, oder die URL leitet auf einen anderen Host weiter | Der Entwickler des Servers (Anmeldeeinrichtung, Weiterleitung). Du kannst dich erneut anmelden oder den Konnektor neu hinzufügen. | Fehlerbehebung für deinen Konnektor |
| Unexpected error while invoking tool | Der Konnektor wird als verbunden angezeigt, aber ein Tool-Aufruf schlägt fehl | Der Entwickler des Servers. Dieser Fehler hat keine ofid_-ID. | Fehlerbehebung für deinen Konnektor |
Die Seite sagt deutlich, für wen sie gedacht ist: „Diese Seite ist für den Entwickler des MCP-Servers“ (Übersetzung von uns). Außerdem heißt es, dass jede Meldung „mehrere Ursachen auf deiner Seite abdeckt“ (Übersetzung von uns), wobei "your" den Entwickler meint. Deshalb folgt eine kurze Liste von Prüfungen für dich und danach eine längere Liste von Ursachen beim Entwickler. Die Seite steht unter claude.com/docs/connectors/building/troubleshooting.
Was kannst du selbst prüfen?
Diese fünf Schritte folgen der Hilfe und den Test- und Fehlerbehebungsseiten von Anthropic. Sie brauchen keine Entwicklerwerkzeuge.
- Plan und Rolle. Die Hilfeseite von Anthropic sagt, dass benutzerdefinierte Konnektoren „für Nutzer der Pläne Free, Pro, Max, Team und Enterprise“ verfügbar sind, dass „Free-Nutzer auf einen benutzerdefinierten Konnektor beschränkt sind“, und dass „nur Owners und Primary Owners sie zu Team-Plänen hinzufügen können“ (Übersetzung von uns). Bei Enterprise nennt die Seite außerdem Personen mit einer benutzerdefinierten Rolle, die "Manage access to Libraries" (Zugriff auf Libraries verwalten) umfasst. Wenn du im Team-Plan bist und kein Owner, bitte einen Owner, ihn hinzuzufügen.
- Die URL, genau so, wie der Dienst sie angibt. Füge sie vollständig ein, mit dem Pfad. Wenn die Seite des Dienstes eine zweite Adresse nennt, zum Beispiel eine mit
www.davor, verwende die, die der Dienst angibt. Eine URL, die auf einen anderen Host weiterleitet, ist eine bekannte Ursache des Autorisierungsfehlers (siehe das Beispiel unten). - Entfernen und erneut hinzufügen. Die Hilfeseite sagt: „Wenn du einen benutzerdefinierten Konnektor bearbeiten möchtest, musst du ihn zuerst entfernen und dann mit den aktualisierten Daten erneut hinzufügen“ (Übersetzung von uns). Im Web und in der Desktop-App finden einzelne Pro- und Max-Nutzer Konnektoren unter "Customize" (Anpassen) > "Connectors" (Konnektoren). Team- und Enterprise-Owner nutzen "Organization settings" (Organisationseinstellungen) > "Connectors".
- Melde dich erneut an, wenn Claude es verlangt. Die Testseite von Anthropic sagt, dass ein funktionierender Konnektor "Connected" (Verbunden) unter "Your connectors" (Deine Konnektoren) anzeigt. Wenn er stattdessen "Connect" (Verbinden) oder "Reconnect" (Erneut verbinden) zeigt, „ist die Anmeldung nicht abgeschlossen“ (Übersetzung von uns). Schließe den Anmeldeschritt ab und prüfe dann den Status erneut.
- Kopiere die
ofid_-ID. Sie steht in der Fehlermeldung und in der Adresse der Seite. Kopiere sie, bevor du den Tab schließt.
Nichts auf diesen Seiten legt nahe, einen Browserschutz, eine Firewall oder einen Anmeldeschritt abzuschalten. Wenn ein Schritt das verlangt, halte an und frage den Anbieter des Dienstes.
Was kann nur der Entwickler des Servers beheben?
Wenn die fünf Prüfungen nicht helfen, liegt die Ursache meist in der Einrichtung des Servers. Du musst diese Ursachen nicht beheben, aber sie zu kennen zeigt dir, was du anfragen kannst. Die Tabelle folgt der Fehlerbehebungsseite von Anthropic, in einfachen Worten.
| Ursache | Was Claude tut | Prüfung für den Entwickler |
|---|---|---|
| Der Hostname löst zu einer privaten Adresse auf | Lehnt die Verbindung ab, bevor eine Anfrage Anthropic verlässt. Die Logs des Servers sehen nichts. | Schlage den Hostnamen von außerhalb des Netzwerks nach. Jede Adresse muss global routbar sein. |
| Eine Firewall- oder Bot-Regel blockiert Anthropic | Die Anfrage wird gestoppt, bevor die Anwendung sie sieht. | Suche nach Antworten 403 oder 429 in den Edge-Logs. Erlaube den veröffentlichten IP-Bereich von Anthropic. |
| Die URL leitet auf einen anderen Host weiter | Verwirft den Anmeldeheader bei der Weiterleitung. Das Ziel antwortet mit 401. Claude zeigt den Autorisierungsfehler. | Rufe die URL auf und lies das Weiterleitungsziel. Registriere diese URL. |
| Die Daten zur Anmeldeerkennung fehlen | Der Autorisierungsserver kann nicht gefunden werden. Es kann "Couldn't reach" erscheinen, auch wenn der Endpunkt selbst antwortet. | Rufe die Erkennungsdokumente aus einem öffentlichen Netzwerk ab. Sie sollten 200 liefern. |
| Es gibt keinen Weg, einen Client zu registrieren | Es kann keine Client-Identität bezogen werden, daher kann die Anmeldung nicht starten. | Biete dynamische Client-Registrierung, Client-ID-Metadatendokumente oder vorregistrierte Zugangsdaten an. |
| PKCE mit S256 wird nicht unterstützt | Der Ablauf schlägt am Token-Endpunkt fehl. | Unterstütze S256 und gib es in den Metadaten des Autorisierungsservers an. |
| Der Token-Endpunkt braucht länger als 10 Sekunden | Wartet bis zu 10 Sekunden auf die Antwort und schlägt dann fehl, auch wenn der Token später ausgestellt wird. | Miss den Token-Handler und jeden Proxy davor. |
Dieselbe Seite nennt weitere Ursachen für den Autorisierungsfehler, etwa eine Abweichung beim Aussteller, eine Abweichung bei der Zielgruppe und Fehler beim Erneuern von Tokens. Ihre Diagnoseliste läuft in der Reihenfolge, in der Claude jeden Schritt durchläuft. Eine der Prüfungen ist eine einfache Anfrage nach den Weiterleitungs-Headern:
curl -sI https://your-server.example.com/your-mcp-path
Wenn die Antwort ein 3xx ist, das auf einen anderen Host zeigt, „ist dieses Ziel die URL, die du registrieren solltest“ (Übersetzung von uns). Die Seite zur Fehlerbehebung sagt, dass ausgehende Anfragen von Anthropic aus einem veröffentlichten Bereich kommen, den Anthropic auf seiner Seite zu IP-Adressen auflistet. Die MCP-Autorisierungsspezifikation sagt, dass MCP-Server "MUST implement" OAuth 2.0 Protected Resource Metadata, definiert in RFC 9728. Diese Metadaten sind das, was die Zeilen "Erkennung" oben meinen.
Was ist die ofid_-Referenz-ID und wer bekommt sie?
Wenn eine Verbindung oder Anmeldung auf claude.ai fehlschlägt, sagt die Seite von Anthropic, dass „die Fehlermeldung und die Seitenadresse eine Referenz-ID enthalten, die mit ofid_ beginnt“ (Übersetzung von uns). Die ID „erlaubt Anthropic, den genauen Fehler auf seiner Seite nachzuverfolgen, und sie ist zeitlich begrenzt, also melde den Fehler bald nach dem Auftreten“ (Übersetzung von uns).
Der Weg von Anthropic für eine Meldung ist ein Issue im Issue-Tracker anthropics/claude-ai-mcp, mit der ID, der Server-URL und dem, was die Server-Logs während des Versuchs zeigen. Die Seite richtet sich an Entwickler, die diese Logs liefern können. Du kannst das nicht. Deshalb empfehlen wir diese Reihenfolge: Schicke die ID, die genaue Meldung und die Uhrzeit zuerst an den Anbieter des Dienstes. Findet der Anbieter auf seiner Seite nichts, legt er das Issue an. Wenn du es selbst anlegst, ist der Tracker ohne Anmeldung lesbar, also lass persönliche Daten und jeden Token weg.
Ein Fehler bei einem Tool-Aufruf ist anders. Anthropic sagt, dass es für diesen Fehler „keine ofid_-Referenz-ID gibt“ (Übersetzung von uns). Eine Meldung zu diesem Fehler enthält den Tool-Namen und die Uhrzeit des Fehlers in UTC.
Beispiel: eine URL, die auf www weiterleitet
Beispiel (hypothetisch): Ein Dienst sagt dir, du sollst
https://example.com/mcphinzufügen. Nichts hier ist echte Serverausgabe. Es zeigt nur, wie ein Fehler von der Meldung zur Ursache führt.
- Meldung: Du fügst die URL hinzu und drückst Connect. Claude zeigt "Authorization with the MCP server failed". Für den Entwickler funktioniert sie im MCP Inspector oder in Claude Code.
- Ursache: Der Server antwortet mit
301und schickt Clients zuhttps://www.example.com/mcp. Die Seite von Anthropic erklärt den Rest: Claude folgt der Weiterleitung, verwirft den Anmeldeheader, das Ziel antwortet mit 401, und der Autorisierungsfehler erscheint. Lokale Clients „scheitern bei einer Weiterleitung sofort“ (Übersetzung von uns), und claude.ai nicht, daher zeigt sich der Fehler später als Autorisierungsfehler.- Prüfung:
curl -sI https://example.com/mcpliefert einen 3xx-Status und einenLocation-Header auf dem Hostwww..- Lösung: Der Entwickler bestätigt die endgültige URL. Du entfernst den Konnektor und fügst ihn mit
https://www.example.com/mcperneut hinzu.Die Seite von Anthropic nennt die Weiterleitung unter den Ursachen des Autorisierungsfehlers. Deshalb lohnt es sich, den Eigentümer zu bitten, die Prüfung aus Schritt 3 auszuführen.
Das erklärt die häufige Meldung, dass ein Konnektor im MCP Inspector oder in Claude Code funktioniert, aber nicht in claude.ai. Die Seite nennt außerdem einen zweiten Grund: „die CLI und curl verbinden sich von deinem Rechner aus, während claude.ai sich von den Servern von Anthropic aus verbindet“ (Übersetzung von uns). Wenn ein Hostname innerhalb und außerhalb eines Firmennetzwerks unterschiedlich auflöst, kann claude.ai eine private Adresse erhalten und "Couldn't reach" melden.
ofid_-ID an den Eigentümer des Servers geht. Diagramm von Remembite.Was solltest du wissen, bevor du einen benutzerdefinierten Konnektor verbindest?
Ein benutzerdefinierter Konnektor kann jeder Dienst sein, dessen Eigentümer eine URL veröffentlicht. Die Hilfeseite von Anthropic sagt, dass benutzerdefinierte Konnektoren Claude mit beliebigen Diensten verbinden, die Anthropic nicht geprüft hat. Sie warnt außerdem: „Bösartige MCP-Server können versteckte Anweisungen enthalten, die versuchen, Claude unbeabsichtigte Aktionen ausführen zu lassen“ (Übersetzung von uns).
Die Seite nennt zwei Gewohnheiten. Prüfe jede Anfrage zur Tool-Freigabe, bevor du sie erlaubst: „Prüfe Claudes Anfragen zur Tool-Freigabe sorgfältig“ (Übersetzung von uns). Wähle "Allow always" (Immer zulassen) nur für Server und Tools, denen du vertraust. Füge einen Konnektor nur hinzu, wenn du weißt, wer den Dienst betreibt und was er mit deinen Daten machen kann. Die Seite steht unter Get started with custom connectors using remote MCP.
Und wenn es der Remembite-Konnektor ist?
Die URL des Remembite-Konnektors ist https://remembite.com/mcp. Er funktioniert in Claude, auch in der iPhone-App. Er funktioniert auch in ChatGPT (Beta, über den Entwicklermodus): Lösungen für ChatGPT. Beginne mit der Anleitung, die zu dem passt, was du siehst:
- Verbunden, aber Claude zeigt keine Tools von Remembite: Der Remembite-Konnektor zeigt keine Tools.
- Claude bittet dich, dich erneut zu verbinden oder zu autorisieren: Claude bittet, Remembite erneut zu verbinden.
- Erstinstallation, Schritt für Schritt: Remembite mit Claude verbinden.
- Noch immer festgefahren nach diesen Seiten: Remembite-Support. Nenne die genaue Meldung und die
ofid_-ID.
Deine KI rechnet. Remembite führt die Einträge. Der Konnektor ist das Verbindungsstück zwischen beiden. Für eine Anleitung zum Eintragen von Mahlzeiten mit Claude lies deshalb wie du Mahlzeiten mit Claude eintragst. Wie die Teile zusammenpassen, erfährst du in wie Remembite funktioniert. Was ein MCP-Server ist, erklärt der Leitfaden zum Ernährungs-MCP-Server.
Was deckt diese Seite nicht ab?
- Die Seiten von Anthropic ändern sich. Alle Zitate hier wurden am 18. Okt. 2026 gelesen. Wenn ein Menüname oder eine Grenze beim Lesen anders ist, gilt die Seite von Anthropic.
- Wir haben diese Fehler nicht nachgestellt. Die Ursachen stammen aus den Seiten von Anthropic und der MCP-Spezifikation, nicht aus eigenen Tests.
- Diese Seite behandelt benutzerdefinierte Konnektoren. Konnektoren aus dem Verzeichnis von Anthropic sind ein eigener Fall.
- Sie macht keine Aussage über einen bestimmten Server, auch nicht darüber, ob ein Dienst gut betrieben wird oder in Betrieb bleibt.
- Die Liste der Prüfungen für dich ist mit Absicht kurz. Sie enthält nur Schritte, die eine Seite von Anthropic stützt.
Häufige Fragen
Warum funktioniert mein benutzerdefinierter Claude-Konnektor nicht?
Claude erreicht den Server von der Infrastruktur von Anthropic aus, daher können eine private Adresse, eine Firewall-Regel, eine Weiterleitung oder ein Problem bei der Anmeldeeinrichtung auf dem Server alles blockieren. Prüfe deinen Plan, die genaue URL und ob die Anmeldung abgeschlossen wurde. Füge dann den Konnektor erneut hinzu und schicke die ofid_-ID an den Eigentümer des Servers.
Warum funktioniert er in Claude Code oder im MCP Inspector, aber nicht in Claude?
Anthropic sagt, dass lokale Tools von deinem Rechner aus verbinden und claude.ai von den Servern von Anthropic aus. Ein Hostname, der außerhalb deines Netzwerks anders auflöst, oder eine URL, die auf einen anderen Host weiterleitet, zeigt sich nur in claude.ai.
Was ist die ofid_-ID in der Fehlermeldung?
Es ist eine Referenz-ID in der Fehlermeldung und der Seitenadresse, mit der Anthropic eine fehlgeschlagene Verbindung nachverfolgen kann. Sie ist zeitlich begrenzt, also kopiere sie bald nach dem Fehler und gib sie an den Anbieter des Dienstes weiter.
Brauche ich einen kostenpflichtigen Plan, um einen benutzerdefinierten Konnektor hinzuzufügen?
Die Hilfeseite von Anthropic, gelesen am 18. Okt. 2026, nennt die Pläne Free, Pro, Max, Team und Enterprise. Free ist auf einen benutzerdefinierten Konnektor beschränkt. Plan-Regeln können sich ändern, prüfe deshalb die Seite.
Warum kann ich im Team-Plan keinen Konnektor hinzufügen?
Die Hilfeseite sagt, dass nur Owners und Primary Owners benutzerdefinierte Konnektoren zu Team-Plänen hinzufügen können. Bitte einen Owner, ihn unter "Organization settings" > "Connectors" hinzuzufügen.
Schätzungen, keine medizinische Beratung. So funktionieren die Zahlen.