Como funciona
Do prompt à release, sem sair do seu editor.
As suas chaves vivem na Sonenta. O seu agente de código lê-as e escreve-as via MCP. O CDN entrega-as às suas apps. Aqui estão os quatro passos, com o código real.
1. Instalar o SDK
Um pacote por framework. As chaves invocadas sem tradução aparecem no dashboard durante o desenvolvimento, sem que tenha de instrumentar nada.
# React (web)
npm i @sonenta/react-i18next
# Next.js · Vue · Svelte · Astro
npm i @sonenta/next
npm i @sonenta/vue-i18n
npm i @sonenta/svelte-i18n
npm i @sonenta/astro
2. Ligar o agente
sonenta init escreve a configuração do projeto e um bloco em CLAUDE.md ou AGENTS.md. Depois o servidor MCP declara-se no seu cliente, em cinco linhas de JSON. O mesmo bloco vale para Claude Code, Cursor e Claude Desktop.
{
"mcpServers": {
"sonenta": {
"command": "npx",
"args": ["-y", "@sonenta/mcp"],
"env": {
"SONENTA_API_KEY": "snt_live_<prefix>.<secret>",
"SONENTA_PROJECTS": "<uuid1>,<uuid2>"
}
}
}
}
MCP→ 3. Deixar o agente traduzir
Você descreve a intenção. O agente escolhe as suas ferramentas, lê o glossário e o contexto, só trata as chaves não traduzidas, e propõe. Corre na sua máquina: o fluxo do dia a dia não gasta créditos.
Rasto de ferramentas, um exemplo
list_untranslated_keys namespace=checkout language_code=es
glossary_list · project_context_get
propose_translations_bulk
publish_cdn
4. Publicar
Uma release constrói um JSON por língua e namespace, e o CDN serve-o. As suas apps carregam o novo bundle sem nova implantação, e no móvel sem passar pelas lojas.
# depuis la CLI
sonenta releases
# ou depuis l'agent, via MCP
publish_cdn
CLI→ Os cinco agentes do Claude Code
sonenta agents add instala agentes especializados no seu repositório. Cada um tem o seu âmbito e a sua página de documentação.
-
sonenta-i18n: audita a cobertura, cria as chaves em falta, traduz localmente e publica.
doc → -
sonenta-knowledge: constrói e mantém o glossário e o contexto de projeto.
doc → -
sonenta-a11y: audita e corrige as superfícies de acessibilidade.
doc → -
sonenta-surface: audita e configura as superfícies por ecrã.
doc → -
sonenta-source-health: consolida as cadeias de origem duplicadas numa chave canónica.
doc →