K dispozici pro
-
Všechny plány Phrase, aktuálně bez dalších nákladů
Phrase MCP Server (server protokolu Model Context Protocol) propojuje asistenty AI, jako je Claude, s Phrase. Přináší jazykovou inteligenci Phrase do těchto nástrojů a umožňuje asistentům pracovat s projekty, úlohami a překlady pomocí přirozeného jazyka. Server zahrnuje Phrase TMS, Phrase Strings a další funkce Phrase zpřístupněné prostřednictvím API a funguje nad těmito jednotlivými produkty, nikoli v rámci jednoho z nich.
Možnosti
MCP Server přináší jazykovou inteligenci Phrase do již používaných nástrojů AI, což umožňuje pracovat s obsahem, úlohami a překlady pomocí přirozeného jazyka kdekoli, kde práce probíhá.
Data Phrase Analytics nejsou v současné době prostřednictvím MCP Serveru přístupná. Asistenti AI připojení přes MCP nemohou vyhledávat ani získávat analytické přehledy či metriky. Pro pracovní postupy založené na analytice, jako je vytváření automatizovaných přehledů, se připojte přímo prostřednictvím Phrase Data.
Typické úkoly zahrnují:
-
Pokládání otázek ohledně projektů a úloh.
-
Řešení problémů s kvalitou napříč obsahem bez otevírání jednotlivých souborů nebo jazyků.
-
Vytváření úloh nebo opětovné přiřazování projektů.
-
Provádění hromadných aktualizací namísto aktualizace jedné položky po druhé.
-
Vytváření, úpravy a mazání konektorů Phrase TMS.
Možnosti připojení
MCP Server podporuje dvě metody připojení.
Vzdálené připojení (doporučeno)
Vzdálené připojení využívá přihlášení ke stávajícímu účtu Phrase a nevyžaduje žádnou instalaci. Tato metoda funguje s nástroji AI, které podporují připojení ke vzdálenému serveru.
Viditelnost nástrojů v připojeném asistentovi AI závisí na přístupovém tokenu OAuth vydaném při přihlášení, který se vztahuje pouze na produkty Phrase, ke kterým má přihlášený uživatel přístup v rámci organizace Platformy použité k připojení. Pokud uživatel nemá v rámci dané organizace Platformy přístup k určitému produktu, jako je Phrase Strings, nástroje pro tento produkt nefungují, i když se v seznamu zobrazují. Například vyhledávací nástroj Strings se může stále zobrazovat, ale vyhledává pouze v referenční příručce API Strings a nemůže přistupovat k datům projektu Strings.
Chcete-li vyřešit chybějící přístup k produktu, nejprve uživateli udělte přístup k produktu v rámci organizace Platformy. Poté odpojte a znovu připojte server MCP v nástroji AI, aby byl vydán nový přístupový token, který odráží aktualizovaný přístup.
Vzdálené připojení používá k ověřování OAuth, což je v současné době jediný autentizační protokol podporovaný pro tuto metodu. Vlastní nástroje nebo nástroje třetích stran pro pracovní postupy, které vyžadují ruční ověřování pomocí hlaviček, nejsou v současné době pro vzdálené připojení podporovány. To zahrnuje tokeny typu bearer, klíče API a přihlašovací údaje pro komunikaci mezi stroji (M2M).
Některé nástroje AI ukládají své vlastní záznamy o připojení k serveru odděleně od Phrase. Pokud se pokus o přihlášení nezdaří kvůli chybě na straně serveru, jako je Whitelabel Error Page nebo HTTP 500 Internal Server Error, zkontrolujte v nastavení konektoru nebo serveru daného nástroje AI, zda tam není starý nebo duplicitní záznam serveru Phrase MCP. Před dalším pokusem o připojení jakýkoli takový záznam odstraňte. Tuto kontrolu proveďte také vedle kontroly karty Consents v nastavení profilu Phrase.
Zastaralá autentizace ve VS Code
Visual Studio Code (VS Code) ukládá do mezipaměti ID klienta registrované u serveru MCP, přičemž klíčem je adresa URL serveru, nikoli zobrazovaný název. Pokud toto ID klienta již na serveru Phrase neexistuje, VS Code nadále odesílá zastaralé ID, místo aby spustil novou registraci. To vede k chybě 400 Bad Request, která hlásí nesoulad mezi client_id a redirect_uri, namísto očekávané obrazovky se souhlasem. Odstranění a opětovná instalace záznamu serveru nebo jeho přejmenování v mcp.json nevymaže registraci uloženou v mezipaměti, protože klíčem mezipaměti je adresa URL serveru.
Chcete-li tento problém vyřešit ve VS Code 1.101 nebo novějším, postupujte podle těchto kroků:
-
Otevřete paletu příkazů (Ctrl/Cmd+Shift+P) a spusťte Authentication: Remove Dynamic Authentication Providers, poté vyberte položku serveru Phrase MCP.
-
Otevřete nabídku , vyhledejte účet propojený se serverem Phrase a otevřete Manage Trusted MCP Servers, kde serveru odeberete důvěryhodnost, nebo se u daného účtu odhlaste.
-
V zobrazení MCP nebo prostřednictvím MCP: List Servers, zastavte a restartujte připojení k serveru nebo spusťte Developer: Reload Window.
Další volání nástroje spustí novou registraci a zobrazí obrazovku se souhlasem.
Poznámka
Pokud tyto kroky nevymažou zastaralou registraci, vymažte uložené ověření ručně z úložiště pověření operačního systému (OS) (macOS Keychain, Windows Credential Manager nebo libsecret v systému Linux) a z globálního úložiště VS Code. Tím se vymaže ověření pro všechny ostatní nakonfigurované servery MCP.
Připojení provozované na vlastní infrastruktuře (zastaralé)
Připojení provozované na vlastní infrastruktuře běží na infrastruktuře spravované týmem a vyžaduje Node.js a konfigurační soubor.
Začínáme
Úplné kroky nastavení pro obě možnosti připojení, včetně příkazů pro různé nástroje AI, naleznete v článku Developer Hub Phrase MCP Server.
Po připojení naleznete v článku Developer Hub Server Starter Prompts výběr úvodních výzev uspořádaných podle úkolů.
Oprávnění
Při připojování vybere držitel účtu úroveň přístupu uděleného asistentovi: zobrazení dat, vytvoření dat nebo úprava a odstranění dat. Toto platí vedle stávajících oprávnění rolí v Phrase, nikoli místo nich, takže asistent nemůže překročit rozsah přístupu, který účet již umožňuje.
Oprávnění rolí a souhlas konektoru fungují nezávisle a skutečný přístup vždy určuje to restriktivnější z nich. Například uživatel s rolí pouze pro zobrazení nemůže prostřednictvím asistenta vytvářet, upravovat ani mazat data, i když dialogové okno souhlasu uděluje přístup k vytváření nebo úpravám a mazání.
Přístup můžete kdykoli zkontrolovat nebo odvolat v nastavení profilu Phrase na kartě .
Stávající souhlas nelze přímo upravit. Chce-li uživatel změnit úroveň přístupu udělenou asistentovi, odvolá stávající souhlas na kartě Consents a znovu se připojí. V dialogovém okně souhlasu pak vybere požadovanou úroveň přístupu.
Souhlas spravuje každý uživatel individuálně. Uživatel vidí a spravuje pouze svůj vlastní souhlas a správce nemá k dispozici žádné zobrazení pro kontrolu ani správu souhlasů udělených jinými uživateli.