MCP-Verbindung einrichten
Verbinde dich mit den authentifizierten Kontotools und überprüfe anschließend die Organisation und die verfügbaren Tools.
Verbinde deinen Assistenten mit deinem Lingo.dev-Konto und bestätige anschließend mit einer Leseanfrage, dass die gewünschte Organisation ausgewählt ist. Der Server handelt im Namen der bei Lingo.dev angemeldeten Person.
Kontoverbindung #
Setze die URL des Remote-Servers auf https://mcp.lingo.dev/mcp und wähle Streamable HTTP mit OAuth. Starte den Autorisierungsvorgang im Client, melde dich beim gewünschten Lingo.dev-Konto an und genehmige die Verbindung. Der Client ermittelt den Autorisierungsserver über den MCP-Endpunkt und verwaltet die Zugangsdaten für den Zugriff und dessen Erneuerung.
Die MCP-Anfrage übermittelt in Authorization: Bearer <access-token> ein Zugriffstoken der angemeldeten Person. Dieses Token ist kein dauerhafter persönlicher API-Schlüssel und nicht an eine einzelne Organisation gebunden. Das Backend kontrolliert, ob die Person auf die vom jeweiligen Tool angegebenen Ressourcen zugreifen darf. Kontozugangsdaten erläutert diese Berechtigungen und den Umgang mit Zugangsdaten.
Ein API-Schlüssel in x-api-key oder als Bearer-Wert ermöglicht keine Authentifizierung bei diesem gehosteten Server. Verwende einen Client, der die OAuth-Verbindung des Servers unterstützt, statt einen API-Schlüssel in einen statischen Header zu kopieren.
Die Verbindungswerte sind unten zusammengefasst. Diese Übersicht ist keine clientspezifische Konfigurationsdatei:
{
"endpoint": "https://mcp.lingo.dev/mcp",
"transport": "Streamable HTTP",
"authentication": "OAuth user session"
}Ordne diese Werte den Feldern zu, die dein Client unterstützt. Wie Authentifizierungsdaten gespeichert werden und welche Konfigurationssyntax gilt, hängt von der Version ab. Der Endpunkt akzeptiert MCP-POST-Anfragen: Ohne gültiges Token gibt er 401 mit Metadaten zur OAuth-Erkennung zurück; eine authentifizierte GET-Anfrage liefert 405 Method Not Allowed. Durch das Öffnen der URL im Browser lässt sich keine initialisierte MCP-Verbindung testen.
Bestehende gehostete URLs #
https://mcp.lingo.dev/main stellt dieselben Tools mit denselben Nutzerberechtigungen bereit. Der Ablauf der OAuth-Erkennung unterscheidet sich von dem bei /mcp. Eine funktionierende /main-Verbindung kann daher ihre bestehende Autorisierungskonfiguration beibehalten. Füge beim Wechsel zu /mcp diese URL als neue Verbindung hinzu und schließe den zugehörigen OAuth-Vorgang ab. Kombiniere die neue URL nicht mit den gespeicherten Autorisierungseinstellungen einer alten Verbindung.
Die frühere Adresse https://mcp.lingo.dev/account gibt 401 zurück, bis sie ein gültiges Nutzertoken erhält. Danach leitet sie mit 308 zu /main weiter, wobei Anfragemethode und Anfrageinhalt erhalten bleiben. Diese Weiterleitung stellt weder die Authentifizierung per API-Schlüssel noch den alten, organisationsgebundenen Toolkatalog wieder her. Wenn du eine Verbindung migrierst, die einen API-Schlüssel gespeichert hatte, stelle sie über OAuth neu her.
Einrichtung einer neuen Organisation abschließen #
Beim Verbinden gibst du für ein neues Konto in der Web-App den Namen der Organisation an. Wer die Organisation erstellt hat, schließt dort anschließend drei weitere Schritte ab: Integrationen, Teammitglieder und die erste Engine. Die Web-App befüllt diese Engine anhand der Website der Organisation. Integrationen und Teammitglieder können übersprungen werden. Solange nicht alle drei Schritte abgeschlossen sind, gibt jedes Tool, das diese Organisation angibt, einen Fehler zurück. Dieser nennt die noch offenen Schritte und verlinkt auf https://lingo.dev/orgs/<orgId>. Der Link öffnet den Schritt, bei dem sich die Person befindet, die die Organisation erstellt hat. members_listMemberships listet die Organisation weiterhin auf, sodass der Assistent ihre ID finden kann.
Öffne den Link, schließe die Schritte ab und wiederhole dann den Aufruf. Danach funktioniert der Assistent wie gewohnt und kann mit engines_create oder provisioningJobs_create weitere Engines erstellen. Eingeladene Mitglieder und Organisationen, die vor Einführung dieses Einrichtungsablaufs erstellt wurden, sind nicht betroffen.
Zugriffsbereich des Kontos überprüfen #
- Öffne die Toolübersicht des Clients und suche nach
members_listMembershipsundengines_list. - Rufe
members_listMembershipsauf, um die Organisationen der angemeldeten Person auszulesen. Ist nur eine Organisation vorhanden, verwende diese. Sind mehrere verfügbar, wähle die gewünschte aus und halte ihre ID für diese Aufgabe fest. - Rufe
engines_listmit dem WertorgIddieser Organisation auf und wähle anschließend eine Engine-ID aus dem zurückgegebenendata. - Lies vor der Verwendung jedes ausgewählten Tools das von ihm bereitgestellte Schema. Tools auf Organisationsebene erwarten ein explizites Organisationsfeld; Tools auf Objektebene können stattdessen eine Ressourcen-ID verwenden. Beschränke Schreibvorgänge auf den vereinbarten Umfang der Aufgabe.
Für den Wechsel zwischen Organisationen in derselben Mitgliedschaftsliste ist keine weitere OAuth-Verbindung erforderlich. Übergib die ausgewählte ID in dem Feld, das das Tool vorgibt, etwa orgId oder dem Organisationsfeld id. Der Server übernimmt keine fest vorgegebene Organisation aus dem Token. Falls die falsche Person angemeldet ist, stelle die Verbindung über die Kontoverwaltung des Clients neu her.
members_listMemberships #
Für diesen Aufruf ist keine Organisations-ID erforderlich. intent ist optional und beschreibt die Aufgabe:
{
"intent": "Find the organization whose French translation guidance I should inspect."
}data in der Antwort enthält die zugänglichen Organisationen mit ihren IDs und Namen. Optionale ssoRequired-Einträge kennzeichnen Mitgliedschaften, für die eine SSO-Anmeldung erforderlich ist, die in dieser Sitzung noch nicht verwendet wurde. Melde dich über den Identitätsanbieter dieser Organisation bei Lingo.dev an und stelle anschließend die Verbindung neu her. Eine Organisation in ssoRequired ist für reguläre Aufrufe auf Organisationsebene noch nicht verfügbar.
Wenn beide Listen leer sind, öffne https://lingo.dev/orgs/start, um die erste Organisation einzurichten, und wiederhole anschließend diese Leseanfrage. Erfinde keine Organisations-ID und erstelle keine zweite Organisation, nur weil eine bestehende Mitgliedschaft SSO erfordert.
engines_list #
Ersetze org_example durch eine ID aus der Antwort mit den Mitgliedschaften:
{
"orgId": "org_example",
"intent": "Find the localization engine used for French translations."
}Verwende für spätere Lesevorgänge auf Engine-Ebene eine Engine-ID aus dem zurückgegebenen data. Dies sind vollständige Toolargumente, keine umschließenden Strukturen für HTTP-Nutzdaten. Tools verwenden das optionale intent zusammen mit ihren operationsspezifischen Feldern. Die Kontooperationen findest du unter Funktionen.
Clientspezifische Konfiguration #
Informationen zur Konfigurationssyntax und den unterstützten Transportverfahren findest du in der aktuellen Dokumentation deines Clients. Diese Einstellungen sind auch dann wichtig, wenn zwei Clients denselben Endpunkt verwenden.
Claude Code #
Wähle für /mcp eine Remote-HTTP-Verbindung mit OAuth. Entscheide vor dem Speichern, ob die Verbindung zu deiner Nutzerkonfiguration oder zum Projekt gehört. Gemeinsam genutzte Projekteinstellungen dürfen keine Zugangsdaten enthalten; alle Personen sollten ihre eigene Kontoverbindung autorisieren. Überprüfe nach dem Aktivieren die verfügbaren Tools.
Codex #
Codex verwendet eine TOML-Konfiguration, üblicherweise in ~/.codex/config.toml. Konfiguriere die Konto-URL über die Remote-MCP-Unterstützung der jeweiligen Version. Übernimm kein JSON aus einem anderen Client in TOML. Falls deine Version eine Transportbrücke benötigt, kontrolliere vor der Verwendung deren eigene Authentifizierung und Tokenspeicherung. Eine solche Brücke ist ein weiterer Prozess, der Zugangsdaten enthält.
Cursor #
Entscheide bewusst zwischen Einstellungen auf Nutzerebene und einer projektbezogenen .cursor/mcp.json. Eine Projektverbindung macht die Serverdefinition für Teammitglieder auffindbar, darf aber keinen Kontoschlüssel im Klartext weitergeben. Alle Personen sollten ihre eigene Kontoverbindung autorisieren.
Claude Desktop und claude.ai #
Lingo.dev ist im Claude-Konnektorverzeichnis gelistet. Du benötigst daher weder eine URL noch eine Konfigurationsdatei. Die Schritte sind in Claude Desktop und auf claude.ai gleich:
- Öffne Einstellungen > Anpassen > Entdecken.
- Suche nach
Lingo.devund klicke beim Lingo.dev-Konnektor auf Verbinden. - Melde dich auf der Lingo.dev-Seite Autorisieren beim gewünschten Konto an und klicke auf Genehmigen.
Claude speichert und erneuert die Zugangsdaten. Überprüfe nach dem Verbinden die verfügbaren Tools.
ChatGPT #
Ob benutzerdefinierte Remote-Apps und OAuth unterstützt werden, hängt vom Konto und der Clientversion ab. Wenn diese Unterstützung verfügbar ist, verwende die URL /mcp und autorisiere die gewünschte Person mit ihrem Lingo.dev-Konto.
Gib dem Agenten eine klar begrenzte erste Aufgabe #
Eine erste Anfrage könnte lauten:
Sieh dir das französische Glossar und die Anweisungen der ausgewählten Lokalisierungs-Engine an. Erkläre, welche Ressourcen verknüpft sind und ob sie den von mir angegebenen Produktbegriff abdecken. Schlage jede Änderung vor, bevor du sie anwendest. Diese Aufgabe erlaubt weder Übersetzungen noch die Generierung von Vorschlägen, die Erstellung von Schlüsseln oder die Verwaltung von Mitgliedern.
Kombiniere die Anweisung mit einer clientseitigen Genehmigung oder einer geeigneten Liste zulässiger Tools. Ein Prompt legt die angeforderte Arbeit fest, entzieht den Zugangsdaten aber keine Schreibberechtigung.
Wenn die Erkennung oder die erste Leseanfrage fehlschlägt, behebe das Problem mithilfe der Fehlerbehebung, bevor du fortfährst.