Správa

Server MCP (integrace)

Obsah je strojově přeložen z angličtiny s použitím Phrase Language AI.

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

Mezi typické úkoly patří:

  • 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 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 prohledává pouze referenční dokumentaci k API Strings a nemá přístup k datům projektů 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.

Připojení Remote se ověřuje pomocí OAuth, což je jediný ověřovací 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í ověřování pomocí hlaviček, nejsou v současné době pro připojení Remote podporovány. Patří sem tokeny typu bearer, 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. Tuto kontrolu proveďte také na kartě Consents v nastavení profilu Phrase.

Zastaralé ověření 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ů:

  1. Otevřete paletu příkazů (Ctrl/Cmd+Shift+P) a spusťte příkaz Authentication: Remove Dynamic Authentication Providers a poté vyberte záznam serveru Phrase MCP.

  2. Otevřete nabídku Accounts, vyhledejte účet propojený se serverem Phrase a v části Manage Trusted MCP Servers tomuto serveru odeberte důvěryhodnost, případně se u daného účtu odhlaste.

  3. 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í s vlastním hostingem (zastaralé)

Připojení s vlastním hostingem 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 Phrase MCP Server na portálu Developer Hub.

Po připojení naleznete v článku Server Starter Prompts na portálu Developer Hub pečlivě vybraný seznam ú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: prohlížení dat, vytváření dat nebo úpravy a mazání dat. Toto omezení platí vedle stávajících oprávnění rolí v Phrase, nikoli místo nich, takže asistent nemůže překročit oprávnění, která účet již má.

Oprávnění daná rolí a souhlas udělený konektoru se uplatňují nezávisle na sobě a skutečný přístup vždy určuje přísnější z obou omezení. 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ě Consents.

Stávající souhlas nelze přímo upravit. Chcete-li změnit úroveň přístupu udělenou asistentovi, uživatel odvolá stávající souhlas na kartě Consents a znovu se připojí, přičemž v dialogovém okně souhlasu znovu vybere požadovanou úroveň přístupu.

Souhlas spravuje každý uživatel individuálně. Uživatel vidí a spravuje pouze své vlastní souhlasy; správci nemají k dispozici zobrazení pro kontrolu nebo správu souhlasů udělených jinými uživateli. 

 

Související články

Byl pro vás tento článek užitečný?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.