👁 내보내다

👁 디스코드 커뮤니티
👁 지저귀다
👁 파이파이
👁 테스트

Claude Desktop으로 빠른 시작

1. ElevenLabs 에서 API 키를 받으세요. 월 1만 크레딧을 제공하는 무료 티어가 있습니다.

2. uv (Python 패키지 관리자)를 설치하고 curl -LsSf https://astral.sh/uv/install.sh | sh 로 설치하거나, 추가 설치 방법은 uv저장소를 참조하세요.

3. Claude > 설정 > 개발자 > 구성 편집 > claude_desktop_config.json으로 이동하여 다음을 포함합니다.

지엑스피1

Windows를 사용하는 경우, MCP 서버를 사용하려면 Claude Desktop에서 "개발자 모드"를 활성화해야 합니다. 왼쪽 상단의 햄버거 메뉴에서 "도움말"을 클릭하고 "개발자 모드 활성화"를 선택하세요.

Related MCP server: ElevenLabs MCP Server

다른 MCP 클라이언트

Cursor 및 Windsurf와 같은 다른 클라이언트의 경우 다음을 실행하세요.

1. pip install elevenlabs-mcp

2. python -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 서버가 찾아야 하는 기본 경로를 지정하고 상대 경로로 지정된 파일을 출력할 수 있습니다.

기여하다

소스에서 기여하거나 실행하려면:

1. 저장소를 복제합니다.

git clone https://github.com/elevenlabs/elevenlabs-mcp
cd elevenlabs-mcp

2. uv를 사용하여 가상 환경을 만들고 종속성을 설치합니다.

uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"

3. .env.example``.env 로 복사하고 ElevenLabs API 키를 추가하세요.

cp .env.example .env
# Edit .env and add your API key

4. 모든 것이 제대로 작동하는지 확인하기 위해 테스트를 실행하세요.

./scripts/test.sh
# Or with options
./scripts/test.sh --verbose --fail-fast

5. Claude Desktop에 서버를 설치하세요: mcp install elevenlabs_mcp/server.py

6. MCP Inspector를 사용하여 로컬에서 디버깅하고 테스트하세요: mcp dev elevenlabs_mcp/server.py

문제 해결

Claude Desktop을 실행할 때의 로그는 다음 위치에서 확인할 수 있습니다.

• Windows : %APPDATA%\Claude\logs\mcp-server-elevenlabs.log

• macOS : ~/Library/Logs/Claude/mcp-server-elevenlabs.log

특정 도구 사용 시 시간 초과 발생

음성 디자인 및 오디오 분리와 같은 일부 ElevenLabs API 작업은 해결하는 데 시간이 오래 걸릴 수 있습니다. 개발자 모드에서 MCP 검사기를 사용할 경우 도구가 의도한 작업을 완료했음에도 불구하고 시간 초과 오류가 발생할 수 있습니다.

Claude와 같은 클라이언트를 사용하는 경우 이런 일이 발생하지 않아야 합니다.

MCP ElevenLabs: uvx ENOENT 생성

"MCP ElevenLabs: spawn uvx ENOENT" 오류가 발생하면 터미널에서 다음 명령을 실행하여 절대 경로를 확인하세요.

which uvx

절대 경로(예: /usr/local/bin/uvx )를 얻은 후 해당 경로를 사용하도록 구성을 업데이트하세요(예: "command": "/usr/local/bin/uvx" ). 이렇게 하면 올바른 실행 파일이 참조됩니다.

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• add_knowledge_base_to_agentA
• check_subscriptionA
• compose_musicB
• create_agentA
• create_composition_planA
• create_voice_from_previewA
• get_agentB
• get_conversationA