저는 커리어의 상당 부분을 '컨텍스트 스위칭 비용 (context switching tax)'을 처리하며 보냈습니다. 여러분도 무슨 뜻인지 정확히 아실 겁니다. Cursor나 VS Code에서 복잡한 로직을 리팩터링하며 몰입 상태 (flow state)에 깊이 빠져 있는데, 현지화 (localized)가 필요한 새로운 UI 문자열을 추가했다는 사실을 깨닫는 순간 말이죠.

표준적인 절차는 어떠한가요? 에디터를 떠나 브라우저를 열고, Phrase (또는 Lokalise, 혹은 팀에서 사용하는 무엇이든)에 로그인한 뒤, 적절한 프로젝트를 찾아 로케일 (locale)로 이동하여 키 (key)를 생성하고 값을 붙여넣습니다. 그리고 지원 목록에 있는 모든 언어에 대해 이 과정을 반복합니다. 이는 영혼을 갉아먹는 작업입니다. 수동적이고, 오류가 발생하기 쉬우며, 무엇보다 집중력을 깨뜨립니다.

Model Context Protocol (MCP)를 통해 우리는 이러한 마찰을 실제로 해결하는 무언가를 목격하고 있습니다. 우리는 LLM이 '대화하는 챗봇'에서 '도구를 부여받는 에이전트 (agents)'로 이동하고 있습니다. 구체적으로, Phrase Software Localization API MCP를 사용하면, 여러분의 AI 에이전트가 에디터를 전혀 떠나지 않고도 i18n 관리라는 번거로운 일을 마침내 처리할 수 있습니다.

문제점: 로케일과 키가 코드와 분리되어 있음

전형적인 고성능 엔지니어링 워크플로우에서 코드의 진실의 원천 (source of truth)은 Git입니다. 하지만 현지화 (localization)에서 진실의 원천은 종종 Phrase와 같은 웹 UI에 갇혀 있습니다. 이는 드리프트 (drift) 현상을 만듭니다. 개발자가 JSON 파일에 auth.login.error_message를 추가했지만 번역 플랫폼을 업데이트하는 것을 잊어버립니다. 갑자기 프로덕션 앱에 사용자 친화적인 에러 메시지 대신 가공되지 않은 키 (raw key)가 표시됩니다.

Claude나 Cursor를 Phrase API에 직접 연결하는 MCP 서버를 사용하면 그 간극이 사라집니다. 여러분은 단순히 AI에게 '코드를 작성하라'고 요청하는 것이 아니라, '상태를 동기화 (sync state)'할 수 있는 능력을 부여하는 것입니다.

여러분은 에이전트에게 말 그대로 이렇게 말할 수 있습니다: "로그인 실패에 대한 새로운 에러 상태를 추가했습니다. 내 'Mobile App' 프로젝트에 auth.error.failed_attempt라는 새 키를 생성하고 영어, 독일어, 스페인어 로케일을 설정해 주세요."

에이전트는 단순히 추측만 하는 것이 아닙니다. create_key, create_project, create_locale과 같은 도구(tools)를 사용하여 API를 통해 해당 작업을 실행합니다. 이는 더 이상 수동적인 복사-붙여넣기 작업이 아닙니다. 이는 조율된 업데이트(orchestrated update)입니다.

'읽기 전용' 에이전트를 넘어서

대부분의 사람들은 AI 통합을 읽기 전용 스크래퍼(read-only scrapers)로 생각합니다. 그들은 AI가 '내 문서를 봐줬으면 좋겠다'라고 원합니다. 그것도 유용하지만, 개발자 생산성 문제를 해결하지는 못합니다. 진정한 힘은 쓰기 능력(write capabilities)에 있습니다.

Phrase MCP 서버는 양방향 동기화(bidirectional synchronization)를 가능하게 하는 전체 도구 세트를 제공합니다:

1. 탐색 (Discovery): list_projects 또는 get_project를 사용하여 브라우저 탭을 뒤질 필요 없이 현재 로컬라이제이션(localization) 현황을 파악합니다.
2. 감사 (Audit): list_keys를 사용하여 프로젝트에 대해 에이전트를 실행하고 코드베이스에 존재하는 키와 비교합니다. 만약 일치하지 않는다면, 버그를 찾아낸 것입니다.
3. 수정 (Modification): update_key, update_translation, 또는 create_translation을 할 수 있는 능력은 AI가 PR(Pull Request) 프로세스의 일부가 될 수 있음을 의미합니다. PR이 UI 문자열을 변경하면, 에이전트는 즉시 해당 변경 사항을 Phrase로 푸시할 수 있습니다.
4. 일괄 관리 (Bulk management): 새로운 언어를 온보딩할 때, 모든 키마다 메뉴를 클릭하며 들어갈 필요가 없습니다. 에이전트에게 이렇게 말하면 됩니다: "project proj_123의 모든 기존 키에 대해 프랑스어 로케일(French locale)을 생성해 줘."

엔지니어링의 현실: 보안 및 거버넌스

시니어 엔지니어들이 무엇을 생각하는지 알고 있습니다. "만약 내가 AI 에이전트에게 delete_project나 delete_key 권한을 준다면, 그것은 엄청난 보안 리스크가 아닌가요?"

회의적으로 생각하는 것이 당연합니다. LLM(대규모 언어 모델)에 운영 인프라에 대한 제한 없는 접근 권한을 주는 것은 재앙을 초래하는 지름길입니다. 이것이 바로 제가 격리된 실행 환경(isolated execution environments)에 초점을 맞추어 Vinkius를 구축한 정확한 이유입니다.

Vinkius를 통해 Phrase MCP를 사용할 때, 모든 실행은 샌드박스 처리된 V8 환경(sandboxed V8 environment) 내에서 이루어집니다. 우리는 SSRF(Server-Side Request Forgery) 방지 및 HMAC 감사 체인(HMAC audit chains)을 포함하여 8가지의 별도 거버넌스 정책(governance policies)을 구현했습니다. 사용자의 에이전트가 delete_key를 호출할 때, 이는 단순히 엔드포인트(endpoint)를 호출하는 것이 아닙니다. 이는 우리가 모니터링하고, 추적하며, 보안 경계(예: 권한이 없는 리소스에 접근을 시도하는 경우)를 위반할 경우 프로세스를 종료할 수도 있는 통제된 컨텍스트(controlled context) 내에서 발생합니다.

환각(hallucination)된 명령 때문에 AI가 실수로 'Web Dashboard' 프로젝트를 삭제해 버릴까 봐 걱정할 필요가 없어야 합니다. 인프라는 여러분이 작성하는 코드만큼이나 견고해야 합니다.

구현: 시작하기

이것을 설정하는 과정은 OAuth 콜백(callbacks)과 복잡한 리다이렉트(redirects)가 포함된 오후 내내 걸리는 설정 악몽이 아닙니다. 우리는 그런 것들을 모두 제거했습니다. Phrase 액세스 토큰(Access Token)이 있다면, 다음 세 단계로 실행할 수 있습니다:

2. 연결 토큰(connection token)을 가져옵니다.
3. 이를 Claude 또는 Cursor에 붙여넣습니다.

그게 전부입니다. 로컬 Node 프로세스를 관리할 필요도 없고, 의존성 지옥(dependency hell)을 걱정할 필요도 없으며, 기기를 옮길 때마다 깨지는 환경 변수(environment variables)를 설정할 필요도 없습니다.

마치며

'수동적인' 개발자의 시대는 끝나가고 있습니다. 우리는 의도(intent)를 정의함으로써 소프트웨어를 관리하고, 번역 키(translation keys) 업데이트나 로케일 리스트(locale lists) 관리와 같이 빈도가 높고 가치가 낮은 작업은 에이전트가 처리하도록 하는 세상으로 나아가고 있습니다.

수동적인 현지화(localization) 관리에 지쳤다면, 이것을 시도해 보세요. 이것은 단순히 편의성에 관한 것이 아니라, 여러분의 집중력을 되찾는 것에 관한 것입니다.

MCP는 AI 에이전트의 음악입니다. 우리는 카탈로그를 구축했습니다. Vinkius MCP Catalog를 확인해 보세요.