Claude Desktop으로 빠른 시작
ElevenLabs 에서 API 키를 받으세요. 월 1만 크레딧을 제공하는 무료 티어가 있습니다.
uv(Python 패키지 관리자)를 설치하고curl -LsSf https://astral.sh/uv/install.sh | sh로 설치하거나, 추가 설치 방법은uv저장소를 참조하세요.Claude > 설정 > 개발자 > 구성 편집 > claude_desktop_config.json으로 이동하여 다음을 포함합니다.
지엑스피1
Windows를 사용하는 경우, MCP 서버를 사용하려면 Claude Desktop에서 "개발자 모드"를 활성화해야 합니다. 왼쪽 상단의 햄버거 메뉴에서 "도움말"을 클릭하고 "개발자 모드 활성화"를 선택하세요.
Related MCP server: ElevenLabs MCP Server
다른 MCP 클라이언트
Cursor 및 Windsurf와 같은 다른 클라이언트의 경우 다음을 실행하세요.
pip install elevenlabs-mcppython -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print사용하여 구성을 가져옵니다. MCP 클라이언트에서 지정한 적절한 구성 디렉터리에 붙여넣으세요.
이제 MCP 클라이언트는 다음 도구를 통해 ElevenLabs와 상호 작용할 수 있습니다.
사용 예
⚠️ 경고: 이 도구를 사용하려면 ElevenLabs 크레딧이 필요합니다.
클로드에게 물어보세요:
"영화 누아르 탐정처럼 말하고 고전 영화에 대한 질문에 답할 수 있는 AI 에이전트를 만들어 보세요."
"현명한 고대 용 캐릭터에 대한 세 가지 음성 변형을 생성한 다음, 내 음성 라이브러리에 추가할 가장 마음에 드는 음성을 선택하겠습니다."
"내 목소리를 중세 기사처럼 들리도록 변환해줘"
"울창한 정글 속 폭풍우 소리와 날씨에 반응하는 동물들의 사운드스케이프를 만들어 보세요."
"이 연설을 텍스트로 바꾸고, 다른 화자를 식별한 다음, 각 사람의 고유한 음성을 사용하여 다시 변환하세요."
선택 사양
claude_desktop_config.json 에 ELEVENLABS_MCP_BASE_PATH 환경 변수를 추가하여 MCP 서버가 찾아야 하는 기본 경로를 지정하고 상대 경로로 지정된 파일을 출력할 수 있습니다.
기여하다
소스에서 기여하거나 실행하려면:
저장소를 복제합니다.
uv를 사용하여 가상 환경을 만들고 종속성을 설치합니다.
.env.example``.env로 복사하고 ElevenLabs API 키를 추가하세요.
모든 것이 제대로 작동하는지 확인하기 위해 테스트를 실행하세요.
Claude Desktop에 서버를 설치하세요:
mcp install elevenlabs_mcp/server.pyMCP Inspector를 사용하여 로컬에서 디버깅하고 테스트하세요:
mcp dev elevenlabs_mcp/server.py
문제 해결
Claude Desktop을 실행할 때의 로그는 다음 위치에서 확인할 수 있습니다.
Windows :
%APPDATA%\Claude\logs\mcp-server-elevenlabs.logmacOS :
~/Library/Logs/Claude/mcp-server-elevenlabs.log
특정 도구 사용 시 시간 초과 발생
음성 디자인 및 오디오 분리와 같은 일부 ElevenLabs API 작업은 해결하는 데 시간이 오래 걸릴 수 있습니다. 개발자 모드에서 MCP 검사기를 사용할 경우 도구가 의도한 작업을 완료했음에도 불구하고 시간 초과 오류가 발생할 수 있습니다.
Claude와 같은 클라이언트를 사용하는 경우 이런 일이 발생하지 않아야 합니다.
MCP ElevenLabs: uvx ENOENT 생성
"MCP ElevenLabs: spawn uvx ENOENT" 오류가 발생하면 터미널에서 다음 명령을 실행하여 절대 경로를 확인하세요.
절대 경로(예: /usr/local/bin/uvx )를 얻은 후 해당 경로를 사용하도록 구성을 업데이트하세요(예: "command": "/usr/local/bin/uvx" ). 이렇게 하면 올바른 실행 파일이 참조됩니다.