MCP-Fehlerbehebung

Kläre Probleme mit der Tool-Erkennung, Authentifizierung, dem Organisationszugriff und Argumenten sowie ungewisse Ergebnisse, bevor du es erneut versuchst.

Wähle den nächsten Diagnoseschritt anhand des Symptoms: Fehlt ein Tool, sieh dir die Verbindung an. Wird ein Aufruf abgelehnt, gehe dem Argument- oder Berechtigungsfehler nach. Halte den Tool-Namen, Eingaben ohne vertrauliche Daten, die Antwort und die relevante Ressource oder Quellrevision fest. Diese Informationen helfen dir, die beabsichtigte Arbeit fortzusetzen, ohne einen Schreibvorgang mit unbekanntem Ergebnis zu wiederholen.

Die erwarteten Tools fehlen #

Vergleiche den konfigurierten Endpunkt mit der vom Client zurückgegebenen Tool-Liste. /mcp und /main stellen dieselben authentifizierten Tools bereit; /account leitet nach der Authentifizierung zu /main weiter.

Suche nach members_listMemberships und engines_list und folge den Beispielen für erste Lesezugriffe. Die genauen Namen und Schemas findest du in der aktuellen Antwort von tools/list. Dass ein API-Endpunkt existiert, bedeutet nicht, dass er auch über MCP verfügbar ist.

Wenn nur einzelne Tools ausgeblendet sind, sieh dir die Zulassungsliste und die Freigaben des Clients an. Aktiviere nur die Tools, die du für die Aufgabe brauchst. Sollte ein Tool verfügbar sein, aber fehlen, halte die Server- und Versionsangaben sowie die Erkennungsausgabe ohne vertrauliche Daten für eine Meldung fest.

GET gibt 405 zurück #

Konfiguriere Streamable HTTP unter /mcp. Nach der Authentifizierung gibt GET auf /mcp oder /main die Antwort 405 mit Allow: POST zurück; MCP-Nachrichten sendet der Client per POST. Bei einem fehlenden oder ungültigen Token wird vor der Weiterleitung 401 zurückgegeben. Eine authentifizierte Anfrage an /account liefert dagegen 308 mit Weiterleitung zu /main. Diese GET-Antworten sagen nicht aus, ob eine gültige MCP-POST-Verbindung funktioniert. Wähle den richtigen Transport aus und sieh dir anschließend den Verbindungsfehler des Clients an.

Authentifizierung oder Organisation stimmt nicht #

Stelle bei 401 sicher, dass die OAuth-Authentifizierung für die Verbindung mit dem vorgesehenen Lingo.dev-Benutzerkonto abgeschlossen wurde. Der gehostete Server erfordert ein gültiges Benutzer-Bearer-Token; ein persönlicher API-Schlüssel oder ein Service-API-Schlüssel wird weder in x-api-key noch als Bearer-Wert akzeptiert. Lass den Client seine Autorisierung aktualisieren oder stelle die Verbindung über seine Kontoverwaltung erneut her. Tokens gehören nicht in Diagnoseinformationen.

Rufe members_listMemberships auf, wähle die gewünschte Organisation aus data und übergib ihre ID im Organisationsfeld des nächsten Tools. Bei engines_list heißt dieses Feld orgId. Wenn du eine andere Organisation aus derselben Liste auswählst, ist keine erneute OAuth-Autorisierung nötig. Stelle die Verbindung erneut her, wenn die falsche Person angemeldet ist; bei einem bloßen Neustart kann die gespeicherte Sitzung wiederverwendet werden.

Wenn die Mitgliedschaft in ssoRequired angezeigt wird, melde dich über den Identitätsanbieter dieser Organisation bei Lingo.dev an und stelle die Verbindung erneut her. Wenn sowohl data als auch ssoRequired leer sind, schließe die Einrichtung der Organisation unter https://lingo.dev/orgs/start ab und rufe die Mitgliedschaften anschließend erneut ab. Eine nicht verfügbare Organisation existiert möglicherweise nicht, gehört nicht zu deinen Mitgliedschaften oder erfordert SSO. Deute daher nicht jede solche Antwort als Hinweis auf abgelaufene Zugangsdaten.

Wenn ein Tool einen Vorgang wegen fehlender Berechtigung oder Nutzungsfreigabe ablehnt, sieh dir die Anforderungen des Vorgangs an, statt dich immer wieder zu authentifizieren. Organisationszugriff und Berechtigung für einen bestimmten Schreibvorgang werden getrennt kontrolliert. Erkläre, welche Befugnis fehlt, ohne stillschweigend eine Rolle oder Zugangsdaten mit weiterreichenden Rechten zu wählen.

Ein Tool meldet eine unvollständige Organisationseinrichtung #

Die Organisation wurde kürzlich erstellt. Die Person, die sie erstellt hat, hat die Einrichtung in der Web-App noch nicht abgeschlossen: Integrationen, Teammitglieder und die erste Engine. Tools auf Organisationsebene können bis zum Abschluss der Einrichtung gesperrt bleiben; erneute Versuche oder Autorisierungen erledigen diese Schritte nicht. members_listMemberships bleibt verfügbar. Öffne mit dem Konto, mit dem die Organisation erstellt wurde, den Link aus der Nachricht, https://lingo.dev/orgs/<orgId>. Schließe die dort genannten Schritte ab und wiederhole anschließend den Aufruf. Siehe Einrichtung einer neuen Organisation abschließen.

Das Tool lehnt Argumente ab #

Vergleiche die Eingabe mit dem exakten Schema, das die Verbindung zurückgibt. Aktuelle Tool-Argumente sind flache Felder; verschachtelte Werte bleiben dort, wo das Schema sie vorsieht. Füge keine erfundenen body-, params- oder query-Wrapper hinzu. Gib das Organisationsfeld ausdrücklich an, wenn es erforderlich ist; es wird nicht aus dem Bearer-Token übernommen. Das optionale Feld intent beschreibt die Aufgabe. Die unterstützten Kontovorgänge findest du unter Funktionen.

Achte darauf, wofür die einzelnen IDs stehen. members_remove.id ist die Mitgliedschafts-ID aus members_list; members_setRole.userId identifiziert das zu dieser Mitgliedschaft gehörende Benutzerkonto. Die ID einer Lokalisierungs-Engine kann keine Anfrageprotokoll-ID ersetzen. Kopiere opake Cursor oder Zeitstempel-ID-Paare mit voller Genauigkeit unverändert, statt sie aus angezeigten Datumsangaben zu rekonstruieren.

Behalte die Unterscheidungen des Schemas bei: zwischen ausgelassenen Werten und null-Werten, Zahlen und Zeichenfolgen sowie Arrays und Einzelwerten. Sieh dir das Schema des verbundenen Tools an, bevor du eine Umgehungslösung für einen Argumentfehler anwendest.

Der Ausgang eines Schreibvorgangs im Konto oder eines Jobs ist ungewiss #

Rufe die relevante Ressource oder den Jobstatus ab, bevor du es erneut versuchst. Ein Netzwerkfehler kann auch dann auftreten, wenn der Server die Erstellung eines Schlüssels, eine Einladung, eine Entscheidung aus einer Prüfung, einen Vorschlag oder einen Job bereits angenommen hat. Stelle fest, ob die beabsichtigte Änderung vorhanden ist, statt sie automatisch erneut zu übermitteln.

Rufe bei einem von dir übermittelten Bereitstellungsjob provisioningJobs_get mit der gespeicherten Job-ID ab, bevor du über einen erneuten Versuch entscheidest. Sieh dir bei anderen Vorgängen die gespeicherte Ressource und die festgelegten Abschlussbedingungen des verbundenen Tools an. Nutze für Übersetzungsworkflows die CLI- oder API-Referenz.

Dokumentation oder Nachweise fehlen #

Suche mit localization_search und übergib anschließend den Wert path eines Ergebnisses an docs_fetch, um die vollständige Seite zu lesen. Falls der Pfad nicht funktioniert, suche erneut nach der Aufgabe und verwende ein aktuelles Ergebnis. Die Wissensdatenbank nutzt einen anderen Speicherpfad als die dateibasierte Website. Deshalb kann eine Website-Seite in diesem Index fehlen oder veraltet sein. Sieh in der aktuellen Referenz auf der Website nach, bevor du daraus schließt, dass die Funktion nicht verfügbar ist.

Wenn du eine ungelöste MCP-Lücke meldest, nenne die versuchte Aufgabe, den genauen Tool-Namen und die Serverversion und füge die Antwort ohne vertrauliche Daten bei. Eine Eingangsbestätigung sagt noch keinen Termin für die Behebung zu.

Kläre bei einer Qualitätsanfrage, was fehlt: Quellenbelege, eine abgeschlossene Auswertung, ein anwendbares Kriterium oder eine eindeutige Antwort. Daraus ergeben sich jeweils unterschiedliche nächste Schritte. Messen erklärt, wie du die verfügbaren Nachweise dokumentierst, ohne unbeantwortete Fälle als bestanden zu behandeln.