Translatize integration API를 통해 AI agent가 번역 레이블을 읽고, 편집하고, 브랜치하고, 번역하며, QA를 수행할 수 있도록 지원합니다.
다른 이름 Translatize/integrations, integrations, @translatize/mcp
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.2.0
- 마지막 커밋
- 2026년 11월 3일
- 라이선스
- —
Translatize MCP란?
Translatize은(는) MCP server입니다. Translatize integration API를 통해 AI agent가 번역 레이블을 읽고, 편집하고, 브랜치하고, 번역하며, QA를 수행할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
Translatize MCP server 정보
이 MCP server를 사용하면 AI agent를 통해 로컬라이제이션 워크플로우를 관리할 수 있습니다. Claude Code 및 Cursor와 같은 도구를 stdio를 통해 Translatize integration API에 연결하여 모델이 번역 데이터와 직접 상호작용할 수 있도록 합니다. 개발자는 코딩 환경을 벗어나지 않고도 번역 레이블의 읽기, 편집 및 브랜치 작업을 자동화할 수 있습니다.
server를 사용하려면 Authorization: Bearer mcni_ 형식의 machine token을 인증용으로 제공해야 합니다. 이 server는 국제화 작업을 지원하기 위해 28개의 개별 도구와 2개의 워크플로우 프롬프트를 제공합니다. @translatize/core SDK를 기반으로 구축되었으며 npm workspace 환경에서 작동하도록 설계되었습니다. 이 설정을 통해 agent는 표준화된 프로토콜을 통해 복잡한 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
이 MCP server로 AI agent가 무엇을 할 수 있나요?
AI agent는 제공되는 28개의 도구와 2개의 워크플로우 프롬프트를 사용하여 번역 레이블을 읽고, 편집하고, 브랜치하고, 번역하며, QA를 수행할 수 있습니다.
어떤 AI 클라이언트가 이 MCP server와 호환되나요?
이 server는 Claude Code 및 Cursor와 같은 AI agent에서 작동하도록 설계되었습니다.
Translatize integration API 인증은 어떻게 이루어지나요?
API는 Bearer token을 통한 machine-token 인증을 사용합니다.