Model Context Protocol

AI 네이티브 번역 워크플로

AI 코딩 에이전트(Cursor, Claude Desktop, Copilot 또는 Kiro)에게 편집기를 벗어나지 않고 번역을 동기화하고, 키를 검색하며, 현지화 워크플로를 관리할 수 있는 직접 액세스 권한을 부여하세요.

CursorClaude DesktopGitHub CopilotKiroClineWindsurf

MCP란 무엇인가요?

MCP(Model Context Protocol)는 AI 어시스턴트가 외부 도구 및 서비스와 상호작용할 수 있도록 하는 개방형 표준입니다. 명령어를 복사하여 붙여넣는 대신, AI 에이전트가 Localingos 도구를 직접 호출합니다: 대화 흐름 속에서 번역을 동기화하고, 키를 검색하며, 업데이트를 푸시합니다.

사용 가능한 도구

Core tools (local + remote)
Tool
Description
localingos_sync
소스 문자열을 푸시하고 번역을 가져옵니다. 변경된 콘텐츠만 전송됩니다 — 콘텐츠 해싱을 사용하여 변경되지 않은 항목을 건너뛰고 클라이언트에 필요한 번역만 반환합니다.
localingos_push
번역을 가져오지 않고 소스 문자열을 Localingos에 푸시합니다.
localingos_pull
최신 번역을 가져와 프로젝트에 로케일 파일을 작성합니다.
localingos_status
프로젝트 상태 표시: 프로젝트, 로케일, 소스 키 수, 번역 파일.
localingos_search
소스 문자열에서 번역 키 또는 텍스트를 검색합니다.
localingos_extract
.messages.ts 파일에서 JSON을 재구성하려면 i18n 추출 스크립트를 실행하세요.
Additional tools (remote + CLI mcp-serve)
Tool
Description
localingos_get_translatables
Get all source strings for a project.
localingos_get_translations
Get all translations for a project.
localingos_get_translation
Get translations for a specific key.
localingos_translation_jobs
List translation jobs for a project.
localingos_retry_job
Retry a single failed translation job.
localingos_retry_all_jobs
Retry all failed and blocked jobs.
localingos_project_members
List members of a project.
localingos_add_member
Add a member to a project.
localingos_remove_member
Remove a member from a project.
localingos_billing_status
Show billing status, plan, and usage.
localingos_attach_billing
Attach your billing account to a project.
localingos_detach_billing
Detach billing from a project.

로컬 설정 (stdio)

MCP 서버를 설치하고 AI 에이전트가 로컬에서 실행되도록 구성하세요. 프로젝트 구성을 읽습니다. 서버 비용이 없습니다.
MCP 서버 설치
npm install -g localingos
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
  "mcpServers": {
    "localingos": {
      "command": "localingos", "args": ["mcp-serve"],
      "cwd": "/path/to/your/project"
    }
  }
}
Add to .cursor/mcp.json in your project:
{
  "mcpServers": {
    "localingos": {
      "command": "localingos", "args": ["mcp-serve"]
    }
  }
}
Add to .kiro/settings/mcp.json:
{
  "mcpServers": {
    "localingos": {
      "command": "localingos", "args": ["mcp-serve"]
    }
  }
}
In VS Code, open Cline → MCP Servers → Add Local Server:
Command: localingos
Arguments: mcp-serve

원격 설정 (mcp.localingos.com)

설치가 필요 없습니다. 에이전트를 호스팅된 MCP 서버로 연결하세요. 각 도구 호출 시 API 키와 프로젝트 ID를 전달하세요.
{
  "mcpServers": {
    "localingos": {
      "type": "streamable-http",
      "url": "https://mcp.localingos.com"
    }
  }
}
{
  "mcpServers": {
    "localingos": {
      "type": "streamable-http",
      "url": "https://mcp.localingos.com"
    }
  }
}
Add to .kiro/settings/mcp.json:
{
  "mcpServers": {
    "localingos": {
      "type": "streamable-http",
      "url": "https://mcp.localingos.com"
    }
  }
}
In VS Code, open Cline → MCP Servers → Add Remote Server:
Server URL: https://mcp.localingos.com
Server Name: localingos
When using the remote server, your AI agent passes your API key and family ID with each tool call — no local config files needed.

대화 예시

"내 번역 동기화"
→ 에이전트가 localingos_sync를 호출 → 770개의 문자열을 푸시하고, 8개의 로케일을 가져오며, 파일을 작성합니다
"결제 페이지에 대한 번역이 있나요?"
→ 에이전트가 "billing"으로 localingos_search를 호출 → 일치하는 키와 텍스트를 반환
"i18n 추출을 실행하고 고아 항목을 확인하세요"
→ 에이전트가 check=true로 localingos_extract를 호출 → 키 개수 및 고아 메시지를 보고합니다