Telerivet MCP

npx add-mcp 'https://api.telerivet.com/mcp'

Telerivet은 Model Context Protocol (MCP) 서버를 제공하며, 이를 통해 AI 에이전트와 Claude 및 ChatGPT 같은 LLM 기반 도구가 표준 MCP 인터페이스를 사용하여 Telerivet REST API와 상호작용할 수 있습니다.

Telerivet의 MCP 서버를 사용하면 AI 에이전트가 Telerivet에서 메시지 전송 및 예약, 데이터와 사용 통계 조회, 연락처 가져오기, 프로젝트, 경로 및 자동화 서비스 구성 등 다양한 작업을 수행할 수 있습니다.

MCP 엔드포인트는 다음과 같습니다.

https://api.telerivet.com/mcp

MCP 클라이언트는 HTTP POST 요청을 통해 JSON-RPC 2.0 메시지를 사용하는 Streamable HTTP 전송 방식으로 연결합니다.

클라이언트 구성

MCP 엔드포인트에는 OAuth 2.0 인증이 필요합니다.

OAuth Client ID Metadata Documents (CIMD)를 지원하는 MCP 클라이언트는 수동 구성 없이 연결할 수 있습니다. 사용자가 처음으로 권한을 부여할 때 Telerivet이 자동으로 등록합니다. Telerivet은 Dynamic Client Registration을 지원하지 않습니다.

다음 MCP 클라이언트의 설정 안내를 확인할 수 있습니다.

• Claude (claude.ai 및 Claude Desktop)
• Claude Code
• ChatGPT
• Codex
• Antigravity CLI
• Hermes Agent

Client ID Metadata Documents를 지원하지 않는 MCP 클라이언트의 경우 OAuth Client를 수동으로 구성해야 합니다. CIMD를 지원하지 않는 다른 MCP 클라이언트를 사용하려면 Telerivet 조직에서 새 OAuth Client 추가를 선택하고 MCP 클라이언트에 필요한 OAuth 콜백 URL을 구성할 수 있습니다. (MCP 클라이언트를 제공하는 서비스의 문서에 OAuth 콜백 URL이 명시되어 있을 수 있습니다.) 이 방법으로 OAuth Client를 수동 구성하면 해당 클라이언트는 자체 Telerivet 조직 내 사용자만 사용할 수 있습니다.

MCP 클라이언트 승인

MCP 클라이언트를 연결하면 Telerivet으로 리디렉션되어 액세스를 승인하게 됩니다. 이 페이지에서 다음을 선택합니다.

• 권한 – 애플리케이션이 액세스할 수 있는 데이터 및 작업의 유형입니다(예: 메시지 보기, 메시지 전송 또는 자동화 서비스 편집). 애플리케이션에 부여하지 않으려는 권한은 선택 해제하세요. 애플리케이션은 사용자 계정에 허용된 범위를 넘어서는 작업을 수행할 수 없으며, 부여하지 않은 권한이 필요한 API 메서드는 MCP 클라이언트에 표시되지 않습니다.
• 조직 – 애플리케이션이 액세스할 수 있는 조직입니다. 각 승인은 하나의 조직에만 적용됩니다. 다른 조직에서 애플리케이션을 사용하려면 다시 연결하세요.

조직의 애플리케이션 승인. Claude 또는 ChatGPT와 같은 각 MCP 클라이언트는 조직에서 사용하기 전에 조직 관리자의 승인을 받아야 합니다. 조직 관리자인 경우 승인 페이지에서 조직에 대한 애플리케이션을 승인하고 이 애플리케이션을 사용할 수 있는 사용자를 선택할 수 있습니다. 선택지는 조직의 모든 사용자, 조직 관리자만, 또는 조직 및 프로젝트 관리자만입니다. 다른 사용자에게는 조직 관리자에게 애플리케이션 승인을 요청하라는 메시지가 표시됩니다.

액세스 취소. 계정 보안 설정의 승인된 애플리케이션 섹션에서 언제든지 애플리케이션의 계정 액세스를 취소할 수 있습니다. 조직 관리자는 OAuth 액세스 토큰 페이지에서 모든 사용자의 액세스 토큰을 검토하고 취소하거나, 연결된 애플리케이션 페이지에서 애플리케이션의 액세스를 완전히 취소할 수 있습니다.

조직 제어

조직 관리자는 연결된 애플리케이션 페이지(조직의 Developer API 페이지에서도 연결 가능)에서 승인된 각 MCP 클라이언트가 조직 내에서 수행할 수 있는 작업을 제어할 수 있습니다. 애플리케이션을 클릭하여 설정을 확인하거나 변경하세요. 이 설정은 사용자가 연결할 때 부여한 권한과 관계없이 조직 내 모든 사용자의 해당 애플리케이션 액세스에 적용됩니다.

필수 권한 – 조직에서 애플리케이션을 승인할 수 있는 사용자입니다(모든 사용자, 조직 관리자만, 또는 조직 및 프로젝트 관리자만).

허용된 작업 – 각 작업 범주에 대해 애플리케이션이 독립적으로 작업을 수행할 수 있는지, 사용자가 각 작업을 승인해야 하는지, 또는 작업이 전혀 허용되지 않는지를 설정합니다.

작업	설명	옵션	기본값
데이터 읽기	연락처, 메시지, 통계 및 기타 프로젝트 데이터를 조회합니다.	허용, 허용 안 함	허용
데이터 생성 및 업데이트	연락처, 그룹, 서비스, 초안 캠페인, 경로 및 기타 프로젝트 데이터를 생성하고 편집합니다.	허용, 승인 필요, 허용 안 함	허용
메시지 전송 및 서비스 트리거	연락처에 메시지와 통화를 전송하거나 예약하고, 자동화 서비스를 트리거하며, 스크립트를 실행합니다.	허용, 승인 필요, 허용 안 함	승인 필요
데이터 삭제	연락처, 메시지, 서비스 및 기타 프로젝트 데이터를 삭제합니다.	허용, 승인 필요, 허용 안 함	승인 필요
외부 웹 요청 수행	이 애플리케이션이 실행하는 스크립트에서 외부 웹사이트 및 타사 API에 요청을 보냅니다.	허용, 허용 안 함	허용

범주가 허용 안 함으로 설정되면 해당 MCP 도구(예: send_api 또는 delete_api)가 MCP 클라이언트에 표시되지 않으며, 해당 범주의 API 요청은 거부됩니다. run_script 도구에는 메시지 전송, 데이터 생성/업데이트, 데이터 삭제 중 가장 엄격한 설정이 적용됩니다.

일부 애플리케이션은 자체 기본값을 지정합니다. 예를 들어 사용자가 없는 상태에서 메시지를 전송해야 하는 자율 에이전트가 이에 해당합니다. 애플리케이션의 기본값이 표준 기본값과 다르면 연결된 애플리케이션 페이지의 해당 설정 옆에 애플리케이션의 기본값이 표시됩니다. 항상 조직 설정이 우선 적용됩니다.

허용된 권한 – 애플리케이션이 이 조직에서 액세스할 수 있는 데이터 및 작업의 유형입니다. 권한을 선택 해제하면 사용자가 애플리케이션에 해당 권한을 부여했더라도 조직 내 모든 애플리케이션 사용자의 관련 API 작업이 차단됩니다.

액세스 취소 – 조직의 승인된 애플리케이션 목록에서 애플리케이션을 제거하고 조직 내 해당 애플리케이션의 기존 액세스 토큰을 모두 취소합니다.

자체 조직이 소유한 애플리케이션(OAuth Client 추가를 통해 추가)은 승인이 필요하지 않으며, 허용된 작업은 애플리케이션 자체 설정 페이지에서 구성합니다.

사용자 확인 절차

연결된 애플리케이션 페이지에서 작업 범주를 승인 필요로 설정하면 사용자가 각 작업을 명시적으로 승인하기 전까지 MCP 클라이언트는 해당 작업을 수행할 수 없습니다. 기본적으로 이 설정은 메시지 전송 및 서비스 트리거, 데이터 삭제에 적용됩니다.

메시지 전송 범주에는 메시지와 통화 전송 또는 예약, 메시지 재전송, 자동화 서비스 트리거, 일괄 작업 생성, 수신 메시지 시뮬레이션, 예약된 메시지 또는 캠페인 편집, 자동화 서비스 활성화 또는 활성 서비스 구성 변경, 웹훅 생성 또는 웹훅 URL 변경, 경로의 전화번호 또는 제공업체 설정 변경, 프로젝트의 기본 경로 변경, run_script 도구를 사용한 스크립트 실행이 포함됩니다. 삭제 범주에는 모든 삭제 메서드와 프로젝트의 메시지 보존 기간 단축이 포함됩니다.

MCP 클라이언트에 따라 다음 방법 중 하나로 작업을 승인할 수 있습니다.

MCP 클라이언트의 승인 요청

MCP 클라이언트가 MCP elicitation을 지원하는 경우(MCP 프로토콜 버전 2026-07-28 이상 사용), 작업 내용과 영향을 받는 프로젝트를 일반 언어로 설명하는 승인 요청이 MCP 클라이언트에 표시됩니다. 승인하면 작업이 즉시 수행됩니다. 거부하면 작업이 수행되지 않으며 AI 모델에는 다시 시도하지 말라는 안내가 전달됩니다.

메시지 초안

MCP 클라이언트가 MCP Apps 확장 기능을 지원하는 경우 AI 모델은 draft_message 도구를 사용하여 수신자를 포함한 편집 가능한 문자 메시지 초안을 표시할 수 있습니다. 전송을 클릭하면 해당 메시지가 해당 수신자에게 전송되도록 승인됩니다.

승인 링크

MCP 클라이언트가 위 방법 중 어느 것도 지원하지 않거나 해당 방법으로 작업을 승인할 수 없는 경우, AI 모델은 Telerivet 웹 앱의 작업 승인 페이지 링크를 받으며 사용자에게 해당 페이지를 열도록 요청해야 합니다. 이 페이지에는 애플리케이션, 프로젝트, 작업 설명 및 전체 요청 세부 정보가 표시됩니다. 승인을 클릭한 후 MCP 클라이언트로 돌아가 다시 시도하도록 요청하세요.

작업을 승인하려면 해당 작업에 필요한 권한이 있어야 합니다(예: 프로젝트에서 메시지를 전송할 권한). 작업을 승인해도 애플리케이션에 추가 권한이 부여되지는 않습니다.

승인 작동 방식

• 각 승인은 정확히 하나의 요청, 즉 동일한 매개변수를 사용하는 동일한 API 메서드에만 적용되며 한 번만 사용할 수 있습니다. AI 모델이 요청 내용을 조금이라도 변경하면 다시 승인해야 합니다.
• 승인은 1시간 후 만료됩니다.
• run_script을 통해 승인한 스크립트가 수행하는 API 요청에는 별도의 승인이 필요하지 않습니다.
• 애플리케이션이 MCP를 통하지 않고 액세스 토큰으로 REST API를 직접 호출하면 승인이 필요한 요청은 오류 코드 confirmation_required와 함께 실패하며, 오류 메시지에 승인 링크가 포함됩니다. 서버 측 통합이나 자율 에이전트처럼 사용자가 없는 상태에서 이러한 작업을 수행해야 하는 애플리케이션은 조직 관리자에게 해당 범주를 허용으로 설정하도록 요청해야 합니다.

메시지 검토. 위 설정과 별개로 프로젝트의 메시지 설정에서 메시지 검토가 활성화되어 있으면, 구성된 한도를 초과하는 API 전송 메시지(MCP를 통한 메시지 포함)는 검토자가 승인할 때까지 보류 메시지로 유지됩니다. 이는 웹 앱에서 전송한 메시지와 동일하게 처리됩니다.

도구

현재 MCP 서버는 다음 도구를 제공합니다.

• list_api_methods – 이름, 설명, 매개변수 요약과 함께 사용 가능한 API 메서드를 나열합니다. 카테고리별 필터링을 지원합니다.
• get_method_schema – 특정 API 메서드의 전체 매개변수 스키마와 응답 필드 설명을 반환합니다.
• read_api – 데이터를 가져오기 위해 읽기 전용 API 메서드를 실행합니다.
• modify_api – 데이터를 생성하거나 업데이트하는 API 메서드를 실행합니다.
• delete_api – 데이터를 삭제하는 API 메서드를 실행합니다.
• send_api – 메시지를 보내거나 예약하거나 수신하고, 자동화된 서비스를 호출하거나 일괄 작업을 수행하는 API 메서드를 실행합니다.
• run_analysis_script – Telerivet의 Cloud Script API 샌드박스에서 읽기 전용 JavaScript를 실행해 프로젝트 데이터를 분석합니다. 집계, 엔터티 유형 간 조인, 또는 모델을 통해 모든 레코드를 페이지 단위로 가져오지 않고 다수의 레코드를 검색할 때 유용합니다. API 액세스는 읽기 전용이며 아웃바운드 HTTP는 비활성화되어 있습니다.
• run_script – Cloud Script API 액세스(읽기, 쓰기, 메시지 전송, HTTP 요청)를 사용해 JavaScript를 실행합니다. 개별 API 호출을 여러 번 해야 하는 대량 작업에 유용합니다. 스크립트가 수행하는 API 요청은 OAuth 토큰의 범위에 따라 확인되므로, 스크립트는 실행에 사용된 토큰이 허용하는 범위를 초과하는 작업을 수행할 수 없습니다.
• get_web_app_urls – 웹 앱 기능과 URL 패턴에 관한 정보를 반환합니다. AI 에이전트가 API에서 직접 사용할 수 없는 기능으로 연결되는 링크를 생성할 수 있습니다. 쿼리가 없으면 모든 페이지의 간결한 색인을 반환하고, 키워드나 URL 경로로 검색하면 일치하는 페이지의 전체 세부 정보를 반환합니다.
• draft_message – 하나 이상의 전화번호(또는 연락처 그룹)에 보낼 간단한 문자 메시지 초안을 작성하고, 전송 전에 사용자 승인을 요청합니다(메시지 초안 참조). MCP 클라이언트가 MCP Apps 확장을 지원하는 경우에만 사용할 수 있습니다.
• get_route_options – 사용 가능한 메시징 경로/채널 옵션에 관한 정보를 반환합니다. 국가, 채널 유형 또는 사용 사례별로 필터링하거나 특정 경로 유형을 조회하면 지리적 이용 가능성, 규정 준수 요건, 등록 절차, 결제 방식(내부/Telerivet 관리형 또는 외부/BYOC), 설정 일정, 가격을 포함한 전체 세부 정보를 반환합니다.
• skillbook_search / skillbook_get – 의도나 사용 사례에 맞는 일반적인 솔루션 패턴, 서비스, 캠페인 유형, 플랫폼 기능, 메시지 템플릿에 관한 정보를 반환합니다.
• search_documentation / get_documentation – 사용자 가이드 도움말 문서, 법률/정책 페이지, 개발자 API 문서, www.telerivet.com의 마케팅/회사 콘텐츠를 포함한 Telerivet 문서 모음에서 항목을 검색하고 가져옵니다.

MCP 서버가 제공하는 도구와 API 메서드는 시간이 지나면서 변경될 수 있습니다.

아래 링크에는 MCP 서버가 반환하는 JSON이 표시되어 있으며, 사용 가능한 도구와 API 메서드를 파악하는 데 도움이 될 수 있습니다.

• 도구 정의
• list_api_methods 도구의 출력
• Project_queryContacts 메서드에 대한 get_method_schema 도구의 출력 (다른 API 메서드의 스키마를 보려면 URL의 마지막 구성 요소를 바꾸세요.)
• Cloud Script API 참조에 대한 get_documentation 도구의 출력 (다른 문서 항목을 보려면 URL의 마지막 구성 요소를 바꾸세요.)

OAuth 토큰에 부여된 범위와 애플리케이션에 대한 조직의 제어 설정에 따라 사용할 수 있는 도구와 API 메서드가 결정됩니다. 토큰에 없는 범위가 필요한 메서드나 조직에서 애플리케이션에 허용하지 않는 메서드는 목록에서 제외됩니다.