MCP · Model Context Protocol
AI 문서 번역 MCP 서버
번역은 AI가 하게 하세요.
이미 쓰고 있는 MCP 클라이언트—Claude, Cursor, MCP를 지원하는 무엇이든—에 Belin Doc의 PDF·문서 번역을 붙입니다. 말 한마디로 작업을 제출하고 진행을 확인하고 결과를 받아옵니다. 차감되는 건 웹과 같은 계정의 같은 사용량입니다.
user이 PDF를 일본어로 번역해 줘.
↳translate_document · contract.pdf → ja
↳get_document_translation_status · 12페이지
ai끝났습니다. 레이아웃 그대로, 번역본 여기 있어요.
- 접속 주소
- https://mcp.belindoc.com/api/mcp
- 전송 방식
- Streamable HTTP · 원격
- 계정당 키 개수
- 5
- 최종 업데이트
- 2026-09-24
무엇을 해주나
MCP로 PDF 번역하기 전에 알아둘 네 가지
한마디로 끝까지
“이 PDF를 일본어로”라고만 하세요. 모델 선택도 제출도 결과 수령도 그 한 줄 뒤에서 일어납니다.
레이아웃 그대로
번역본이 원문의 조판·표·도판·수식 위치를 그대로 유지합니다. 텍스트 추출이 아닙니다.
모델은 직접 선택
Gemini 3, GPT-5.x 등 제공 중인 모델을 건별로 바꿔 쓸 수 있습니다.
계정도 사용량도 하나
호출은 웹에서 쓰던 사용량과 주문을 그대로 차감합니다. API용으로 따로 충전할 필요가 없습니다.
연결 방법
Streamable HTTP · 원격
세 단계로 MCP 서버 연결
키 하나와 JSON 한 덩이. 그 뒤로는 전부 자연어로 처리됩니다.
- 01
API 키 만들기
로그인 후 오른쪽 위 프로필 메뉴에서 개발자 센터를 열어 키를 만듭니다. 전체 값은 생성 직후 한 번만 보이니 그 자리에서 저장하세요.
- 02
설정 붙여넣기
이 설정을 클라이언트의 MCP 설정 파일에 추가하고 Authorization 헤더의 Bearer 뒤에 키를 넣으세요.
- 03
그냥 말하기
무엇을 번역할지 말하면 됩니다. 도구 선택은 클라이언트가, 처리는 Belin Doc이 합니다.
{
"mcpServers": {
"belindoc-mcp": {
"type": "http",
"url": "https://mcp.belindoc.com/api/mcp",
"headers": {
"Authorization": "Bearer <당신의 API 키>"
}
}
}
}type 값은 클라이언트마다 다르며 Claude Code에서는 http입니다. 위 사양의 Streamable HTTP는 프로토콜 이름이지 설정에 넣는 값이 아닙니다.
로컬 연결
내 컴퓨터에서 돌리고 싶다면
위 엔드포인트는 여럿이 함께 쓰는 원격 방식입니다. 서버를 내 컴퓨터에서 직접 실행하고 싶거나, 클라이언트에서 원격 주소와 요청 헤더를 설정하기 번거롭다면 로컬 stdio 방식을 쓰세요. 도구도 계정도 잔여량도 똑같습니다.
uvx가 처음 실행할 때 자동으로 받아오므로 미리 설치할 것은 없습니다. 여기서는 키를 헤더가 아닌 env에 넣습니다.
PyPI · belindoc-mcp이 클라이언트에는 CLI 설치 도구가 없습니다. 아래 설정을 다음 파일에 추가하세요: ~/Library/Application Support/Claude/claude_desktop_config.json · %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"belindoc-mcp": {
"type": "stdio",
"command": "uvx",
"args": ["belindoc-mcp"],
"env": {
"BELINDOC_API_KEY": "<당신의 API 키>"
}
}
}
}컴퓨터에 uv가 설치돼 있어야 합니다(uvx는 uv에 포함). uv 설치 후에는 클라이언트를 켜기 전에 터미널을 새로 여세요. PATH가 갱신되지 않으면 클라이언트가 uvx를 찾을 수 없다고 표시합니다.
클라이언트의 경로와 최상위 키는 변경될 수 있으니 설정 전에 사용 중인 클라이언트의 최신 문서를 확인하세요. Belin Doc 쪽 세 줄(command, args, env)은 모든 클라이언트에서 동일합니다.
실제 사용
연결하지 말고 말하세요
연결한 뒤에는 이렇게 부탁하면 됩니다. 각 문장은 클라이언트가 호출할 도구에 대응합니다.
- 번역
“이 PDF를 일본어로 번역해 줘.”
↳ translate_document
- 모델 지정
“이 계약서는 Gemini 3으로 번역해 줘.”
↳ translate_document
- 영상
“이 영상을 영어로, 이중 자막까지 넣어 줘.”
↳ translate_video
- 진행 상황
“방금 넣은 거 다 됐어?”
↳ get_document_translation_status
- 결과
“번역본을 로컬에 내려받아 줘.”
↳ get_document_translation_result
- 사용량
“이번 달 몇 페이지 남았어?”
↳ get_account_status
자주 묻는 질문
MCP 서버에 연결하기 전에
- 과금은 어떻게 되나요? 웹과 같은 사용량인가요?
- 같습니다. MCP는 입구가 하나 늘어난 것일 뿐 별개 상품이 아닙니다. 같은 페이지·영상 사용량을 같은 모델 계수로 차감하며 MCP 전용 요금은 없습니다.
- 계정당 키는 몇 개까지 만들 수 있나요?
- 기본 5개입니다. 개발자 센터에서 만들고 이름을 바꾸고 만료일과 IP 허용 목록을 설정할 수 있으며, 언제든 비활성화하거나 삭제할 수 있습니다.
- 키를 잃어버리면요?
- 전체 값은 생성 시 한 번만 보이고 서버에는 해시만 남아 복구할 수 없습니다. 잃어버렸다면 개발자 센터에서 해당 키를 재발급하세요. 이름·만료일·IP 허용 목록은 그대로 유지되고, 이전 값은 즉시 무효가 됩니다.
- 어떤 클라이언트를 지원하나요?
- Streamable HTTP로 원격 MCP 서버에 연결하고 요청 헤더에 키를 담아 보낼 수 있는 클라이언트면 됩니다. Claude Code, Cursor 등이 해당합니다. Claude Desktop은 위의 로컬 stdio 방식으로 연결하세요.
- 키가 유출되면요?
- 개발자 센터에서 즉시 비활성화하거나 삭제하고 새 키를 만드세요. 키에 IP 허용 목록을 걸어 내 서버에서만 호출되게 할 수도 있습니다.