Aller au contenu
Sonenta
← Toute la documentation

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 login
Obtenir 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