Locize

Locize TMS: 26 ferramentas para traduções, contexto de TM/glossário/guia de estilo/captura de tela, versões. OAuth.

Ver em locize.comExperimente este MCPPatrocinado

Documentação

Servidor MCP Locize

O servidor MCP (Model Context Protocol) do Locize permite que assistentes de IA (Claude, Cursor, GitHub Copilot e outros) interajam diretamente com seus projetos de tradução.

URL do servidor: https://mcp.locize.app

smart_display

Vídeo do YouTube

Este vídeo está hospedado no YouTube. Aceite os cookies do YouTube para assisti-lo aqui.

Assistir no YouTubeAtualizar preferências de cookies

Configuração

Claude Desktop / claude.ai (OAuth)

Vá para Configurações > Conectores > Adicionar conector personalizado
Insira a URL: https://mcp.locize.app
Clique em Conectar e seu navegador abrirá uma tela de login/consentimento
Entre com sua conta Locize e conceda as permissões solicitadas
Um Personal Access Token é criado automaticamente no seu perfil

Claude Code (CLI)

Copiar

claude mcp add --transport http locize https://mcp.locize.app

Em seguida, execute /mcp em uma sessão do Claude Code e conclua o fluxo OAuth.

Observação: Após o primeiro OAuth, o Claude Code pode exibir "Autenticação bem-sucedida, mas a reconexão do servidor falhou." Este é um problema conhecido do Claude Code; basta reiniciar o Claude Code e o servidor se conectará automaticamente usando o token armazenado.

Outros clientes nativos HTTP (Cursor, VS Code, etc.)

Adicione a URL do servidor https://mcp.locize.app nas configurações de MCP do seu cliente e conclua o fluxo OAuth. As etapas exatas variam conforme o cliente; consulte a documentação de MCP do seu cliente.

Transporte Stdio (alternativa ao PAT)

Para clientes que suportam stdio, mas não HTTP, use o mcp-remote como ponte:

Copiar

{
  "mcpServers": {
    "locize": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.locize.app"]
    }
  }
}

Autenticação

O servidor MCP suporta dois métodos de autenticação:

OAuth 2.0 (recomendado): usado automaticamente pelo Claude Desktop, Cursor e outros clientes MCP que o suportam. Nenhum gerenciamento manual de token é necessário. O fluxo OAuth cria um Personal Access Token no seu perfil automaticamente. O acesso pode ser revogado a qualquer momento.

Personal Access Token (PAT): para CI/CD, scripts ou clientes que não suportam OAuth. Crie um no seu perfil em Personal Access Tokens. Passe-o como Authorization: Bearer lz_pat_.... Consulte a documentação do PAT para detalhes sobre escopos e segurança.

Ferramentas disponíveis

O servidor MCP expõe 26 ferramentas organizadas por fluxo de trabalho:

Descoberta

Ferramenta	Descrição
list_projects	Lista todos os projetos acessíveis via seu token. Chame esta primeiro.
get_project_stats	Cobertura de tradução por versão, idioma e namespace
list_branches	Lista projetos de branch de um projeto pai
list_tenants	Lista projetos de tenant de um projeto pai

Conteúdo de tradução

Ferramenta	Descrição
get_translations	Busca traduções não publicadas (estado do editor) com filtragem por tags, timestamps e paginação
get_published_translations	Busca traduções publicadas (CDN) para um namespace
find_missing_translations	Compara um idioma de destino com o idioma de referência; retorna chaves ausentes e desatualizadas
report_missing_keys	Adiciona novas chaves (nunca sobrescreve as existentes). Agrupa automaticamente em lotes de 1000 chaves. Se a Tradução Automática estiver habilitada, novas chaves no idioma de referência são traduzidas automaticamente para todos os idiomas de destino.
update_translations	Atualiza ou exclui chaves de tradução. Defina um valor como null para excluir.

Contexto

Essas ferramentas somente leitura dão ao agente o mesmo contexto que um tradutor humano tem, para que ele possa traduzir, revisar e fazer lint no seu IDE.

Ferramenta	Descrição
get_glossary	Busca o glossário de terminologia do projeto (termos aprovados e proibidos por idioma). Use o valor preferido de cada termo ao traduzir, ou faça lint de novas strings de origem para verificar desvios de termos proibidos.
get_styleguide	Busca o guia de estilo do projeto (tom, formalidade, público-alvo, regras de uso) por idioma
search_translation_memory	Encontra segmentos traduzidos anteriormente semelhantes a uma string de origem (exata + aproximada) para reutilizar traduções anteriores
get_screenshot_context	Busca a(s) captura(s) de tela e a região mapeada onde uma chave aparece, para desambiguação visual

Fluxo de trabalho de release

Ferramenta	Descrição
publish_version	Publica uma versão no CDN. Retorna um jobId para acompanhamento de status.
copy_version	Copia todas as traduções de uma versão para outra (ex.: latest → production)
copy_language	Copia um único idioma entre versões
get_job_status	Verifica ou aguarda a conclusão de operações assíncronas (publish, copy, merge)

Fluxo de trabalho de branch

Ferramenta	Descrição
create_branch	Cria um branch de tradução a partir de uma versão
merge_branch	Mescla um branch de volta ao seu projeto pai

Estrutura do projeto

Ferramenta	Descrição
add_language	Adiciona um idioma ao projeto
remove_language	Remove um idioma e todas as suas traduções
change_languages	Substitui toda a lista de idiomas atomicamente
add_version	Adiciona uma nova versão
delete_version	Exclui uma versão e todas as suas traduções
rename_namespace	Renomeia um namespace em todos os idiomas
delete_namespace	Exclui um namespace e todas as suas traduções

Exemplos de prompts

Depois de conectado, você pode pedir ao seu assistente de IA coisas como:

"Encontre todas as traduções em alemão ausentes no namespace checkout"
"Publique a versão mais recente do meu projeto"
"Adicione japonês a todas as versões"
"Crie um branch para o recurso v2, traduza-o e depois mescle-o de volta"
"Mostre-me quais chaves mudaram em inglês esta semana"
"Reporte estas novas chaves do meu código para o Locize"
"Qual é a cobertura de tradução da versão de produção?"
"Traduza estas novas strings usando o glossário e o guia de estilo do projeto"
"Faça lint das novas strings em inglês deste PR para verificar termos proibidos do glossário"
"Mostre-me a captura de tela onde a chave checkout.title aparece"

Convenções do agente

Para fazer seu agente de IA usar essas ferramentas por padrão — buscar o glossário e o guia de estilo antes de traduzir, reutilizar a memória de tradução e fazer lint de pull requests para termos proibidos — coloque nossos arquivos de convenção prontos (CLAUDE.md, AGENTS.md, .cursorrules) no seu repositório. Eles estão no repositório público locize/locize-agents.

Escopos do PAT

As ferramentas exigem escopos específicos do PAT. Se uma ferramenta retornar um erro de escopo, seu token precisa de permissões adicionais.

Escopo	Ferramentas
read	list_projects, get_project_stats, list_branches, list_tenants, get_translations, get_published_translations, find_missing_translations, get_glossary, get_styleguide, search_translation_memory, get_screenshot_context
write	report_missing_keys, update_translations, rename_namespace, delete_namespace
manage	publish_version, copy_version, copy_language, get_job_status, create_branch, merge_branch, add_language, remove_language, change_languages, add_version, delete_version

Além dos escopos do PAT

Os escopos do PAT são apenas a primeira barreira. Seu papel e permissões no nível do projeto ainda se aplicam por cima:

Papel no projeto: seu papel em um determinado projeto (admin / manager / publisher / user / accountant) sempre prevalece quando é mais restritivo que o escopo do PAT. Por exemplo, um PAT com escopo manage chamado por um usuário cujo papel no projeto é readonly ainda não pode modificar esse projeto.
Escopo de idioma / versão / namespace: se sua associação for restrita a idiomas, versões ou namespaces específicos, get_translations e find_missing_translations rejeitarão solicitações fora desse escopo.
Usuários translateOnly: as ferramentas estruturais (add_language, remove_language, change_languages, add_version, delete_version, publish_version, copy_version, copy_language, create_branch, merge_branch, rename_namespace, delete_namespace) são bloqueadas para usuários marcados como somente tradução.
Acesso bloqueado / revogado: se sua associação ao projeto for bloqueada ou seu PAT for revogado, toda chamada de ferramenta falha imediatamente com um 401.
Acesso ao projeto pai: para projetos de tenant e branch, a mesclagem de traduções com o pai só acontece se seu PAT também tiver acesso ao projeto pai; caso contrário, você verá apenas a visão do filho.

Detalhes técnicos

Transporte: Streamable HTTP (Web Standard Request/Response)
Autenticação: OAuth 2.0 (Authorization Code + PKCE com Dynamic Client Registration) ou token Bearer PAT
Endpoint: POST https://mcp.locize.app
Metadados OAuth: GET https://mcp.locize.app/.well-known/oauth-protected-resource
Sem estado: Cada solicitação cria uma nova instância do servidor MCP. Nenhum gerenciamento de sessão é necessário.

Veja também

Por que não usar apenas IA para traduzir?: como o Locize e as ferramentas de IA se complementam
Tradução Automática: combine saveMissing com auto-tradução por IA para um fluxo de trabalho totalmente automatizado
Personal Access Tokens: crie e gerencie tokens para autenticação MCP

cookie arrow_upward