Translatize integration APIを介して、AIエージェントによる翻訳ラベルの読み取り、編集、ブランチ作成、翻訳、およびQAチェックを可能にします。
別名 Translatize/integrations, integrations, @translatize/mcp
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.2.0
- 最終コミット
- 2026年11月3日
- ライセンス
- —
Translatize MCPとは
TranslatizeはMCPサーバーです。 Translatize integration APIを介して、AIエージェントによる翻訳ラベルの読み取り、編集、ブランチ作成、翻訳、およびQAチェックを可能にします。.
プロジェクトのREADMEから生成された概要
Translatize MCP server について
このMCP serverを使用すると、AIエージェントを通じてローカライゼーションのワークフローを管理できます。Claude CodeやCursorなどのツールをstdio経由でTranslatize integration APIに接続し、モデルが翻訳データと直接やり取りできるようにします。開発者は、コーディング環境を離れることなく、翻訳ラベルの読み取り、編集、ブランチ作成を自動化できます。
サーバーを使用するには、Authorization: Bearer mcni_形式のマシン・トークンによる認証が必要です。このサーバーは、国際化タスクを支援するために28個のツールと2つのワークフロープロンプトを提供します。@translatize/core SDKに基づいて構築されており、npmワークスペース環境内で動作するように設計されています。このセットアップにより、エージェントは標準化されたプロトコルを通じて、複雑なQAチェックの実行や翻訳文字列の管理が可能になります。
できること
- 1AI搭載IDEとの統合翻訳APIをCursorやClaude Codeに接続し、自然言語で文字列を管理します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Translatize MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにTranslatize MCPをインストール
$ claude mcp add --env 'TRANSLATIZE_API_TOKEN=<YOUR_TRANSLATIZE_API_TOKEN>' integrations -- npx -y @translatize/mcpCursorにTranslatize MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"integrations": {
"command": "npx",
"args": [
"-y",
"@translatize/mcp"
],
"env": {
"TRANSLATIZE_API_TOKEN": "<YOUR_TRANSLATIZE_API_TOKEN>"
}
}
}
}VS CodeにTranslatize MCPをインストール
.vscode/mcp.json
{
"servers": {
"integrations": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@translatize/mcp"
],
"env": {
"TRANSLATIZE_API_TOKEN": "<YOUR_TRANSLATIZE_API_TOKEN>"
}
}
}
}VS Code CLIにTranslatize MCPをインストール
$ code --add-mcp '{"name":"integrations","type":"stdio","command":"npx","args":["-y","@translatize/mcp"],"env":{"TRANSLATIZE_API_TOKEN":"<YOUR_TRANSLATIZE_API_TOKEN>"}}'Claude DesktopにTranslatize MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"integrations": {
"command": "npx",
"args": [
"-y",
"@translatize/mcp"
],
"env": {
"TRANSLATIZE_API_TOKEN": "<YOUR_TRANSLATIZE_API_TOKEN>"
}
}
}
}CodexにTranslatize MCPをインストール
$ codex mcp add integrations --env 'TRANSLATIZE_API_TOKEN=<YOUR_TRANSLATIZE_API_TOKEN>' -- npx -y @translatize/mcpCodex config.tomlにTranslatize MCPをインストール
~/.codex/config.toml
[mcp_servers.integrations] command = "npx" args = ["-y", "@translatize/mcp"] [mcp_servers.integrations.env] TRANSLATIZE_API_TOKEN = "<YOUR_TRANSLATIZE_API_TOKEN>"
Gemini CLIにTranslatize MCPをインストール
$ gemini mcp add -s user -e 'TRANSLATIZE_API_TOKEN=<YOUR_TRANSLATIZE_API_TOKEN>' integrations npx -- -y @translatize/mcpGemini settings.jsonにTranslatize MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"integrations": {
"command": "npx",
"args": [
"-y",
"@translatize/mcp"
],
"env": {
"TRANSLATIZE_API_TOKEN": "<YOUR_TRANSLATIZE_API_TOKEN>"
}
}
}
}設定
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.
| 名前 | 説明 | 種類 |
|---|---|---|
| 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_URL | API base URL including the /v1 segment. Defaults to https://api.translatize.com/v1. | |
| TRANSLATIZE_APP_URL | Web-app base URL used to build review links. Defaults to https://app.translatize.com. |
自動チェック
実行日 2026年11月14日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能translatize/integrations is public and reachablegithub.com/translatize/integrations ↗合格
- パッケージがこのリポジトリをソースとして指定@translatize/mcp names translatize/integrations as sourcenpmjs.com/package/@translatize/mcp ↗合格
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)No license検出事項
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-03github.com/translatize/integrations ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from @translatize/mcp合格
- パッケージおよびその依存関係に重大な勧告なし100 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
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/qa/screenshots upload/release) built on @translatize/core. Syncs translations from CI with git-like branching, gates on QA, uploads screenshot captures and publishes OTA releases. |
@translatize/mcp |
mcp/ |
available | Model Context Protocol server exposing the API to AI agents (Claude Code, Cursor, ...) over stdio, built on @translatize/core: 28 tools and 2 workflow prompts. |
@translatize/playwright |
playwright/ |
new in 0.2.0 | Captures screenshots with text positions from Playwright tests, for translatize screenshots upload. |
@translatize/ota |
ota/ |
new in 0.2.0 | Zero-dependency over-the-air client (browser, React Native, Node) with an i18next backend. |
@translatize/ota-worker |
ota-worker/ |
private | The Cloudflare Worker that serves OTA releases. Deployed with wrangler, not published. |
@translatize/github-app |
github-app/ |
private | The GitHub App service (container). Not published. |
The Claude Code plugin in claude-plugin/ bundles the MCP
server plus two skills (localize-repo, translatize-strings).
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/qa 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, @translatize/mcp,
@translatize/ota and @translatize/playwright packages are published to npm
under the @translatize scope, in lockstep versions. Publishing is manual –
nothing here publishes automatically. Follow PUBLISHING.md:
build first, then npm publish --access public per package, core first. Don't use
npm publish --workspaces – it would also try the private packages.
Translatize MCPのよくある質問
Translatize MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'TRANSLATIZE_API_TOKEN=<YOUR_TRANSLATIZE_API_TOKEN>' integrations -- npx -y @translatize/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Translatize MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
このMCP serverでAIエージェントは何ができますか?
AIエージェントは、提供される28個のツールと2つのワークフロープロンプトを使用して、翻訳ラベルの読み取り、編集、ブランチ作成、翻訳、およびQAチェックを実行できます。
どのAIクライアントがこのMCP serverに対応していますか?
このサーバーは、Claude CodeやCursorなどのAIエージェントで動作するように設計されています。
Translatize integration APIの認証方法を教えてください。
APIは、Bearerトークンによるマシン・トークン認証を使用します。