> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# ElevenLabs MCP 서버

## 개요

ElevenLabs MCP 서버는 AI 어시스턴트가 ElevenLabs 워크스페이스에 액세스할 수 있도록 해 주는 원격 [Model Context Protocol(MCP)](https://modelcontextprotocol.io/) 서버입니다. 연결하면 Claude, ChatGPT, Cursor 같은 어시스턴트가 별도의 설치나 로컬 실행 없이 자연어로 음성, 이미지, 비디오, 사운드를 생성하고, 음성을 디자인하며, [플로우](/docs/ko/eleven-creative/products/flows)를 구축하고 에이전트를 관리할 수 있습니다.

서버는 다음에서 사용할 수 있습니다.

```
https://api.elevenlabs.io/v1/mcp
```

인증에는 OAuth를 사용합니다. 연결할 때 ElevenLabs 계정으로 로그인하고, 워크스페이스를 선택한 다음 어시스턴트가 요청하는 권한을 승인합니다. 클라이언트에 API 키를 복사할 필요가 없으며, 생성에는 로그인한 워크스페이스의 크레딧이 사용됩니다.

> **Note**
>
> 대신 ElevenLabs 에이전트에 외부 MCP 서버 액세스 권한을 부여하려고 하시나요? [MCP 통합 가이드](/docs/ko/eleven-agents/customization/tools/mcp)를 참조하세요.

## 용도

ElevenLabs 앱으로 전환하거나 API용 코드를 작성하는 대신, 이미 사용 중인 어시스턴트에서 ElevenLabs를 사용하려면 MCP 서버를 이용하세요. 다음 두 가지 작업에 적합합니다.

* **크리에이티브 작업**: 대화로 보이스오버, 이미지, 비디오, 음향 효과, 음악을 생성하고 여러 차례에 걸쳐 다듬는 작업
* **에이전트 작업**: [ElevenAgents](/docs/ko/eleven-agents/overview) 에이전트를 생성, 구성, 테스트 및 검토하는 작업

ElevenLabs를 자체 애플리케이션에 구축하려면 [API](/docs/ko/api-reference/introduction)와 [SDK](/docs/ko/eleven-api/resources/libraries)를 사용하세요.

## Claude에서 연결하기

서버를 커스텀 커넥터로 추가하세요. 그러면 Claude에서 서버가 제공하는 모든 도구를 사용할 수 있습니다.

#### 커넥터 메뉴 열기

Claude에서 **Settings** > **Connectors**로 이동한 후 **Add custom connector**를 선택하세요. 새 채팅에서
**+** 버튼을 선택한 다음 **Add connector** > **Add custom connector**를 선택해도 됩니다.

#### 서버 URL 입력

커넥터 이름을 "ElevenLabs"로 지정하고 `https://api.elevenlabs.io/v1/mcp`를 입력하세요. **Add**를 선택하세요.

#### 로그인 및 승인

ElevenLabs 계정으로 OAuth 절차를 완료하세요. 워크스페이스를 선택하고 요청된
권한을 검토한 후 **Authorize**를 선택하세요.

> **Warning**
>
> Claude 커넥터 디렉터리에 등록된 ElevenLabs 커넥터는 제한된 버전입니다. 이 커넥터는
> 음성, 보이스, 전사 및 에이전트를 지원하지만 이미지, 비디오 또는 음악은 생성할 수 없습니다. 전체 도구 세트를 사용하려면
> 위의 커스텀 커넥터를 추가하세요.

다른 MCP 클라이언트도 같은 방식으로 작동합니다. 클라이언트에서 서버 URL을 지정하고 OAuth 절차를 완료하세요. 호스팅된 클라이언트 메타데이터(CIMD)를 지원하는 클라이언트는 등록할 필요가 없습니다. 워크스페이스가 격리된 데이터 레지던시 환경에 있다면 [데이터 레지던시 리전](/docs/ko/eleven-agents/operate/hosted-mcp#data-residency-regions)에 나열된 해당 리전의 URL을 사용하세요.

## 크리에이티브 도구

모든 크리에이티브 생성 결과는 프롬프트, 참조 자료, 결과를 담을 수 있는 편집 가능한 캔버스인 [플로우](/docs/ko/eleven-creative/products/flows)에 저장됩니다. 어시스턴트가 플로우 링크를 반환하므로 ElevenLabs 앱에서 열어 결과를 검토하고, 노드를 조정하거나 다시 실행할 수 있습니다. Claude처럼 MCP Apps를 지원하는 클라이언트에서는 채팅 내에 플로우와 결과도 표시됩니다.

크리에이티브 도구를 사용하면 어시스턴트는 다음을 수행할 수 있습니다.

* 이미지와 비디오를 생성하고 기존 이미지를 편집
* 워크스페이스의 모든 음성으로 텍스트 음성을 생성하고 오디오 전사
* 플로우 노드를 통해 음향 효과, 음악 및 기타 오디오 생성
* 설명을 바탕으로 새 음성을 디자인하고 선택한 음성 저장
* 보이스오버가 포함된 비디오나 생성된 음성으로 만든 립싱크처럼 하나의 플로우에서 생성 작업 연결
* 컴퓨터에서 업로드하거나 URL에서 가져온 자체 파일을 참조 자료로 사용
* 생성 결과가 브랜드 색상, 글꼴, 로고를 따르도록 브랜드 키트 관리
* 사용 가능한 모델, 매개변수 및 프롬프팅 가이드 조회

이미지와 비디오 생성은 기본적으로 여러 변형을 반환하며, 음성 생성은 2개의 테이크를 반환합니다. 사용할 변형을 어시스턴트에게 알려주면 해당 결과를 다음 단계로 이어갑니다.

> **Note**
>
> 생성에는 ElevenLabs 앱에서 생성할 때와 동일하게 크레딧이 사용됩니다. 아직 실행 중인 생성을 어시스턴트에게 재시도하도록 요청하지 마세요.
> 재시도할 때마다 새 생성이 시작되고 비용이 청구됩니다.

### 프롬프트 예시

* "대리석 카운터 위에 놓인 세라믹 커피 머그의 제품 사진을 생성해 줘. 아침 햇살, 16:9."
* "두 번째 이미지를 천천히 줌인하는 5초짜리 비디오로 만들어 줘."
* "이 비디오용 20초 분량의 보이스오버를 따뜻한 영국식 음성으로 작성하고, 같은 플로우에 추가해 줘."
* "거친 늙은 바다 선장을 위한 음성을 디자인하고 미리 보기 3개를 들려줘."
* "첨부된 인터뷰를 전사하고 화자를 나열해 줘."

## 에이전트 도구

에이전트 도구는 워크스페이스의 에이전트를 생성, 구성 및 관리합니다. 에이전트 설정, 대화와 전사본, 절차, 도구, 지식 베이스 문서, 테스트, 브랜치, 배포 및 이슈를 지원합니다. 전체 목록, 프롬프트 예시 및 에이전트 업데이트 동작은 [ElevenAgents용 호스팅 MCP](/docs/ko/eleven-agents/operate/hosted-mcp)를 참조하세요.

## 생성된 파일

서버는 사용자 콘텐츠용 ElevenLabs 도메인인 `elevenlabsusercontent.com`의 링크로 생성된 파일을 반환합니다. ElevenLabs는 워크스페이스의 파일이 `elevenlabs.io`의 쿠키를 읽거나 설정할 수 없도록 사용자 콘텐츠를 별도 도메인에서 제공합니다.

이 링크는 서명되어 있으며 어시스턴트가 받은 후 약 2시간이 지나면 만료됩니다. 새 링크가 필요하면 어시스턴트에게 생성을 다시 가져오도록 요청하거나 ElevenLabs 앱에서 플로우를 여세요. 네트워크 또는 MCP 클라이언트에서 미디어를 로드할 수 있는 도메인을 제한하는 경우 `elevenlabsusercontent.com`을 허용하세요.

## 권한

OAuth 동의 화면에는 ElevenAgents, 텍스트 음성 변환, 플로우, 이미지 및 비디오 생성 등 어시스턴트가 요청하는 권한이 표시됩니다. 어시스턴트는 승인한 권한과 워크스페이스 내 역할이 허용하는 작업만 수행할 수 있습니다. 언제든지 MCP 클라이언트 또는 ElevenLabs 계정 설정에서 연결을 해제할 수 있습니다.

Claude 같은 MCP 클라이언트에서는 어시스턴트가 사용할 수 있는 커넥터 도구와 각 호출 전에 승인이 필요한 도구도 선택할 수 있습니다. 워크스페이스 관리자는 조직 전체에 대해 이러한 제어 기능을 구성할 수 있습니다.

## 관련 리소스

#### [ElevenAgents용 호스팅 MCP](/docs/ko/eleven-agents/operate/hosted-mcp)

에이전트 도구, 데이터 레지던시 URL 및 에이전트 권한.

#### [플로우](/docs/ko/eleven-creative/products/flows)

모든 크리에이티브 생성 결과가 저장되는 캔버스.

#### [에이전트 도구](/docs/ko/eleven-api/resources/agent-tooling)

코딩 어시스턴트를 위한 에이전트 스킬 및 기타 도구.

#### [API 레퍼런스](/docs/ko/api-reference/introduction)

플랫폼을 프로그래밍 방식으로 제어하기 위한 전체 REST API.