MCP-Server (Integrationen)

Inhalte werden von Phrase Language AI maschinell aus dem Englischen übersetzt.

Verfügbar für

Alle Phrase-Pläne, derzeit ohne zusätzliche Kosten

Der Phrase MCP-Server (Model Context Protocol Server) verbindet KI-Assistenten wie Claude mit Phrase. Er bringt die Sprachintelligenz von Phrase in diese Tools ein, sodass Assistenten mithilfe natürlicher Sprache mit Projekten, Jobs und Übersetzungen arbeiten können. Der Server umfasst Phrase TMS, Phrase Strings und weitere Phrase-Funktionen, die über die API bereitgestellt werden, und arbeitet über diesen einzelnen Produkten hinweg und nicht innerhalb eines einzelnen Produkts.

Fähigkeiten

Der MCP-Server integriert die Sprachintelligenz von Phrase in bereits genutzte KI-Tools und ermöglicht so, Inhalte, Jobs und Übersetzungen mit natürlicher Sprache zu bearbeiten – ganz gleich, wo die Arbeit stattfindet.

Phrase Analytics-Daten sind derzeit nicht über den MCP-Server zugänglich. KI-Assistenten, die über MCP verbunden sind, können keine Analyseberichte oder Metriken abfragen oder abrufen. Für Analytics-basierte Workflows, etwa zum Erstellen automatisierter Berichte, direkt über Phrase Data verbinden.

Zu den typischen Aufgaben gehören:

Fragen zu Projekten und Jobs
Behebung von Qualitätsproblemen in Inhalten, ohne einzelne Dateien oder Sprachversionen öffnen zu müssen.
Erstellen von Jobs oder Neuzuweisung von Projekten.
Durchführen von Massenaktualisierungen anstelle der Aktualisierung einzelner Elemente.
Erstellen, Bearbeiten und Löschen von Phrase TMS-Connectors.

Verbindungsoptionen

Der MCP-Server unterstützt zwei Verbindungsmethoden.

Remote Connection (empfohlen)

Für die Fernverbindung ist die Anmeldung mit einem bestehenden Phrase-Konto erforderlich; eine Installation ist nicht nötig. Diese Methode funktioniert mit KI-Tools, die die Verbindung mit einem Remote-Server unterstützen.

Die Sichtbarkeit von Tools im verbundenen KI-Assistenten hängt vom OAuth-Zugriffstoken ab, das bei der Anmeldung ausgestellt wurde. Dieses deckt nur die Phrase-Produkte ab, auf die der angemeldete Benutzer innerhalb der Plattform-Organisation Zugriff hat, die für die Verbindung verwendet wird. Wenn ein Benutzer innerhalb dieser Plattform-Organisation keinen Zugriff auf ein bestimmtes Produkt hat, wie z. B. Phrase Strings, funktionieren die Tools für dieses Produkt nicht, auch wenn sie in der Liste erscheinen. Ein Strings-Suchtool kann beispielsweise weiterhin erscheinen, durchsucht jedoch nur die Strings-API-Referenz und kann nicht auf Strings-Projektdaten zugreifen.

Bei fehlendem Produktzugriff dem Benutzer zunächst innerhalb der Plattform-Organisation Zugriff auf das Produkt gewähren. Anschließend die Verbindung zum MCP-Server im KI-Tool trennen und erneut herstellen, damit ein neues Zugriffstoken ausgestellt wird, das den aktualisierten Zugriff widerspiegelt.

Die Fernverbindung wird über OAuth authentifiziert, das derzeit einzige für diese Methode unterstützte Authentifizierungsprotokoll. Benutzerdefinierte oder von Drittanbietern stammende Workflow-Tools, die eine manuelle, auf Header basierende Authentifizierung erfordern, werden derzeit für Remote-Verbindungen nicht unterstützt. Dazu gehören Inhabertoken, API-Keys und M2M-Zugangsdaten (Machine-to-Machine).

Einige KI-Tools speichern ihre eigenen Serververbindungseinträge separat von Phrase. Wenn ein Anmeldeversuch mit einem serverseitigen Fehler fehlschlägt, etwa einer Whitelabel-Fehlerseite oder einem HTTP 500 Internal Server Error, in den Connector- oder Servereinstellungen des KI-Tools nach einem alten oder doppelten Phrase-MCP-Servereintrag suchen. Einen solchen Eintrag entfernen, bevor die Verbindung erneut hergestellt wird. Diese Überprüfung gilt zusätzlich zur Überprüfung der Registerkarte „Zustimmungen“ in den Phrase-Profileinstellungen.

Veraltete Authentifizierung in VS Code

Visual Studio Code (VS Code) speichert die bei einem MCP-Server registrierte Client-ID im Cache, wobei als Key die Server-URL und nicht der Anzeigename verwendet wird. Wenn diese Client-ID auf dem Phrase-Server nicht mehr existiert, sendet VS Code weiterhin die veraltete ID, anstatt eine neue Registrierung auszulösen. Dies führt zu einem 400-Fehler („Bad Request“), bei dem eine Nichtübereinstimmung zwischen client_id und redirect_uri gemeldet wird, anstatt dass der erwartete Einwilligungsbildschirm angezeigt wird. Das Löschen und erneute Hinzufügen des Server-Eintrags oder dessen Umbenennung in mcp.json ührt nicht zum Löschen der zwischengespeicherten Registrierung, da der Cache anhand der Server-URL indiziert ist.

Um dieses Problem in VS Code 1.101 oder höher zu beheben, müssen folgende Schritte ausgeführt werden:

Die Befehlspalette (Ctrl/Cmd+Shift+P) öffnen und Authentication: Remove Dynamic Authentication Providers ausführen und anschließend den Phrase-MCP-Servereintrag auswählen.
Öffne das Menü Konten, suche das mit dem Phrase-Server verknüpfte Konto und öffne Manage Trusted MCP Servers, um die Verknüpfung aufzuheben oder dich von diesem Konto abzumelden.
In der MCP-Ansicht oder über MCP: List Servers die Serververbindung beenden und neu starten oder Developer: Reload Window ausführen.

Der nächste Tool-Aufruf löst eine neue Registrierung aus und zeigt den Zustimmungsbildschirm an.

Hinweis

Sollten diese Schritte nicht ausreichen, um die veraltete Registrierung zu löschen, lösche die gespeicherten Anmeldedaten manuell aus dem Anmeldedaten-Speicher des Betriebssystems (macOS Keychain, Windows Credential Manager oder libsecret unter Linux) sowie aus dem globalen Speicher von VS Code. Dadurch wird die Authentifizierung für alle anderen konfigurierten MCP-Server zurückgesetzt.

Selbstgehostete Verbindung (veraltet)

Die selbstgehostete Verbindung läuft auf einer vom Team verwalteten Infrastruktur und erfordert Node.js sowie eine Konfigurationsdatei.

Erste Schritte

Die vollständigen Einrichtungsschritte für beide Verbindungsoptionen, einschließlich Befehlen für verschiedene KI-Tools, finden sich im Developer Hub-Artikel Phrase MCP Server.

Nach dem Herstellen der Verbindung findet man eine kuratierte Liste von Starter-Prompts, die nach Aufgaben geordnet sind, im Developer Hub-Artikel Server Starter Prompts.

Berechtigungen

Bei der Verbindung wählt der Kontoinhaber aus, welche Zugriffsrechte dem Assistenten gewährt werden sollen: Daten anzeigen, Daten anlegen oder Daten ändern und löschen. Dies gilt zusätzlich zu den bestehenden Phrase-Rollenberechtigungen und nicht an deren Stelle, sodass der Assistent die vom Konto bereits gewährten Berechtigungen nicht überschreiten kann.

Rollenberechtigungen und Connector-Zustimmungen funktionieren unabhängig voneinander, und die restriktivere der beiden bestimmt immer den tatsächlichen Zugriff. Ein Benutzer mit einer Rolle, die nur Lesezugriff erlaubt, kann beispielsweise keine Daten über den Assistenten erstellen, ändern oder löschen, selbst wenn das Zustimmungsdialogfeld Zugriff zum Erstellen, Ändern oder Löschen gewährt.

Der Zugriff lässt sich jederzeit in den Phrase-Profileinstellungen unter der Registerkarte Consents überprüfen und widerrufen.

Eine bestehende Zustimmung kann nicht direkt bearbeitet werden. Um die einem Assistenten gewährte Zugriffsebene zu ändern, widerruft der Benutzer die bestehende Zustimmung auf der Registerkarte „Zustimmungen“ und stellt die Verbindung erneut her. Im Zustimmungsdialog wählt er dabei die gewünschte Zugriffsebene erneut aus.

Die Zustimmung wird von jedem Benutzer individuell verwaltet. Ein Benutzer kann nur seine eigene Zustimmung einsehen und verwalten. Eine Admin-Ansicht zum Überprüfen oder Verwalten der Zustimmungen anderer Benutzer gibt es nicht.