Come funziona
Dal prompt alla release, senza lasciare l'editor.
Le tue chiavi vivono in Sonenta. Il tuo agente di codice le legge e le scrive via MCP. Il CDN le consegna alle tue app. Ecco i quattro passi, con il codice vero.
1. Installare l'SDK
Un pacchetto per framework. Le chiavi richiamate senza traduzione compaiono nel dashboard durante lo sviluppo, senza che tu debba strumentare nulla.
# 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. Collegare l'agente
sonenta init scrive la configurazione del progetto e un blocco in CLAUDE.md o AGENTS.md. Poi il server MCP si dichiara nel tuo client, in cinque righe di JSON. Lo stesso blocco vale per 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. Lasciare tradurre l'agente
Tu descrivi l'intenzione. L'agente sceglie i suoi strumenti, legge il glossario e il contesto, tratta solo le chiavi non tradotte, e propone. Gira sulla tua macchina: il flusso quotidiano non consuma crediti.
Traccia degli strumenti, un esempio
list_untranslated_keys namespace=checkout language_code=es
glossary_list · project_context_get
propose_translations_bulk
publish_cdn
4. Pubblicare
Una release costruisce un JSON per lingua e namespace, e il CDN lo serve. Le tue app caricano il nuovo bundle senza ridistribuire, e su mobile senza ripassare dagli store.
# depuis la CLI
sonenta releases
# ou depuis l'agent, via MCP
publish_cdn
CLI→ I cinque agenti Claude Code
sonenta agents add installa agenti specializzati nel tuo repository. Ognuno ha il suo perimetro e la sua pagina di documentazione.
-
sonenta-i18n: verifica la copertura, crea le chiavi mancanti, traduce in locale e pubblica.
doc → -
sonenta-knowledge: costruisce e mantiene il glossario e il contesto di progetto.
doc → -
sonenta-a11y: verifica e corregge le superfici di accessibilità.
doc → -
sonenta-surface: verifica e configura le superfici per schermo.
doc → -
sonenta-source-health: consolida le stringhe sorgente duplicate su una chiave canonica.
doc →