better-i18n 팀 협업: 실시간으로 함께 번역을 관리하세요
팀과 함께 번역을 검토하고, 의견을 남기며, 승인합니다. @mention 명령으로 자연어 방식의 상호작용이 가능합니다.
better-i18n의 팀 협업
현지화는 팀 전체의 노력이 필요합니다. 개발자는 문자열을 추가하고, 번역가는 언어 전문성을 제공하며, 제품 관리자는 출시 시점을 결정합니다. better-i18n은 역할 기반 접근 제어(RBAC), MCP를 통한 AI assistant 통합, 그리고 모든 구성원의 책임을 추적할 수 있는 완전한 감사 추적(audit trail)을 통해 이 워크플로우를 지원합니다.
역할 기반 접근 제어(RBAC)
better-i18n은 프로젝트 수준에서 RBAC를 제공합니다. 팀 구성원에게 다양한 역할을 부여하여 다음 작업에 대한 권한을 제어할 수 있습니다:
- 번역 조회
- 번역 키 편집 및 생성
- CDN에 번역 배포(publish)
- 프로젝트 설정 및 언어 관리
역할은 프로젝트별로 범위가 지정되므로, 팀 구성원은 조직 내 서로 다른 프로젝트에서 각기 다른 권한을 가질 수 있습니다.
인증은 GitHub OAuth를 통해 처리되므로, 이미 GitHub를 사용하는 엔지니어링 팀에게 매우 편리합니다.
MCP를 통한 AI Assistant
MCP 통합은 better-i18n의 협업 모델이 대시보드를 넘어 확장되는 지점입니다. 두 가지 MCP server를 사용할 수 있습니다:
@better-i18n/mcp -- 번역 관리를 위한 11가지 tool:
listProjects/getProject-- 프로젝트 상태 조회listKeys/createKeys/updateKeys/deleteKeys-- 번역 키 관리addLanguage-- 대상 언어 추가getSyncs/getSync-- sync 상태 확인getPendingChanges/publishTranslations-- 검토 및 배포
@better-i18n/mcp-content -- 콘텐츠 관리를 위한 17가지 tool (headless CMS 기능)
이 tool들은 Claude, Cursor, Windsurf, Zed와 함께 작동합니다. 팀 구성원은 코드 에디터 또는 AI assistant에서 직접 번역을 관리할 수 있습니다:
"Add the key onboarding.welcome with value 'Welcome to the app' in English"
"What keys are missing in the checkout namespace?"
"Publish all pending changes"
remote MCP URL은 https://mcp.better-i18n.com/mcp이며 — 로컬 server 설정이 필요하지 않습니다.
GitHub 통합
저장소가 연결되면, better-i18n은 번역을 배포(publish)할 때마다 번역된 JSON 파일이 포함된 pull request를 생성합니다. 이를 통해:
- 번역 변경 사항이 기존 코드 리뷰 프로세스를 거칩니다
- 개발자는 diff에서 정확히 무엇이 변경되었는지 확인할 수 있습니다
- PR을 merge하면 코드와 함께 번역이 배포됩니다
Webhook은 publish 이벤트 시 트리거되어 저장소를 자동으로 동기화합니다.
감사 추적(Audit Trail)
better-i18n의 모든 작업은 감사 추적에 기록됩니다:
- 키 생성, 업데이트 및 삭제
- 변경 전후 값을 포함한 번역 변경 사항
- Publish 이벤트
- 언어 추가
- 역할 및 권한 변경
이를 통해 팀은 완전한 추적 가능성을 확보할 수 있습니다. 번역이 예기치 않게 변경된 경우, 누가 언제 변경했는지 추적할 수 있습니다.
대시보드 워크플로우
대시보드는 번역 작업의 중앙 허브 역할을 합니다:
- 키 관리 -- namespace별로 정리된 번역 키 탐색, 검색 및 편집
- 언어 개요 -- 각 대상 언어의 커버리지 비율 확인
- AI 번역 -- glossary 적용과 함께 번역을 생성하고, 배포 전에 검토
- Publish -- 승인된 번역을 CDN에 배포하거나 GitHub PR을 트리거
적절한 역할을 가진 팀 구성원은 이러한 각 작업을 수행할 수 있으며, 다른 구성원은 상태 및 진행 상황을 조회할 수 있습니다.
CDN 배포(Publishing)
번역이 승인되면, 배포를 통해 better-i18n의 CDN(Cloudflare edge network 기반)으로 전송됩니다. 배포된 번역은 다음 위치에서 사용 가능합니다:
cdn.better-i18n.com/{org}/{project}/{locale}/{namespace}.json
이는 애플리케이션을 재배포하지 않고도 번역 업데이트를 반영할 수 있음을 의미합니다.
현재 제공하지 않는 기능
투명성을 위해, 현재 협업 기능에 포함되지 않는 사항을 안내합니다:
- 실시간 협업 미지원 -- live cursor, presence 표시기 또는 동시 편집 기능이 없습니다. 팀 구성원은 독립적으로 작업하며 변경 사항은 제출 시 저장됩니다.
- 댓글 스레드 미지원 -- 특정 번역 키에 댓글을 남기거나 대시보드 내에서 토론을 시작할 수 없습니다.
- @mention 시스템 미지원 -- UI 내에서 팀 구성원이나 AI assistant를 태그하는 방법이 없습니다.
- 설정 가능한 승인 워크플로우 미지원 -- RBAC 역할 외에, 다단계 승인 체인이나 서명 요구 사항이 없습니다.
- SSO/SAML 미지원 -- 인증은 GitHub OAuth만 지원합니다. 현재 Enterprise SSO는 제공되지 않습니다.
시작하기
- 계정 생성 후 조직을 설정합니다
- 팀 구성원을 초대하고 프로젝트별로 역할을 부여합니다
- PR 기반 워크플로우를 위해 GitHub 저장소를 연결합니다
- 팀의 AI assistant에서 에디터 기반 관리를 위한 MCP를 설정합니다
- 팀 전체에서 일관된 용어를 유지하기 위해 Glossary를 정의합니다
better-i18n은 기존 개발 워크플로우를 대체하지 않으면서도 팀이 번역 작업을 협력하여 진행할 수 있는 구조를 제공합니다.