Disponível para
-
Todos os planos Phrase, atualmente sem custo adicional
O servidor MCP (Model Context Protocol) do Phrase conecta assistentes de IA, como o Claude, ao Phrase. Ele traz a inteligência linguística do Phrase para essas ferramentas, permitindo que os assistentes trabalhem com projetos, trabalhos e traduções usando linguagem natural. O servidor abrange o Phrase TMS, o Phrase Strings e outros recursos do Phrase expostos por meio da API, e opera acima desses produtos individuais, em vez de dentro de um deles.
Recursos
O servidor MCP traz a inteligência linguística do Phrase para ferramentas de IA já em uso, permitindo que conteúdo, trabalhos e traduções sejam processados com linguagem natural onde quer que o trabalho aconteça. Tarefas típicas incluem:
-
Fazer perguntas sobre projetos e trabalhos.
-
Solucionar problemas de qualidade em todo o conteúdo sem abrir arquivos ou idiomas individuais.
-
Criar trabalhos ou reatribuir projetos.
-
Realizar atualizações em massa em vez de atualizar um item de cada vez.
-
Criação, edição e exclusão de conectores do Phrase TMS.
Opções de conexão
O servidor MCP suporta dois métodos de conexão.
Conexão remota (recomendado)
A conexão remota usa o login com uma conta Phrase existente e não requer instalação. Este método funciona com ferramentas de IA que suportam a conexão a um servidor remota.
A visibilidade da ferramenta no assistente de IA conectado depende do token de acesso OAuth emitido no login, que cobre apenas os produtos Phrase aos quais o usuário conectado tem acesso dentro da organização da Plataforma usada para estabelecer a conexão. Se um usuário não tiver acesso a um determinado produto, como o Phrase Strings, dentro dessa organização da Plataforma, as ferramentas para esse produto não funcionarão, mesmo que apareçam na lista. Por exemplo, uma ferramenta de pesquisa do Strings ainda pode aparecer, mas ela pesquisa apenas a referência da API do Strings e não consegue acessar os dados dos projetos do Strings.
Para resolver a falta de acesso ao produto, primeiro conceda ao usuário acesso ao produto dentro da organização da Plataforma. Em seguida, desconecte e reconecte o servidor MCP na ferramenta de IA para que um novo token de acesso, refletindo o acesso atualizado, seja emitido.
A conexão remota autentica usando OAuth, o único protocolo de autenticação atualmente suportado para este método. Ferramentas de fluxo de trabalho personalizadas ou de terceiros que exigem autenticação manual baseada em cabeçalho não são suportadas atualmente para conexão remota. Isso inclui tokens de portador, chaves de API e credenciais máquina a máquina (M2M).
Autenticação obsoleta no VS Code
O Visual Studio Code (VS Code) armazena em cache o ID do cliente registrado em um servidor MCP, indexado pela URL do servidor em vez do nome de exibição. Se esse ID de cliente não existir mais no servidor Phrase, o VS Code continua enviando o ID obsoleto em vez de acionar um novo registro. Isso resulta em um erro 400 Bad Request relatando um client_id e redirect_uri incompatíveis, em vez da tela de consentimento esperada. Remover e reinstalar a entrada do servidor, ou renomeá-la, no mcp.json não limpa o registro armazenado em cache, já que o cache é indexado pela URL do servidor.
Para resolver este problema no VS Code 1.101 ou posterior, siga estas etapas:
-
Abra a Paleta de Comandos (Ctrl/Cmd+Shift+P) e execute Authentication: Remove Dynamic Authentication Providers e selecione a entrada do servidor Phrase MCP.
-
Abra o menu , localize a conta vinculada ao servidor Phrase e abra Gerenciar servidores MCP confiáveis para revogá-la, ou saia dessa entrada de conta.
-
Na visualização MCP, ou via MCP: List Servers, interrompa e reinicie a conexão com o servidor ou execute Developer: Reload Window.
A próxima chamada de ferramenta aciona um novo registro e exibe a tela de consentimento.
Nota
Se estas etapas não limparem o registro obsoleto, limpe a autenticação armazenada manualmente no armazenamento de credenciais do sistema operacional (SO) (Keychain do macOS, Gerenciador de Credenciais do Windows ou libsecret no Linux) e no armazenamento global do VS Code. Isso limpa a autenticação para quaisquer outros servidores MCP configurados.
Conexão auto-hospedada (Descontinuada)
A conexão auto-hospedada é executada em infraestrutura gerenciada pela equipe e requer Node.js e um arquivo de configuração.
Introdução
Encontre as etapas completas de configuração para ambas as opções de conexão, incluindo comandos para diferentes ferramentas de IA, no artigo do Developer Hub Phrase MCP Server.
Após conectar, encontre uma lista selecionada de prompts iniciais organizados por tarefa no artigo do Developer Hub Server Starter Prompts.
Permissões
Ao conectar, o titular da conta seleciona o nível de acesso concedido ao assistente: visualizar dados, criar dados ou modificar e excluir dados. Isso se aplica além das permissões de função existentes do Phrase, não em vez delas, portanto, o assistente não pode exceder o que a conta já permite.
As permissões da função e o consentimento do conector funcionam de forma independente, e o nível de acesso mais restritivo entre os dois sempre determina o acesso efetivo. Por exemplo, um usuário com uma função de apenas visualização não pode criar, modificar ou excluir dados por meio do assistente, mesmo que a caixa de diálogo de consentimento conceda acesso de criação ou modificação e exclusão.
Revise ou revogue o acesso a qualquer momento nas configurações de perfil do Phrase, na aba .
Um consentimento existente não pode ser editado diretamente. Para alterar o nível de acesso concedido a um assistente, o usuário revoga o consentimento existente na guia Consentimentos e se reconecta ao assistente, selecionando novamente o nível de acesso desejado na caixa de diálogo de consentimento.
O consentimento é gerenciado individualmente por cada usuário. Um usuário vê e controla apenas seu próprio consentimento, e não há uma visualização de administrador para revisar ou gerenciar os consentimentos concedidos por outros usuários.