문서화

MCP 서버

Magic Translate 에는 MCP 서버가 있어서 클로드 코드, 코덱스, 커서 같은 AI 코딩 에이전트가 프로젝트에 Magic Translate 설정하고 번역을 관리할 수 있어.

https://mcp.magictranslate.io/mcp

원격 서버를 지원하는 모든 MCP 클라이언트에서 작동해.처음 연결하면 클라이언트가 브라우저에서 magictranslate.io를 열어.로그인하거나 무료 계정을 만들고 클라이언트가 네 계정을 사용하도록 허용해.

네 에이전트가 할 수 있는 일

  • 프로젝트에 Magic Translate 추가해.프레임워크의 설정 지침을 읽고, API 키로 클라이언트를 설치하고, 번역을 위해 텍스트를 래핑해.많은 고객들이 이걸 add-to-project 프롬프트로 제공해.
  • 네 계정을 확인해.너의 API 키, 플랜, 이번 달 사용량.
  • 텍스트를 번역해, 예를 들면 미리보기나 해.이는 사이트 번역과 같은 월별 글자 수에 반영돼.
  • 번역을 검토하고 고쳐 줘.번역을 나열하고, 잘못된 용어나 일관되지 않은 형식을 찾아내고, 더 나은 번역으로 덮어줄 수 있어.대부분의 고객이 번역을 변경하기 전에 너한테 물어봐.

클라이언트 연결해

클로드 코드

claude mcp add --transport http magic-translate https://mcp.magictranslate.io/mcp

그럼 클로드 코드에서 /mcp 실행해서 로그인해.

코덱스

codex mcp add magic-translate --url https://mcp.magictranslate.io/mcp

코덱스가 브라우저를 열어 로그인해.나중에 다시 로그인하려면 codex mcp login magic-translate 실행해.

커서

프로젝트의 ~/.cursor/mcp.json 또는 .cursor/mcp.json 에 서버를 추가해.

{
"mcpServers": {
"magic-translate": {
"url": "https://mcp.magictranslate.io/mcp"
}
}
}

VS 코드

프로젝트의 .vscode/mcp.json 에 서버를 추가해.

{
"servers": {
"magic-translate": {
"type": "http",
"url": "https://mcp.magictranslate.io/mcp"
}
}
}

클로드 앤 클로드 데스크톱

설정 → 커넥터를 열고 사용자 지정 커넥터 추가를 클릭하고 https://mcp.magictranslate.io/mcp 입력해.

다른 클라이언트들

대부분의 클라이언트는 URL을 원격, 즉 HTTP 서버로 사용해.로컬 서버만 실행하는 클라이언트는 mcp-remote를 통해 접속할 수 있어.

{
"mcpServers": {
"magic-translate": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.magictranslate.io/mcp"]
}
}
}

로그인하지 않고

브라우저 (예: CI) 에서 로그인할 수 없는 클라이언트는 대신 비밀 키를 보낼 수 있어.

Authorization: Bearer p-...

프로젝트에 Magic Translate 만 추가하려면 계정이 전혀 필요 없어. https://mcp.magictranslate.io/mcp/public 로그인 없이 설정 지침을 알려줘.그러면 에이전트가 API 키의 플레이스홀더를 사용하는데, 계정 페이지에서 플레이스홀더로 바꾸어.