better-i18n MCP 서버: AI IDE에서 번역을 관리합니다

MCP 서버: AI IDE에서 번역을 관리합니다

개발자는 작업 시간의 대부분을 코드 에디터에서 보냅니다. 로컬라이제이션이 별도의 웹 애플리케이션에서 관리될 때, 번역을 관리하기 위한 컨텍스트 전환은 시간을 낭비하고 작업 흐름을 방해합니다. 새로운 문자열이 이미 번역되었는지 확인하거나, 번역 파일에 키를 추가하거나, 독일어로 문자열이 어떻게 보이는지 확인하려는 개발자는 에디터를 떠나 로컬라이제이션 플랫폼에 로그인하고, 프로젝트를 찾고, 문자열을 찾은 다음 돌아와야 합니다.

이러한 마찰을 스프린트당 수백 개의 문자열, 팀의 모든 개발자에 걸쳐 곱하면 오버헤드는 상당합니다. 더 나쁜 것은, 이 마찰이 개발자들을 로컬라이제이션 작업을 미루도록 유도한다는 것입니다 — 「나중에 하기」로 표시하면서 출시 전에 위기가 될 만큼 쌓이는 백로그를 만듭니다.

better-i18n은 내장된 MCP(Model Context Protocol) 서버로 이 문제를 해결합니다. AI IDE — Claude, Cursor, Windsurf, 또는 Zed — 가 번역 워크스페이스에 직접 연결되어 자연어를 사용하여 읽고 쓸 수 있습니다. 번역 관리가 개발 워크플로의 일부가 되고, 별도의 컨텍스트 전환 작업이 아니게 됩니다.

작동 방식

Model Context Protocol이란?

Model Context Protocol(MCP)은 Anthropic이 개발한 오픈 스탠더드로, AI 어시스턴트가 외부 도구와 데이터 소스에 연결하는 방법을 정의합니다. 애플리케이션이 MCP 서버를 노출하면, AI IDE는 해당 기능을 발견하고 구조화된 도구 호출을 통해 상호작용할 수 있습니다.

better-i18n의 MCP 서버는 번역 워크스페이스를 MCP 호환 AI IDE가 호출할 수 있는 도구 세트로 노출합니다. AI는 번역 문자열을 읽고, 새 것을 푸시하고, 커버리지를 확인하고, QA 검사를 실행하고, 용어집 항목을 관리할 수 있습니다 — 모두 코드를 작성할 때 이미 사용하는 자연어 인터페이스를 통해 합니다.

이것은 플러그인이나 API와 본질적으로 다릅니다. API를 호출하는 코드를 작성할 필요가 없습니다. AI 어시스턴트와 이미 사용하는 동일한 대화 인터페이스에서 원하는 것을 설명하기만 하면, 어시스턴트가 백그라운드에서 도구 호출을 처리합니다.

IDE 연결

설정은 몇 분이면 됩니다. better-i18n MCP 서버 URL과 프로젝트 API 토큰을 IDE의 MCP 설정에 추가합니다. Cursor에서는 mcp.json 파일입니다. Claude Desktop에서는 MCP 설정 패널입니다. Windsurf와 Zed에서도 유사한 설정 파일이 적용됩니다.

연결되면, AI 어시스턴트는 번역 워크스페이스를 인식합니다. 프로젝트 구조, 소스 언어, 타겟 언어, 용어집, 기존 승인된 번역을 알게 됩니다. 이 컨텍스트는 추가 프롬프트 없이 사용 가능합니다 — AI가 MCP 연결에서 자동으로 읽습니다.

번역 상태 읽기

MCP 연결이 활성화된 상태에서 AI 어시스턴트에게 번역에 대해 직접 질문할 수 있습니다:

• "이 파일에서 아직 프랑스어로 번역되지 않은 문자열은 무엇입니까?"
• "키 auth.login.button.label에 대한 번역이 이미 존재합니까?"
• "일본어로 검토 대기 중인 모든 번역을 보여주세요."
• "47번 줄의 문자열의 독일어 번역은 무엇입니까?"

AI는 적절한 MCP 도구를 호출하고, better-i18n 워크스페이스에서 데이터를 검색하고, 대화에서 답변을 제시합니다. 탭 전환도 없고, 웹 인터페이스에서의 검색도 없습니다.

새 문자열 푸시

코드베이스에 새로운 사용자 대면 문자열을 추가할 때, 에디터를 떠나지 않고 better-i18n 워크스페이스에 푸시할 수 있습니다:

• "83번 줄의 문자열을 값 '주문 합계'로 checkout.summary.total.label로 better-i18n에 추가해주세요."
• "이 컴포넌트에서 하드코딩된 모든 문자열을 추출하여 better-i18n에 푸시해주세요."
• "기존 명명 규칙에 따라 이 새 기능의 모든 문자열에 대한 번역 키를 생성해주세요."

AI는 코드를 읽고, 문자열을 식별하고, 기존 규칙에 기반하여 적절한 키 이름을 추론하고, 하나의 작업으로 better-i18n 워크스페이스에 항목을 생성합니다. 이것은 개발자들이 현재 수동으로 하거나 무기한 미루는 종류의 지루한 작업입니다.

대규모 추출의 경우 CLI 도구가 더 적합합니다 — 코드베이스 전체를 한 번에 스캔할 수 있습니다. MCP 통합은 코드를 작성하면서 개별 문자열을 추가하는 지속적인 워크플로에 가장 적합합니다.

AI 지원 번역

번역 워크스페이스, 용어집, 번역 메모리에 대한 액세스로 AI 어시스턴트는 고품질 번역을 제안할 수 있습니다:

• "브랜드 용어에는 용어집을 사용하여 이 새 문자열을 모든 타겟 언어로 번역해주세요."
• "기존 승인된 문자열의 톤에 맞는 독일어 번역을 제안해주세요."
• "이 문자열의 프랑스어 번역이 유사한 문자열을 번역한 방식과 일관성이 있는지 확인해주세요."

AI는 완전한 번역 메모리에 액세스할 수 있으므로, 제안이 일반적이지 않습니다 — 제품의 특정 어휘, 톤, 관습을 반영합니다. 제안된 번역은 better-i18n에서 초안으로 생성되며, 협업 워크플로에서 사람 검토자에게 즉시 표시됩니다.

QA 검사 실행

IDE에서 품질 보증 작업을 트리거할 수도 있습니다:

• "오늘 추가한 모든 문자열에 대해 QA 검사를 실행해주세요."
• "새 문자열 중 플레이스홀더 형식 문제가 있는 것이 있는지 확인해주세요."
• "소스 문자열보다 40자 이상 긴 모든 프랑스어 번역을 찾아주세요."

이러한 작업은 웹 에디터에서 자동으로 실행되는 동일한 QA 엔진을 사용합니다. 차이점은 일반적인 코드 리뷰 워크플로의 일부로 개발 환경에서 프로그래밍 방식으로 트리거한다는 점입니다.

협업 스레드에서의 @멘션

MCP 통합은 better-i18n의 협업 인터페이스에서 @멘션 시스템도 강화합니다. 검토자가 번역에 댓글을 남기고 @claude 스타일 가이드에 대해 이 문자열의 톤을 확인해를 입력하면, AI는 MCP 연결을 통해 문자열, 스타일 가이드, 기존 승인된 번역을 읽고 스레드에서 직접 응답합니다.

이것은 협업 기능 페이지에서 더 자세히 설명합니다.

주요 이점

컨텍스트 전환 없음

가장 큰 실질적인 이점은 개발자가 번역 관련 작업을 관리하기 위해 에디터를 떠날 필요가 없다는 것입니다. 커버리지 확인, 키 추가, 문자열 푸시, QA 결과 가져오기 — 이 모든 것이 AI IDE의 대화 인터페이스에서 이루어집니다. 번역 관리의 정신적 부담이 거의 제로로 떨어집니다.

로컬라이제이션 채택 가속화

로컬라이제이션이 원활하면, 개발자들이 실제로 미루지 않고 실시간으로 합니다. MCP 통합을 사용하는 팀은 사용 첫 스프린트 내에 「프로덕션의 미번역 문자열」 수가 크게 감소한다고 일관되게 보고합니다.

실제 컨텍스트를 가진 AI

일반적인 AI 번역 도구는 제품의 특정 어휘, 톤 가이드라인 또는 기존 번역에 대한 지식이 없습니다. better-i18n의 MCP 통합은 제안을 생성하기 전에 AI에게 번역 메모리와 용어집에 대한 완전한 액세스를 제공합니다. 컨텍스트가 있는 AI 제안과 없는 제안의 품질 차이는 상당합니다.

일관된 명명 규칙

AI가 새 번역 키를 생성할 때, 기존 키 구조를 읽고 자동으로 동일한 규칙을 따릅니다. auth.login.button.label과 checkout.summary.total.label 같은 키는 예측 가능한 패턴을 따릅니다. 자동화 없이는 개발자들이 특히 마감 압박 하에 규칙을 일관성 없이 적용합니다.

전체 기능 세트와의 통합

MCP 통합은 better-i18n 기능의 제한된 하위 집합이 아닙니다. 웹 인터페이스를 통해 액세스할 수 있는 모든 것은 MCP 도구를 통해서도 액세스할 수 있습니다. 버전 히스토리, 분석 데이터, QA 결과, 용어집 관리 — 모두 IDE에서 이용 가능합니다.

활용 사례

활발한 개발: 개발자가 새 컴포넌트를 작성하면서 AI를 사용하여 하드코딩된 문자열을 추출하고, 적절한 키 이름을 생성하고, better-i18n에 키를 푸시하고, 초기 AI 번역을 요청합니다 — 모두 에디터를 떠나지 않고 하나의 대화 세션에서 합니다.

코드 리뷰: 검토자가 새로운 사용자 대면 문자열을 추가하는 PR을 봅니다. AI에게 문자열이 better-i18n에 푸시되었는지, 모든 타겟 언어에 대한 번역이 존재하는지 확인하도록 요청합니다. AI는 1초 이내에 확인하고 보고합니다.

리팩토링: 개발자가 컴포넌트 이름을 변경하고 일치하도록 번역 키를 업데이트해야 합니다. AI에게 이전 접두사가 있는 모든 키를 찾고, better-i18n에서 이름을 바꾸고, 코드베이스의 참조를 업데이트하도록 요청합니다.

출시 전 QA: 출시 전날, 개발자가 AI에게 모든 언어에 대한 완전한 커버리지 리포트를 생성하고 승인된 번역이 없는 지난 주에 추가된 문자열에 플래그를 달도록 요청합니다. AI는 우선순위가 지정된 목록을 반환합니다.

용어집 관리: 프로덕트 매니저가 브랜드 용어를 업데이트하고 AI에게 better-i18n 용어집을 업데이트하고 모든 언어에서 이전 용어를 사용하는 모든 번역에 플래그를 달도록 요청합니다.

better-i18n의 MCP 구현

better-i18n의 MCP 서버는 완전한 MCP 사양에 대해 구현됩니다. get_string, create_string, update_string, search_strings, get_coverage, run_qa, get_glossary_entries, create_glossary_entry 등 이름이 지정된 도구 세트를 노출하며, 각각 파라미터와 반환 타입을 설명하는 JSON 스키마가 있습니다.

MCP 호환 AI가 이러한 도구 중 하나를 호출하면, 서버는 프로젝트 API 토큰을 사용하여 요청을 인증하고, 웹 인터페이스에 적용되는 동일한 역할 기반 액세스 제어를 시행하고, AI가 응답을 구성하는 데 사용할 수 있는 구조화된 데이터를 반환합니다.

서버는 상태 비저장(stateless)이며 수평 확장 가능합니다. 각 도구 호출은 독립적인 API 요청입니다. 관리할 세션 상태가 없으며, 컨텍스트를 잃지 않고 연결을 중단하고 재개할 수 있습니다.

인증은 프로젝트 범위의 API 토큰을 사용합니다. 하나의 프로젝트에 발급된 토큰은 두 프로젝트가 동일한 조직에 속하더라도 다른 프로젝트에 액세스하는 데 사용할 수 없습니다.

대안과의 비교

Lokalise와 Phrase 플러그인: 두 플랫폼 모두 일부 IDE용 에디터 플러그인을 제공하지만, 이들은 기존 UI 플러그인입니다 — 에디터 내부에서 웹 인터페이스를 복제하는 사이드바 또는 패널. 자연어 상호작용이나 AI 지원 작업은 지원하지 않습니다.

커스텀 API 스크립트: 팀들이 때때로 문자열을 푸시하거나 가져오기 위해 로컬라이제이션 플랫폼의 API를 호출하는 커스텀 스크립트를 작성합니다. 이것은 지속적인 유지 보수가 필요하고, 자연어 쿼리를 지원하지 않으며, 비기술적인 팀원들은 사용할 수 없습니다.

컨텍스트 없는 AI 번역: 번역 메모리, 용어집 또는 기존 승인된 번역에 대한 액세스 없이 범용 AI를 사용하여 문자열을 번역하면 일관성 없는 결과가 나옵니다. MCP 통합은 AI에게 필요한 모든 컨텍스트를 제공함으로써 이것을 해결합니다.

직접 파일 편집: 코드베이스에서 JSON 또는 YAML 번역 파일을 직접 편집하는 것이 가장 단순한 접근법이지만 동기화 문제를 생성하고, 협업을 어렵게 하고, QA를 제공하지 않습니다. CLI 도구는 파일 기반 워크플로를 위한 더 구조화된 대안이며, MCP 통합은 그 위에 구축됩니다.

자주 묻는 질문

어떤 AI IDE가 MCP를 지원합니까? 2026년 초 현재 MCP는 Claude Desktop, Cursor, Windsurf, Zed 및 늘어나는 다른 AI 기반 개발 환경에서 지원됩니다. 프로토콜은 오픈 소스이며 업계 전반에서 활발히 채택되고 있습니다.

팀의 각 개발자에 대해 별도의 API 키가 필요합니까? 아니요. API 토큰은 프로젝트에 범위를 지정하고 공유하거나, 감사 추적 목적으로 개발자별로 개별 토큰을 발급할 수 있습니다. 토큰 관리는 프로젝트 설정 패널에서 이용 가능합니다.

AI가 프로덕션 번역을 직접 수정할 수 있습니까? MCP 서버는 워크플로 설정을 존중합니다. 프로젝트에서 게시 전 검토 단계를 요구하는 경우, AI가 생성하거나 편집한 번역은 직접 게시되지 않고 「검토 대기 중」 상태에 놓입니다. AI는 다른 기여자와 동일한 액세스 제어 내에서 작동합니다.

MCP 연결은 안전합니까? 예. IDE와 better-i18n MCP 서버 간의 모든 통신은 HTTPS를 사용합니다. API 토큰은 특정 프로젝트에 범위가 지정되며 프로젝트 설정에서 언제든지 취소할 수 있습니다. 서버는 모든 도구 호출에서 역할 기반 액세스를 시행합니다.

수천 개의 문자열이 있으면 AI가 압도됩니까? MCP 도구는 전체 데이터셋 검색이 아닌 효율적이고 타겟화된 액세스를 위해 설계되었습니다. AI가 관련 문자열을 찾아야 할 때, 모든 것을 로드하는 대신 검색 및 필터 도구를 사용합니다. 대량 작업의 경우 CLI 도구가 더 적합합니다.

번역을 개발 워크플로에 통합합니다

번역 관리는 별도의 애플리케이션이 되어서는 안 됩니다. 제품을 구축하는 데 이미 사용하는 도구의 일부가 되어야 합니다. better-i18n의 MCP 통합은 MCP 호환 AI IDE로 오늘날 그것을 가능하게 합니다.

무료 체험 시작 후 몇 분 안에 IDE를 연결하세요.