가이드

텍스트 음성 변환 MCP 서버: AI 어시스턴트에 목소리를

MCP(Model Context Protocol)는 AI 어시스턴트가 외부 도구를 쓰게 해 줍니다. SuperClonica MCP 서버는 어시스턴트에 목소리를 줍니다. 어시스턴트가 목소리를 찾고, 텍스트를 읽고, 오디오 파일 링크를 돌려줍니다.

SuperClonica 음성 API와 같은 키, 같은 요금제로 작동하므로 무료 키로 시작할 수 있습니다.

서버가 하는 일

서버 주소는 https://superclonica.com/mcp이며 도구가 세 가지 있습니다. list_voices는 기본 목소리와 카탈로그 전체(캐릭터, 내레이터, 아나운서)를 모든 언어의 이름, 태그, 설명으로 찾습니다. speak는 한 목소리로 텍스트를 읽고 1시간 동안 유효한 MP3, OGG, WAV 파일 링크를 돌려줍니다. get_usage는 요금제와 남은 초를 알려 줍니다.

Claude Code에 연결

음성 API 페이지에서 무료 키를 만들고 터미널에서 명령 하나를 실행하세요: claude mcp add --transport http superclonica https://superclonica.com/mcp --header "Authorization: Bearer sc_YOUR_KEY". sc_YOUR_KEY를 내 키로 바꾸세요. Claude Code의 /mcp에 세 도구가 보이고, 음성을 요청하면 어시스턴트가 호출합니다.

Cursor 또는 VS Code에 연결

Cursor에서는 ~/.cursor/mcp.json에 서버를 추가합니다: {"mcpServers": {"superclonica": {"url": "https://superclonica.com/mcp", "headers": {"Authorization": "Bearer sc_YOUR_KEY"}}}}. VS Code에서는 파일이 .vscode/mcp.json입니다: {"servers": {"superclonica": {"type": "http", "url": "https://superclonica.com/mcp", "headers": {"Authorization": "Bearer sc_YOUR_KEY"}}}}. 사용자 지정 헤더가 있는 원격 HTTP 서버를 지원하는 다른 MCP 클라이언트도 주소와 Authorization 헤더로 똑같이 연결됩니다.

요청하는 방법

평소 말로 요청하세요. 예: 다스 베이더 목소리로 "어둠의 편에 온 것을 환영한다"를 읽어 줘, 차분한 여성 내레이터를 찾아 이 문단을 한국어로 읽어 줘, 오늘 몇 초 남았어? 목소리는 이름이나 id로 지정할 수 있고, 같은 이름이 여러 개면 어시스턴트가 짧은 후보 목록을 받습니다. 오디오를 재생하는 클라이언트는 답변 안에서 소리도 받을 수 있습니다.

한도와 요금제

MCP 서버는 음성 API 요금제에 포함됩니다. 무료 키는 카탈로그의 어떤 목소리로든 하루 3분, 유료 요금제는 월 5달러에 최대 216시간부터입니다. 한 번 호출에 최대 2만 자이며, 한도에 도달하면 어시스턴트는 오류 대신 다시 시도할 시간을 알려 주는 메시지를 받습니다.