{"kind":"guides","slug":"text-to-speech-mcp-server","path":"/guides/text-to-speech-mcp-server","title":"AI 어시스턴트용 텍스트 음성 변환 MCP 서버 | SuperClonica","description":"텍스트 음성 변환 MCP 서버. Claude Code, Cursor, VS Code에 연결하면 AI 어시스턴트가 약 190개 목소리로 텍스트를 읽어 줍니다. 무료 키로 시작하세요.","h1":"텍스트 음성 변환 MCP 서버: AI 어시스턴트에 목소리를","intro":"MCP(Model Context Protocol)는 AI 어시스턴트가 외부 도구를 쓰게 해 줍니다. SuperClonica MCP 서버는 어시스턴트에 목소리를 줍니다. 어시스턴트가 목소리를 찾고, 텍스트를 읽고, 오디오 파일 링크를 돌려줍니다.\n\nSuperClonica 음성 API와 같은 키, 같은 요금제로 작동하므로 무료 키로 시작할 수 있습니다.","sections":[{"heading":"서버가 하는 일","paragraphs":["서버 주소는 https://superclonica.com/mcp이며 도구가 세 가지 있습니다. list_voices는 기본 목소리와 카탈로그 전체(캐릭터, 내레이터, 아나운서)를 모든 언어의 이름, 태그, 설명으로 찾습니다. speak는 한 목소리로 텍스트를 읽고 1시간 동안 유효한 MP3, OGG, WAV 파일 링크를 돌려줍니다. get_usage는 요금제와 남은 초를 알려 줍니다."]},{"heading":"Claude Code에 연결","paragraphs":["음성 API 페이지에서 무료 키를 만들고 터미널에서 명령 하나를 실행하세요: claude mcp add --transport http superclonica https://superclonica.com/mcp --header \"Authorization: Bearer sc_YOUR_KEY\". sc_YOUR_KEY를 내 키로 바꾸세요. Claude Code의 /mcp에 세 도구가 보이고, 음성을 요청하면 어시스턴트가 호출합니다."]},{"heading":"Cursor 또는 VS Code에 연결","paragraphs":["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 헤더로 똑같이 연결됩니다."]},{"heading":"요청하는 방법","paragraphs":["평소 말로 요청하세요. 예: 다스 베이더 목소리로 \"어둠의 편에 온 것을 환영한다\"를 읽어 줘, 차분한 여성 내레이터를 찾아 이 문단을 한국어로 읽어 줘, 오늘 몇 초 남았어? 목소리는 이름이나 id로 지정할 수 있고, 같은 이름이 여러 개면 어시스턴트가 짧은 후보 목록을 받습니다. 오디오를 재생하는 클라이언트는 답변 안에서 소리도 받을 수 있습니다."]},{"heading":"한도와 요금제","paragraphs":["MCP 서버는 음성 API 요금제에 포함됩니다. 무료 키는 카탈로그의 어떤 목소리로든 하루 3분, 유료 요금제는 월 5달러에 최대 216시간부터입니다. 한 번 호출에 최대 2만 자이며, 한도에 도달하면 어시스턴트는 오류 대신 다시 시도할 시간을 알려 주는 메시지를 받습니다."]}],"faq":[{"question":"텍스트 음성 변환 MCP 서버는 무료인가요?","answer":"네, 무료 키로 하루 3분, 카드 없이 쓸 수 있습니다. 유료 요금제로 한도가 늘어납니다."},{"question":"어떤 AI 어시스턴트에서 쓸 수 있나요?","answer":"Claude Code, Cursor, VS Code처럼 사용자 지정 헤더가 있는 HTTP로 원격 MCP 서버에 연결하는 클라이언트입니다. OAuth 로그인만 지원하는 클라이언트는 아직 키를 전달할 수 없습니다."},{"question":"어시스턴트가 소리를 재생할 수 있나요?","answer":"파일 링크는 항상 받습니다. 오디오를 재생하는 클라이언트는 답변 안에서 소리도 받을 수 있습니다(최대 3MB)."},{"question":"중국어도 되나요?","answer":"아니요. 목소리는 31개 언어를 말하며 중국어는 아직 없습니다."},{"question":"로컬 TTS MCP 서버가 있나요?","answer":"SuperClonica MCP 서버는 클라우드에서 동작합니다. 완전히 오프라인으로 하려면 무료 엔진을 설치하세요(python -m pip install superclonica-cpu). Claude Code처럼 터미널 명령을 실행하는 어시스턴트는 내 컴퓨터에서 파일을 음성으로 만들 수 있습니다."}],"cta":{"catalog":"목소리 보기","install":"SuperClonica 엔진 설치","api":"무료 API 키 받기"},"sources":[{"label":"Model Context Protocol: specification","url":"https://modelcontextprotocol.io/specification"},{"label":"Claude Code: connect to MCP servers","url":"https://docs.claude.com/en/docs/claude-code/mcp"},{"label":"VS Code: MCP servers","url":"https://code.visualstudio.com/docs/copilot/customization/mcp-servers"},{"label":"Cursor: Model Context Protocol","url":"https://cursor.com/docs/context/mcp"}],"published":"2026-11-01","updated":"2026-11-01","pages":[{"slug":"tts-mcp-server","path":"/guides/tts-mcp-server","h1":"텍스트 음성 변환 MCP 서버: AI 에이전트가 소리 내어 말하게"},{"slug":"claude-text-to-speech","path":"/guides/claude-text-to-speech","h1":"Claude 텍스트 음성 변환: 음성 모드와 Claude Code용 음성"},{"slug":"ai-voice-agent-tts","path":"/guides/ai-voice-agent-tts","h1":"AI 음성 에이전트를 위한 음성 합성: 빠르고 저렴한 음성 레이어"},{"slug":"vapi-custom-voice","path":"/guides/vapi-custom-voice","h1":"Vapi 사용자 목소리: 30줄로 만드는 나만의 TTS 서버"},{"slug":"coding-agent-text-to-speech","path":"/guides/coding-agent-text-to-speech","h1":"Codex, Cursor, VS Code에서 텍스트 음성 변환"},{"slug":"pipecat-custom-tts","path":"/guides/pipecat-custom-tts","h1":"Pipecat 사용자 TTS 서비스: 음성 봇에 원하는 목소리를"},{"slug":"home-assistant-text-to-speech","path":"/guides/home-assistant-text-to-speech","h1":"Home Assistant TTS를 자연스러운 로컬 목소리로"},{"slug":"discord-js-tts-bot","path":"/guides/discord-js-tts-bot","h1":"AI 목소리를 음성 채널에 스트리밍하는 discord.js TTS 봇"},{"slug":"livekit-custom-tts","path":"/guides/livekit-custom-tts","h1":"LiveKit Agents 사용자 TTS: 음성 에이전트에 원하는 목소리를"},{"slug":"openai-compatible-tts-server","path":"/guides/openai-compatible-tts-server","h1":"내 컴퓨터에서 돌아가는 OpenAI 호환 TTS 서버"},{"slug":"free-text-to-speech-api","path":"/guides/free-text-to-speech-api","h1":"무료 텍스트 음성 변환 API: 키 없이, 한도 없이, 내 서버에서"},{"slug":"text-to-speech-api-docker","path":"/guides/text-to-speech-api-docker","h1":"Docker로 직접 운영하는 음성 합성 API"}],"related":[{"slug":"text-to-speech","path":"/text-to-speech","h1":"내 컴퓨터에서 돌아가는 음성 합성(TTS)"},{"slug":"supertonic","path":"/compare/supertonic","h1":"Supertonic vs SuperClonica: 같은 모델, 더 빠르고 깨끗하게"},{"slug":"fish-audio","path":"/compare/fish-audio","h1":"Fish Audio·Fish Speech와 SuperClonica 비교"},{"slug":"omnivoice","path":"/compare/omnivoice","h1":"OmniVoice와 SuperClonica: 언어 수인가, 속도인가"},{"slug":"qwen3-tts","path":"/compare/qwen3-tts","h1":"로컬 음성 합성, Qwen3-TTS와 SuperClonica 중 무엇을 쓸까"},{"slug":"voxcpm","path":"/compare/voxcpm","h1":"VoxCPM 2와 SuperClonica: 스튜디오 음질인가, CPU 속도인가"},{"slug":"f5-tts","path":"/compare/f5-tts","h1":"F5-TTS와 SuperClonica: 제로샷 복제인가, CPU에서 빠른 음성인가"},{"slug":"elevenlabs","path":"/compare/elevenlabs","h1":"오프라인으로 쓰는 ElevenLabs 대안"},{"slug":"kokoro","path":"/compare/kokoro","h1":"Kokoro TTS와 SuperClonica: 로컬 음성 합성을 위한 작은 모델 두 가지"},{"slug":"piper","path":"/compare/piper","h1":"Piper TTS와 SuperClonica: 소형 기기인가, 맞춤 목소리인가"},{"slug":"xtts","path":"/compare/xtts","h1":"Coqui XTTS-v2와 SuperClonica: Coqui TTS 대안"},{"slug":"chatterbox","path":"/compare/chatterbox","h1":"Chatterbox TTS와 SuperClonica: 즉시 복제인가, 학습된 목소리 파일인가"}]}