com.translatize/mcp
Read, search, edit and branch Translatize translation labels and fill missing translations.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
@translatize/mcpclaude mcp add com-translatize-mcp -e 'TRANSLATIZE_API_TOKEN=<your translatize_api_token>' -e 'TRANSLATIZE_API_URL=https://api.translatize.com/v1' -e 'TRANSLATIZE_APP_URL=https://app.translatize.com' -- npx -y @translatize/mcp@0.1.3
{
"mcpServers": {
"com-translatize-mcp": {
"command": "npx",
"args": [
"-y",
"@translatize/mcp@0.1.3"
],
"env": {
"TRANSLATIZE_API_TOKEN": "<your translatize_api_token>",
"TRANSLATIZE_API_URL": "https://api.translatize.com/v1",
"TRANSLATIZE_APP_URL": "https://app.translatize.com"
}
}
}
}
متغيرات البيئة
TRANSLATIZE_API_TOKENإلزامي سري Translatize integration API token (an "mcni_..." string), bound to one project and branch. Create it under Project Settings -> Integrations at https://app.translatize.com.TRANSLATIZE_API_URLAPI base URL including the /v1 segment. Defaults to https://api.translatize.com/v1.TRANSLATIZE_APP_URLWeb-app base URL used to build review links. Defaults to https://app.translatize.com.
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
Translatize integrations
Client-side tooling for the Translatize integration API (the machine-token API
authenticated with Authorization: Bearer mcni_...). This is an npm workspace root
that is intentionally separate from the apps in the repo – it has the only
package.json with workspaces, and the repo root stays package.json-free.
Packages
| Package | Directory | Status | What it is |
|---|---|---|---|
@translatize/core | core/ | available | Zero-dependency TypeScript SDK for the integration API (client + flatten/unflatten helpers). The shared foundation everything else builds on. |
@translatize/cli | cli/ | available | Command-line tool (translatize init/pull/push/status) built on @translatize/core. Syncs translations from CI with git-like branching. |
@translatize/mcp | mcp/ | available | Model Context Protocol server exposing the API to AI agents (Claude Code, Cursor, ...) over stdio, built on @translatize/core. |
CI templates
Two ready-to-use CI integrations complement the packages. They shell out to the
@translatize/cli (npx @translatize/cli ...) rather than being npm packages,
so you consume them as workflow/pipeline config, not via npm install:
| Template | Home | What it is |
|---|---|---|
| GitHub Action | github.com/Translatize/sync-action | Composite action (translatize/sync-action) wrapping the CLI's pull/push/status for GitHub workflows. |
| GitLab CI | gitlab.com/translatize/gitlab | CI/CD Catalog component (templates/translatize.yml) plus copy-paste .gitlab-ci.yml jobs. |
Development
cd integrations
npm install # installs every workspace and hoists dev deps
npm run build # builds each workspace that defines a build script
npm test # runs each workspace's test suite
Requires Node.js >= 18.17 (native fetch, node:test).
Publishing
The @translatize/core, @translatize/cli, and @translatize/mcp packages are
published to npm under the @translatize scope. Publishing is manual –
nothing here publishes automatically. To cut a release, build first, then
npm publish --access public from the individual package directory (or
npm publish --workspaces).
الأسئلة الشائعة
ما هو com.translatize/mcp؟
Read, search, edit and branch Translatize translation labels and fill missing translations.
كيف أثبّت com.translatize/mcp؟
يعمل على جهازك. في Claude Code: claude mcp add com-translatize-mcp -e 'TRANSLATIZE_API_TOKEN=<your translatize_api_token>' -e 'TRANSLATIZE_API_URL=https://api.translatize.com/v1' -e 'TRANSLATIZE_APP_URL=https://app.translatize.com' -- npx -y @translatize/mcp@0.1.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج com.translatize/mcp إلى مفتاح API؟
نعم. يتطلب TRANSLATIZE_API_TOKEN، وتضبطها في إعداداته.
هل com.translatize/mcp مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون com.translatize/mcp؟
ينشره Translatize. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.