Descobrimos que agentes de programação com IA travam ao configurar internacionalização em apps web do zero. São etapas demais e todas interdependentes — roteamento por idioma, middleware, arquivos de tradução, wrappers de provider, seletor de idioma — e os agentes acabam perdendo de vista o que já foi feito e o que ainda falta.
Inspirados pelo Sequential Thinking MCP, criamos um servidor MCP gratuito que divide a configuração de i18n em um checklist guiado, seguido pelo agente passo a passo. Basta conectá-lo ao seu agente de IA, digitar "Set up i18n" e a configuração completa fica pronta em minutos.
O que o MCP oferece#
O servidor expõe quatro ferramentas para o agente de IA:
| Ferramenta | Finalidade |
|---|---|
i18n_checklist | Um guia de implementação passo a passo que coordena toda a configuração. O agente o chama em cada etapa para saber o que fazer em seguida. |
get_project_context | Captura a arquitetura do projeto — framework, roteador e estrutura de diretórios — para orientar a estratégia de implementação. |
get_framework_docs | Busca a documentação oficial do framework detectado (Next.js, React Router, TanStack Start). |
get_i18n_library_docs | Busca a documentação de bibliotecas de i18n (como react-intl) usadas na configuração de providers e componentes. |
A ferramenta i18n_checklist é a coordenadora. Ela guia o agente por 13 etapas — da análise do projeto ao roteamento por idioma, configuração de traduções, seletor de idioma e validação da build. Cada etapa diz ao agente exatamente o que implementar e quais ferramentas chamar.
O que é implementado#
Uma configuração típica guiada pelo MCP gera:
- Rotas sensíveis ao idioma — URLs com prefixo do idioma ativo (
/en/about,/es/about) - Seletor de idioma — Um componente de UI para alternar entre os idiomas compatíveis
- Detecção de idioma — Detecção automática do idioma preferido do usuário
- Infraestrutura de tradução — Configuração de provider, arquivos de tradução e funções auxiliares
Frameworks compatíveis#
| Framework | Versões |
|---|---|
| Next.js App Router | v13-16 |
| Next.js Pages Router | v13-16 |
| TanStack Start | v1 |
| React Router | v7 |
Consumo#
Depois de conectar o MCP ao seu assistente de programação com IA, envie 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, em seguida, segue as etapas guiadas — usando as outras ferramentas quando necessário. O resultado é uma configuração de i18n funcional, adaptada ao seu framework e à estrutura do seu projeto.
A programação assistida por IA é inerentemente não determinística. O MCP melhora a consistência com sua abordagem guiada por checklist, mas os resultados exatos podem variar de uma execução para outra.
