Descobrimos que os agentes de programação com IA tendem a ficar bloqueados quando configuram internacionalização em aplicações web de raiz. São demasiados passos interdependentes — routing por idioma, middleware, ficheiros de tradução, wrappers de providers, seletor de idioma — e os agentes perdem facilmente o rasto do que já foi feito e do que ainda falta.
Inspirados pelo Sequential Thinking MCP, criámos um servidor MCP gratuito que divide a configuração de i18n numa checklist guiada, que o agente segue passo a passo. Ligue-o ao seu agente de IA, escreva "Set up i18n" e a configuração completa fica pronta em minutos.
O que o MCP oferece#
O servidor disponibiliza quatro ferramentas ao agente de IA:
| Ferramenta | Finalidade |
|---|---|
i18n_checklist | Um guia de implementação passo a passo que coordena toda a configuração. O agente chama-o em cada etapa para saber o que fazer a seguir. |
get_project_context | Capta a arquitetura do projeto — framework, router, estrutura de diretórios — para orientar a estratégia de implementação. |
get_framework_docs | Obtém a documentação oficial da framework detetada (Next.js, React Router, TanStack Start). |
get_i18n_library_docs | Obtém documentação de bibliotecas de i18n (por exemplo, react-intl) usadas durante a configuração de providers e componentes. |
A ferramenta i18n_checklist é a coordenadora. Leva o agente por 13 passos — desde a análise do projeto até ao routing por idioma, configuração das traduções, seletor de idioma e validação da build. Cada passo diz ao agente exatamente o que implementar e que ferramentas chamar.
O que é implementado#
Uma configuração típica orientada pelo MCP produz:
- Rotas adaptadas ao idioma — URLs prefixados com o idioma ativo (
/en/about,/es/about) - Seletor de idioma — Um componente de UI para alternar entre os idiomas suportados
- Deteção de idioma — Deteção automática do idioma preferido do utilizador
- Infraestrutura de tradução — Configuração de providers, ficheiros de tradução e funções auxiliares
Frameworks suportadas#
| Framework | Versões |
|---|---|
| Next.js App Router | v13-16 |
| Next.js Pages Router | v13-16 |
| TanStack Start | v1 |
| React Router | v7 |
consumo#
Quando o MCP estiver ligado ao seu assistente de programação com IA, use este prompt:
Set up i18n
Ou especifique os idiomas:
Set up i18n with the following locales: en, es, and pt-BR. The default locale is "en".
O agente chama i18n_checklist para começar e depois segue os passos guiados, recorrendo às outras ferramentas sempre que necessário. O resultado é uma configuração de i18n funcional, adaptada à sua framework e à estrutura do seu projeto.
A programação assistida por IA é inerentemente não determinística. O MCP melhora a consistência através da sua abordagem orientada por checklist, mas os resultados exatos podem variar entre execuções.
