MCP로 VocaLingo를 Claude, ChatGPT, Cursor에 연결하기

VocaLingo를 연결하면 AI 어시스턴트가 화자의 음성으로 음성 메시지를 번역하거나, YouTube 동영상을 요약하고, 내 목소리로 텍스트를 읽어 주거나, 동영상을 더빙하고 자막을 추가할 수 있어요. 에이전트는 일반 VocaLingo 잔액에서 토큰을 사용하며, 모든 결과는 앱 기록에도 표시돼요. 컴퓨터에서 더빙을 시작하고 스마트폰에서 이어서 확인할 수도 있어요.

서버 세부정보

1단계. AI 에이전트 화면 열기

1. iOS, Android 또는 web.vocalingo.app에서 VocaLingo를 열고 로그인하세요.

2. 설정 → AI 에이전트 (MCP)로 이동하세요. 화면 이름은 “내 AI에 VocaLingo 연결하기”예요.

3. “내 AI 선택” 아래에서 사용할 어시스턴트인 Claude, ChatGPT, Cursor, VS Code, Claude Code 또는 기타를 탭하세요. 화면에 진행 단계가 표시돼요.

Claude 연결하기

claude.ai, Claude Desktop 및 Claude 모바일 앱에서 작동해요.

1. AI 에이전트 화면에서 Claude 열기를 탭하세요. 이름과 주소가 이미 입력된 상태로 “사용자 지정 커넥터 추가” 창이 열려요.

2. 추가를 탭한 다음 연결을 탭하세요.

3. Claude가 VocaLingo 로그인 페이지를 열어요. 이메일로 전송된 코드, Google, 또는 앱의 코드를 사용해 앱과 동일한 방식으로 로그인하세요.

수동으로 설정하려면: Claude에서 사용자 지정 → 커넥터 → 사용자 지정 커넥터 추가를 열고 https://nodejs.vocalingo.app/mcp를 붙여넣은 뒤 연결을 탭하세요. 이후 모든 기기의 Claude에서 VocaLingo를 사용할 수 있어요.

ChatGPT 연결하기

1. AI 에이전트 화면에서 서버 주소를 복사하세요.

2. 휴대폰이나 컴퓨터의 브라우저에서 chatgpt.com/plugins를 여세요.

3. + → 사용자 지정 MCP 서버 추가를 탭하세요.

4. 이름에 VocaLingo를 입력하고, 주소를 붙여넣은 뒤, OAuth 로그인을 선택하고, “이해했으며 계속 진행합니다”를 확인한 다음 생성을 탭하세요.

5. 열리는 페이지에서 VocaLingo에 로그인하세요.

사용자 지정 MCP 서버는 일부 ChatGPT 요금제에서는 지원되지 않아요.

Claude 또는 ChatGPT에서 로그인하는 방법

로그인 페이지에서는 앱과 동일한 방식인 이메일 인증 코드나 Google을 지원해요. Apple로 앱에 로그인했거나 로그인 방식을 잊어버린 경우, AI 에이전트 화면에서 로그인 코드 받기를 탭하세요. 로그인 페이지에서 “VocaLingo 앱 코드로 로그인”을 선택하고 8자리 코드를 입력하세요. 코드는 1회용이며 10분 동안 유효해요.

Cursor 또는 VS Code 연결하기

1. Cursor 또는 VS Code가 설치된 컴퓨터에서 web.vocalingo.app을 열고 로그인하세요.

2. 설정 → AI 에이전트 (MCP)로 이동하여 Cursor 또는 VS Code를 선택하세요.

3. Cursor에 설치 또는 VS Code에 설치를 클릭하세요. 에디터가 열리고 VocaLingo 서버를 추가할 것인지 묻는 메시지가 나타나면 확인하세요.

원클릭 설치는 컴퓨터에서만 작동해요. 설정 복사를 탭한 후 Cursor의 경우 ~/.cursor/mcp.json에, VS Code의 경우 mcp.json(“MCP: 사용자 구성 열기” 명령)에 직접 붙여넣을 수도 있어요. 설정 파일에는 이미 토큰이 포함되어 있어요.

Claude Code 연결하기

1. AI 에이전트 화면에서 Claude Code를 선택하고 명령어 복사를 탭하세요.

2. 터미널에서 실행하세요. 명령줄 형태는 다음과 같아요:

claude mcp add --transport http vocalingo https://nodejs.vocalingo.app/mcp --header "Authorization: Bearer vlmcp_YOUR_TOKEN"

Claude Code를 다시 시작하세요. /mcp 목록에 VocaLingo가 나타나요.

기타 MCP 클라이언트

Windsurf, Cline 및 원격 MCP 서버를 지원하는 모든 클라이언트는 주소 https://nodejs.vocalingo.app/mcp와 헤더 Authorization: Bearer vlmcp_…를 사용하여 연결할 수 있어요. AI 에이전트 화면에서 기타를 선택하여 토큰과 사전 구성된 설정을 복사하세요. Claude Code, Cursor, Codex, Gemini CLI용 플러그인과 사전 구성된 스킬은 GitHub의 vocalingo-mcp 저장소에서 확인할 수 있어요.

VocaLingo MCP 도구

에이전트는 사용자의 요청에 따라 적절한 도구를 선택해요. 유료 도구는 인앱 통화인 VocaLingo 토큰을 사용해요.

translate_video, caption_video, change_voice는 파일이 필요해요. YouTube나 TikTok 링크의 경우 에이전트가 먼저 download_media를 호출한 뒤 다운로드된 파일을 전달해요. 유료 도구의 가격은 앱과 동일하며, 자세한 내용은 각 도구별 토큰 가격을 확인하세요.

에이전트가 비용을 확인하는 방식

• 50 토큰 이상 소요되는 작업은 먼저 가격을 안내하며, 사용자가 동의한 후에만 작업이 시작돼요. 에이전트가 대신 승인할 수는 없어요.

• “이 동영상을 더빙하는 데 비용이 얼마나 드나요?”와 같이 가격을 미리 물어볼 수 있어요. 에이전트는 작업을 시작하지 않고 예상 비용만 확인해요.

• 10분 이내에 동일한 요청을 반복해도 비용이 두 번 청구되지 않아요. 에이전트가 기존과 동일한 작업을 받아와요.

• 잔액이 부족하면 에이전트가 “잔액 부족”을 안내해요. 앱에서 충전할 수 있으며 자세한 내용은 토큰 구매 방법을 확인하세요. MCP 전용 별도 결제는 없어요.

에이전트에 오디오, 사진, 동영상을 보내는 방법

업로드된 파일은 48시간 동안 보관되며, 에이전트는 다시 업로드하지 않고 파일을 재사용할 수 있어요. 파일 크기 제한은 translate_audio 최대 150 MB, speech_to_text 및 save_voice 50 MB, 동영상 도구 및 change_voice 100 MB, 이미지 20 MB예요.

사진 속 텍스트를 읽거나 번역하기만 하면 되는 경우 Claude와 ChatGPT 자체에서 무료로 처리할 수 있어요. translate_image는 텍스트가 번역되어 다시 그려진 이미지 파일 자체가 필요한 경우에 사용하세요.

장시간 작업

시간이 걸리는 도구는 약 25초간 대기한 뒤 완료되면 결과를 반환해요. 완료되지 않으면 에이전트가 jobId를 받아 check_job으로 진행 상태를 확인해요. 더빙은 최대 30분까지 걸릴 수 있어요. 작업 중에 채팅을 닫았다면 에이전트에게 jobId 없이 check_job을 호출하도록 요청하세요. 최근 작업 목록을 보여 줘요. 결과 파일 링크는 24시간 동안 유효하며, 결과 자체는 앱 기록에 계속 보관돼요(Premium이 없으면 도구별 최근 3개 항목까지 보관).

접근 권한, 토큰 및 비활성화 방법

내 토큰을 가진 사람은 누구나 잔액에서 토큰을 사용할 수 있으므로 안전하게 보관하세요. AI 에이전트 화면의 접근 권한 및 토큰 섹션에는 두 가지 작업이 있어요:

• 새 토큰 생성: 기존 토큰은 1분 이내에 작동을 멈춰요. 토큰으로 연결된 에이전트에서 토큰을 교체해 주세요.

• MCP 접근 비활성화: Claude 및 ChatGPT 커넥터를 포함한 모든 에이전트의 접근 권한이 1분 이내에 사라져요. 다시 연결하려면 MCP 접근 활성화를 탭하면 새 토큰이 발급돼요.

자신의 목소리나 명시적인 사용 권한을 받은 음성만 복제하세요. 앱에서도 동일한 규칙이 적용돼요.

자주 묻는 질문