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-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 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:

Öffne die Befehlspalette (Strg/Cmd+Umschalt+P) und führe Authentication: aus. Entferne Dynamic Authentication Providers und wähle anschließend den Phrase MCP-Server-Eintrag aus.
Ö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: Liste Server auf, stoppe die Serververbindung, starte sie neu oder führe Developer: aus. Lade das Fenster neu.

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-Zustimmung funktionieren unabhängig voneinander, und die restriktivere der beiden bestimmt immer den tatsächlichen Zugriff. Beispielsweise kann ein Benutzer mit einer Rolle, die ausschließlich Lesezugriff ermöglicht, keine Daten über den Assistenten erstellen, ändern oder löschen, auch wenn der Zustimmungsdialog den 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, wird die bestehende Zustimmung auf der Registerkarte „Zustimmungen“ widerrufen und die Verbindung erneut hergestellt, wobei im Zustimmungsdialog die gewünschte Zugriffsebene wieder ausgewählt wird.

Die Zustimmung wird von jedem Benutzer individuell verwaltet. Ein Benutzer kann lediglich seine eigene Zustimmung anzeigen und verwalten, während eine Admin-Ansicht zur Überprüfung oder Verwaltung der von anderen Benutzern erteilten Zustimmungen nicht existiert.