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

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 und nur die Phrase-Produkte abdeckt, auf die der angemeldete Benutzer innerhalb der für die Verbindung verwendeten Plattform-Organisation Zugriff hat. 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).

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 (Strg/Cmd+Umschalt+P) öffnen und Authentifizierung: Dynamische Authentifizierungsanbieter entfernen ausführen und dann den Eintrag für den Phrase-MCP-Server 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: Server auflisten die Serververbindung stoppen und neu starten. Alternativ Entwickler: Fenster neu laden 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 der Zustimmungsdialog 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, wobei er die gewünschte Zugriffsebene im Zustimmungsdialog erneut auswählt.

Die Zustimmung wird von jedem Benutzer individuell verwaltet. Ein Benutzer sieht und kontrolliert nur seine eigene Zustimmung, und es gibt keine Admin-Ansicht zum Überprüfen oder Verwalten der von anderen Benutzern erteilten Zustimmungen.