Quickstart · pour développeurs
Pilotez votre i18n depuis votre éditeur
Sonenta est MCP-first : il s’intègre à l’environnement de dev IA que vous utilisez déjà — Claude Code, Cursor, Claude Desktop — pour créer des clés, traduire et publier en le demandant à votre agent, là où vous codez. Fini le copier-coller de textes dans un dashboard.
1 · Récupérez votre clé API
Récupérez une clé API de projet, une fois — depuis le dashboard, ou directement dans votre terminal :
npx @sonenta/cli loginObtenir une clé dans le dashboard →
2 · Ajoutez le MCP Sonenta à votre environnement IA
Collez ceci dans votre config MCP (Claude Desktop, Claude Code, ou .cursor/mcp.json). Votre agent dispose alors des outils pour créer des clés, traduire avec l’IA et publier sur le CDN — p. ex. create_keys_bulk, propose_translations_bulk, publish_cdn.
{
"mcpServers": {
"sonenta": {
"command": "npx",
"args": ["-y", "@sonenta/mcp"],
"env": {
"SONENTA_API_KEY": "snt_live_<prefix>.<secret>",
"SONENTA_PROJECTS": "<project_uuid>"
}
}
}
} Voir la configuration MCP complète pour les spécificités Cursor / Claude Code / Claude Desktop et la liste complète des outils.
3 · Installez le SDK runtime dans votre app
Ajoutez le SDK pour que votre app charge les traductions en direct depuis le CDN. @sonenta/react-i18next est un remplacement direct de react-i18next — gardez vos appels t().
npm i @sonenta/react-i18next
import { SonentaProvider } from "@sonenta/react-i18next";
<SonentaProvider token={import.meta.env.VITE_SONENTA_TOKEN} projectUuid="proj_xxx" defaultLocale="fr">
<App />
</SonentaProvider> 4 · Travaillez depuis votre éditeur
Il suffit ensuite de demander à votre agent, en langage clair :
« Extrais les nouveaux textes du tunnel de paiement, crée les clés dans le namespace checkout, traduis-les en FR et ES, puis publie. » Il appelle les outils MCP Sonenta et les clés sont en ligne. Vous préférez scripts/CI ? La CLI sonenta (@sonenta/cli) fait pareil — sonenta push, sonenta pull, sonenta import. Dans tous les cas : aucune saisie manuelle de clés.
Pour aller plus loin
- Configuration MCP (Cursor / Claude Code / Desktop) + outils
- Agents pour Claude Code (sonenta agents add)
- React + react-i18next (quickstart SDK complet)
- Vue 3 · @sonenta/vue-i18n
- Svelte · @sonenta/svelte-i18n
- Next.js App Router · @sonenta/next
- CLI : installer, push, pull
- Widget de feedback utilisateur
- Migrer depuis i18next
- Référence API