仕組み
プロンプトから release まで、エディタを離れずに。
キーは Sonenta にあります。コーディングエージェントが MCP 経由で読み書きします。CDN がそれをアプリに届けます。実際のコードとともに、4 つのステップを示します。
1. SDK を入れる
フレームワークごとに 1 パッケージ。翻訳なしで呼ばれたキーは開発中に dashboard に現れます。計測用のコードを書く必要はありません。
# 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. エージェントをつなぐ
sonenta init がプロジェクト設定と、CLAUDE.md または AGENTS.md へのブロックを書き込みます。続いて MCP サーバーをクライアントに JSON 5 行で宣言します。同じブロックが Claude Code、Cursor、Claude Desktop で使えます。
{
"mcpServers": {
"sonenta": {
"command": "npx",
"args": ["-y", "@sonenta/mcp"],
"env": {
"SONENTA_API_KEY": "snt_live_<prefix>.<secret>",
"SONENTA_PROJECTS": "<uuid1>,<uuid2>"
}
}
}
}
MCP→ 3. エージェントに翻訳させる
意図を伝えるのはあなたです。エージェントがツールを選び、glossary と context を読み、未翻訳のキーだけを扱い、提案します。あなたのマシンで動くので、日常の流れに credits はかかりません。
ツール呼び出しの記録、例
list_untranslated_keys namespace=checkout language_code=es
glossary_list · project_context_get
propose_translations_bulk
publish_cdn
4. 公開する
release が言語と namespace ごとに JSON を生成し、CDN が配信します。アプリは再デプロイなしで新しいバンドルを読み込みます。モバイルでもストアを経由しません。
# depuis la CLI
sonenta releases
# ou depuis l'agent, via MCP
publish_cdn
CLI→ 5 つの Claude Code エージェント
sonenta agents add が専門エージェントをリポジトリに入れます。それぞれに担当範囲とドキュメントページがあります。
-
sonenta-i18n:カバレッジを点検し、欠けているキーを作り、ローカルで翻訳して公開します。
doc → -
sonenta-knowledge:glossary とプロジェクト context を作り、保ちます。
doc → -
sonenta-a11y:アクセシビリティ surface を点検し、修正します。
doc → -
sonenta-surface:画面ごとの surface を点検し、設定します。
doc → -
sonenta-source-health:重複した原文をひとつの正規キーにまとめます。
doc →