Créer un projet et des clés API

Pour piloter Sonenta depuis votre code, il vous faut un projet et une clé API. Tout se fait en CLI, avec une connexion compte par navigateur (style gh / gcloud, sans mot de passe dans le terminal).

Installer les packages

Installez d'abord le CLI : c'est le prérequis de sonenta login, de la création de projet/clé et de sonenta init.

npm install -g @sonenta/cli      # fournit la commande `sonenta`
# ponctuel, sans installation globale : npx -y @sonenta/cli <commande>

Pour afficher vos chaînes dans l'application, ajoutez le SDK runtime de votre framework (exemple React) :

npm install @sonenta/react-i18next

Intégration Astro : @sonenta/astro. Feedback en contexte : @sonenta/feedback.

Le serveur MCP (@sonenta/mcp) n'a pas d'installation manuelle : sonenta init le câble dans .mcp.json (exécuté via npx -y @sonenta/mcp).

Dans Claude Code, quittez votre session et démarrez-en une nouvelle après sonenta init. Claude Code lit .mcp.json au démarrage de la session : une session déjà ouverte continue donc sans les outils Sonenta.

Créer le projet et la clé

# 1. Connexion compte : ouvre le navigateur, vous approuvez la connexion
sonenta login

# 2. Créer le projet -> affiche son UUID
sonenta projects create "Mon site"

# 3. Créer une clé API (affichée une seule fois) + la stocker pour la CLI/MCP
sonenta api-keys create --name "agent-ia" --scopes "mcp:*" --save

# 4. Câbler le projet (MCP + config + bloc CLAUDE.md)
sonenta init --project <UUID_DU_PROJET>

• sonenta login ouvre verification_uri_complete dans le navigateur ; approuvez via votre session du tableau de bord (SSO / MFA pris en charge). La session est ensuite stockée et rafraîchie automatiquement.
• sonenta api-keys create affiche le token une seule fois (format snt_live_<préfixe>.<secret>) ; --save l'enregistre comme clé du host.
• Clés dev : ajoutez au moins --ip-allowlist ou --origin-allowlist. Plusieurs organisations ? --org <slug>.

Scopes de clé API

Scope	Pour quoi	Utilisé par
mcp:*	piloter le projet via les agents IA / le serveur MCP	@sonenta/mcp, sonenta agents
project:read · project:write	lire / gérer le contenu en ligne de commande	@sonenta/cli
project:settings:write	gérer la configuration du projet	@sonenta/cli (avancé)
missing:write	signaler les clés manquantes au runtime	SDK @sonenta/react-i18next
cdn:write · approvals:write	publier au CDN / gérer les approbations	flux avancés

Le préfixe canonique des tokens est snt_live_ ; les anciennes clés vrb_live_ restent valides.