1. 装上 SDK
每个框架一个包。开发期间,调用了却没有翻译的 key 会出现在 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 运作方式
你的 key 住在 Sonenta 里。你的编码 agent 通过 MCP 读写它们。CDN 把它们送到你的应用。下面是四个步骤,附真实代码。
每个框架一个包。开发期间,调用了却没有翻译的 key 会出现在 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 sonenta init 写入项目配置,并在 CLAUDE.md 或 AGENTS.md 里加一段。然后在你的客户端里用五行 JSON 声明 MCP 服务器。同一段配置适用于 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→ 由你说明意图。agent 自行挑选工具,读 glossary 和 context,只处理未翻译的 key,然后给出建议。它在你的机器上运行:日常流程不消耗 credits。
工具调用记录,示例
list_untranslated_keys namespace=checkout language_code=es
glossary_list · project_context_get
propose_translations_bulk
publish_cdn 一次 release 按语言和 namespace 生成 JSON,由 CDN 提供。你的应用无需重新部署即可加载新的 bundle,移动端也不必绕道应用商店。
# depuis la CLI
sonenta releases
# ou depuis l'agent, via MCP
publish_cdn
CLI→ sonenta agents add 把专用 agent 装进你的代码仓库。每个都有自己的职责范围和文档页。