구성도구

모델 컨텍스트 프로토콜

모델 컨텍스트 프로토콜을 사용하여 ElevenLabs 대화형 에이전트를 외부 도구 및 데이터 소스에 연결하세요.

사용자 책임

ElevenLabs 대화형 에이전트와 통합하는 모든 타사 MCP 서버의 보안, 규정 준수 및 동작에 대한 책임은 사용자에게 있습니다. ElevenLabs는 통합을 위한 플랫폼을 제공하지만 외부 MCP 서버를 관리, 보증 또는 보호하지 않습니다.

개요

이 가이드에서는 ElevenLabs 에이전트가 외부 MCP 서버에 액세스하도록 설정하는 방법을 다룹니다. 반대로 Claude 또는 다른 MCP 클라이언트에서 ElevenLabs 에이전트를 관리하려면 호스팅 MCP 서버를 사용하세요.

모델 컨텍스트 프로토콜(MCP)은 애플리케이션이 대규모 언어 모델(LLM)에 컨텍스트를 제공하는 방식을 정의하는 개방형 표준입니다. MCP는 AI 모델이 다양한 데이터 소스 및 도구와 원활하게 상호작용할 수 있도록 하는 범용 커넥터라고 생각할 수 있습니다. MCP를 구현하는 서버를 통합하면 ElevenLabs 대화형 에이전트의 기능을 크게 확장할 수 있습니다.

현재 Zero Retention Mode를 사용하는 사용자 또는 HIPAA 규정 준수가 필요한 사용자에게는 MCP 지원이 제공되지 않습니다.

ElevenLabs에서는 대화형 에이전트를 외부 MCP 서버에 연결할 수 있습니다. 이를 통해 에이전트는 다음을 수행할 수 있습니다.

  • MCP 서버를 통해 다양한 데이터 소스의 정보에 액세스하고 처리
  • MCP 서버에서 제공하는 전문 도구 및 기능 활용
  • 더 역동적이고, 정보에 기반하며, 상호작용적인 대화 경험 생성

워크스페이스에서 MCP 활성화하기

MCP는 모든 워크스페이스에서 기본적으로 비활성화되어 있습니다. MCP 서버를 추가하거나 사용하려면 먼저 워크스페이스 구성원 한 명이 워크스페이스를 대표하여 옵트인해야 합니다.

누군가 MCP 서버 통합 대시보드에서 처음으로 MCP 서버를 추가하려고 하면 옵트인이 자동으로 진행됩니다. 대화 상자에서 모델 컨텍스트 프로토콜 서버 약관을 검토하고 수락하라는 메시지가 표시됩니다. 수락하면 워크스페이스 전체에서 MCP가 활성화되므로, ElevenAgents에 액세스할 수 있는 모든 구성원이 MCP 서버를 추가하고 에이전트에 연결할 수 있습니다.

MCP 활성화는 에이전트별 설정이 아닌 워크스페이스 전체 설정입니다. 모든 구성원 또는 convai_write 권한이 있는 모든 API 키가 이를 켜거나 끌 수 있으며, 워크스페이스 관리자에게만 제한되지 않습니다.

워크스페이스에서 MCP를 활성화하면 추가하는 각 MCP 서버는 독립적인 리소스가 됩니다. 에이전트나 지식 기반 문서를 공유하는 것처럼, 이를 만든 구성원이 다른 워크스페이스 구성원과 개별적으로 공유할 수 있습니다.

이 설정을 활성화해도 위의 Zero Retention Mode 및 HIPAA 제한은 적용된 상태로 유지됩니다. Zero Retention Mode 또는 HIPAA 규정 준수가 활성화된 워크스페이스는 can_use_mcp_servers 설정과 관계없이 MCP 서버를 사용할 수 없습니다.

시작하기

ElevenLabs는 SSE(Server-Sent Events)와 HTTP 스트리밍 가능 전송 MCP 서버를 모두 지원합니다.

이 예시에서는 ElevenAgents를 수백 가지 도구 및 서비스에 연결할 수 있는 Zapier MCP를 사용합니다.

MCP 서버는 아직 ElevenLabs CLI에서 관리할 수 없습니다. 대시보드 또는 SDK를 사용하세요.
1

MCP 통합 열기

MCP 서버 통합 대시보드로 이동하여 맞춤 MCP 서버 추가를 클릭하세요.

첫 MCP 서버 만들기

2

MCP 서버 구성

다음 세부 정보를 입력하세요.

  • 이름: MCP 서버의 이름(예: “Zapier MCP 서버”)
  • 설명: MCP 서버가 수행할 수 있는 작업에 대한 설명
  • 서버 URL: MCP 서버의 URL입니다. 비밀 키가 포함된 경우 비밀번호처럼 취급하고 워크스페이스 시크릿으로 저장하세요.
  • 시크릿 토큰(선택 사항): Authorization 헤더 값
  • HTTP 헤더(선택 사항): 서버에서 요구하는 추가 헤더
3

연결 저장 및 테스트

통합 추가를 클릭하여 통합을 저장하고 연결을 테스트하여 사용 가능한 도구를 나열하세요.

Zapier 예시 도구

4

에이전트에 서버 연결

이제 MCP 서버를 에이전트에 추가할 수 있습니다. MCP 지원은 공개 및 비공개 에이전트 모두에서 사용할 수 있습니다.

에이전트에 MCP 서버 추가하기

도구 승인 모드

ElevenLabs는 에이전트가 MCP 서버의 도구 사용 권한을 요청하는 방식을 관리할 수 있는 유연한 승인 제어 기능을 제공합니다. 보안을 최대한 제어할 수 있도록 MCP 서버 수준과 개별 도구 수준 모두에서 승인 설정을 구성할 수 있습니다.

도구 승인 모드 설정

사용 가능한 승인 모드

  • 항상 확인(권장): 최고 수준의 보안입니다. 에이전트는 도구를 사용할 때마다 권한을 요청합니다.
  • 세분화된 도구 승인: 자동으로 실행할 도구와 승인이 필요한 도구를 비활성화하거나 미리 선택합니다.
  • 승인 없음: 어시스턴트가 승인 없이 모든 도구를 사용할 수 있습니다.

세분화된 도구 제어

세분화된 도구 승인 모드에서는 개별 도구마다 서로 다른 승인 요구 사항을 구성할 수 있으므로, 자동으로 실행할 도구와 명시적 권한이 필요한 도구를 정밀하게 제어할 수 있습니다.

세분화된 도구 승인 설정

각 도구에 대해 다음을 설정할 수 있습니다.

  • 자동 승인됨: 권한을 요구하지 않고 도구가 자동으로 실행됩니다.
  • 승인 필요: 실행 전에 명시적 권한이 필요합니다.
  • 비활성화됨: 도구가 완전히 비활성화되어 사용할 수 없습니다.

세분화된 도구 승인을 사용하여 위험도가 낮은 읽기 전용 도구는 자동으로 실행되도록 허용하고, 데이터를 수정하거나 민감한 작업을 수행하는 도구에는 승인을 요구하세요.

ElevenLabs 통합 시 주요 고려 사항

  • 외부 서버: 통합할 외부 MCP 서버를 선택할 책임은 사용자에게 있습니다. ElevenLabs는 이러한 서버에 연결할 수단을 제공합니다.
  • 지원 기능: ElevenLabs는 실시간 상호작용을 위해 SSE(Server-Sent Events) 및 HTTP 스트리밍 가능 전송을 통해 통신하는 MCP 서버를 지원합니다.
  • 동적 도구: 통합된 MCP 서버에서 사용할 수 있는 도구와 기능은 해당 외부 서버에서 정의하며, 서버 구성이 업데이트되면 변경될 수 있습니다.

보안 및 고지 사항

외부 MCP 서버를 통합하면 에이전트와 데이터가 타사 서비스에 노출될 수 있습니다. 보안 영향을 이해하는 것이 매우 중요합니다.

중요 고지 사항

MCP 서버 통합을 활성화하면 ElevenLabs가 제어하지 않는 타사 서비스와 데이터를 공유할 수 있음을 인정하는 것입니다. 이로 인해 추가적인 보안 위험이 발생할 수 있습니다. 계속하기 전에 영향을 완전히 이해하고, 통합하려는 MCP 서버의 보안을 검토하며, MCP 통합 보안 가이드라인을 확인하세요.

자세한 모범 사례는 MCP 통합 보안 가이드라인을 참조하세요.

MCP 서버 찾기 또는 구축하기

  • 신뢰할 수 있는 제공업체가 공개적으로 제공하는 MCP 서버 활용
  • 독점 데이터 또는 도구를 노출하기 위한 자체 MCP 서버 개발
  • 예시 및 서버 구현을 위해 모델 컨텍스트 프로토콜 커뮤니티와 리소스 탐색

리소스