Administração

Servidor MCP (Integrações)

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

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.

  • Criando, editando e excluindo 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 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:

  1. Abra a Paleta de Comandos (Ctrl/Cmd+Shift+P) e execute Authentication: Remova os Provedores de Autenticação Dinâmica, em seguida, selecione a entrada do servidor Phrase MCP.

  2. Abra o menu Contas, localize a conta vinculada ao servidor Phrase e abra Gerenciar servidores MCP confiáveis para revogá-la, ou saia dessa entrada de conta.

  3. Na visualização MCP, ou via MCP: Listar Servidores, pare e reinicie a conexão do servidor, ou execute Developer: Recarregar Janela.

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 de função e o consentimento do conector operam de forma independente, e o mais restritivo dos dois sempre determina o acesso real. 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 Consentimentos.

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 reconecta, selecionando o nível de acesso desejado novamente 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. 

 

Artigos relacionados

Esse artigo foi útil?
★ ★ ★ ★ ★

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.