Tolgee
Gerencie as traduções do seu app diretamente do seu assistente de codificação de IA. Pesquise chaves, crie traduções, acione tradução automática. Tudo sem sair do seu editor.
Documentação
Versão: 3.x.x
O Tolgee MCP Server traz todo o poder do Tolgee para o seu assistente de codificação com IA, permitindo que você gerencie traduções sem nunca sair do seu editor. Conecte o Claude Code, Cursor ou qualquer assistente de IA compatível com MCP ao seu projeto Tolgee e comece a gerenciar tarefas de localização de forma conversacional.
O que é o servidor Tolgee MCP?
O servidor Tolgee MCP é o endpoint do Model Context Protocol integrado à plataforma Tolgee. Ele permite que assistentes de IA (Claude Desktop, Claude Code, Cursor, Windsurf, ChatGPT e qualquer outro cliente compatível com MCP) gerenciem seus projetos de localização Tolgee por meio de linguagem natural.
Ele está hospedado em https://app.tolgee.io/mcp/developer para o Tolgee Cloud e está disponível em todas as instâncias Tolgee auto-hospedadas. Sem proxy, sem processo separado. Seu cliente de IA fala diretamente com o Tolgee via HTTP.
O servidor é mantido pela equipe Tolgee e listado no MCP Registry como io.github.tolgee/tolgee.
Quais clientes MCP são suportados?
O servidor Tolgee MCP usa o transporte MCP padrão streamable-HTTP, portanto funciona com qualquer cliente compatível com MCP que suporte servidores HTTP remotos e cabeçalhos de solicitação personalizados. A autenticação é sempre feita por meio do cabeçalho X-API-Key.
Funções disponíveis
O servidor MCP atualmente expõe um único endpoint baseado em função:
| Função | Endpoint | Descrição |
|---|---|---|
| Desenvolvedor | /mcp/developer | Acesso total a chaves, traduções, idiomas, tags, namespaces, branches e operações em lote. |
Mais funções (ex.: tradutor, gerente de projeto) estão planejadas para versões futuras.
Como começar
- Siga o guia de configuração para conectar seu cliente de IA ao Tolgee.
- Consulte o guia de uso para exemplos de fluxos de trabalho e práticas recomendadas.
Como o servidor Tolgee MCP se compara ao Tolgee CLI e à API REST?
Todos os três falam com a mesma API Tolgee subjacente, mas atendem a fluxos de trabalho diferentes. O servidor MCP do Tolgee é para uso em linguagem natural dentro de um assistente de IA. O CLI do Tolgee é para operações scriptadas e repetíveis, como push e pull em pipelines de CI. A API REST do Tolgee é para criar suas próprias integrações, painéis ou recursos dentro do produto. Eles são complementares, não alternativas — a maioria das equipes acaba usando dois ou três.
| Servidor Tolgee MCP | Tolgee CLI | API REST Tolgee | |
|---|---|---|---|
| Melhor para | Uso conversacional em assistentes de IA | Scripts, sync/push/pull em CI | Criar seus próprios aplicativos e integrações |
| Onde você usa | Claude, Cursor, ChatGPT, Windsurf… | Terminal | Seu código (qualquer linguagem) |
| Autenticação | PAK ou PAT via X-API-Key | PAK ou PAT | PAK ou PAT |
| Descoberta | Alta (a IA lista ferramentas e solicita parâmetros ausentes) | Média (use tolgee --help) | Baixa (leia a especificação OpenAPI) |
| Determinismo | Menor — linguagem natural pode ser ambígua | Alto | Alto |
| Operações em lote | ✔ | ✔ | ✔ |
Um estado final comum entre nossos usuários:
- Servidor MCP — trabalho exploratório diário e correções pontuais dentro do Claude ou Cursor.
- CLI — sync comprometido entre repositório e Tolgee em CI (ex.:
tolgee pushao fazer merge emmain). - API REST — consulta de traduções no aplicativo, painéis personalizados ou webhooks.