K dispozici pro
-
Všechny plány Phrase, aktuálně bez dalších nákladů
Server Phrase MCP (Model Context Protocol Server) 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
Server MCP 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 serveru MCP přístupná. Asistenti AI připojení přes MCP nemohou vyhledávat ani načítat 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í
Server MCP podporuje dvě metody připojení.
Připojení Remote (doporučeno)
Připojení Remote 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, k nimž má přihlášený uživatel přístup v rámci organizace na platformě použité k připojení. Pokud uživatel nemá v rámci dané organizace na platformě 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 na platformě. 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.
Připojení Remote se autentizuje pomocí OAuth, což je jediný autentizační protokol, který je v současné době pro tuto metodu podporován. Vlastní nebo externí nástroje pracovních postupů, které vyžadují ruční autentizaci založenou na hlavičkách, nejsou v současné době pro připojení Remote podporovány. To zahrnuje nosné tokeny (bearer tokens), klíče API a přihlašovací údaje typu stroj-stroj (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. Tato kontrola se provádí kromě 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í neshodné 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 záznam serveru Phrase MCP.
-
Otevřete nabídku , vyhledejte účet propojený se serverem Phrase a v nabídce Manage Trusted MCP Servers odeberte server ze seznamu důvěryhodných serverů, případně se z tohoto úč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 neodstraní zastaralou registraci, ručně vymažte uložené přihlašovací údaje z úložiště přihlašovacích údajů operačního systému (OS) (macOS Keychain, Windows Credential Manager nebo libsecret v Linuxu) 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í s vlastním hostováním (zastaralé)
Připojení s vlastním hostováním funguje na infrastruktuře spravované týmem a vyžaduje Node.js a konfigurační soubor.
Začínáme
Úplný postup nastavení obou možností připojení, včetně příkazů pro různé nástroje AI, naleznete v článku Developer Hub Phrase MCP Server.
Po připojení najdete v článku Developer Hub Server Starter Prompts pečlivě vybraný seznam úvodních zadání uspořádaných podle úkolů.
Oprávnění
Při připojování vybere držitel účtu úroveň přístupu uděleného asistentovi: prohlížení dat, vytváření dat nebo úpravy a mazání dat. Tato úroveň přístupu platí vedle stávajících oprávnění rolí v systému Phrase, nikoli místo nich, takže asistent nemůže získat širší přístup, než jaký účet již umožňuje.
Oprávnění rolí a souhlas s přístupem konektoru fungují nezávisle a skutečný přístup vždy určuje přísnější z těchto dvou omezení. Například uživatel s rolí umožňující pouze prohlížení nemůže prostřednictvím asistenta vytvářet, upravovat ani mazat data, ani když v dialogovém okně souhlasu udělí přístup k vytváření dat nebo k jejich ú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. Chcete-li změnit úroveň přístupu udělenou asistentovi, odvolejte stávající souhlas na kartě Consents a znovu se připojte. V dialogovém okně souhlasu pak vyberte požadovanou úroveň přístupu.
Souhlas spravuje každý uživatel individuálně. Uživatel vidí a ovládá pouze svůj vlastní souhlas a neexistuje žádné zobrazení správce pro kontrolu nebo správu souhlasů udělených jinými uživateli.