Skip to main content
모델 컨텍스트 프로토콜(Model Context Protocol, MCP)로 AI 앱에서 vox.ai 도구를 호출할 수 있어요. 플러그인을 설치했다면 이 연결이 이미 들어 있어요.

​
준비물

원격 HTTP MCP와 OAuth 로그인을 지원하는 AI 앱과 작업할 워크스페이스에 접근할 수 있는 vox.ai 계정이 필요해요.

​
직접 연결하기

AI 앱의 MCP 서버 설정에 다음 주소를 추가하세요.
명령으로 연결하는 앱에서는 아래 방법을 쓰세요.
Claude Code에서 /mcp를 열고 vox-ai를 골라 로그인하세요.
Cursor, Claude Desktop, Claude Cowork, ChatGPT처럼 원격 MCP 서버를 추가할 수 있는 다른 AI 앱도 같은 방식으로 연결해요. 앱의 MCP 서버(커넥터) 추가 화면에서 위 주소를 직접 입력하고, 인증은 OAuth 로그인으로 진행하세요. 메뉴 위치와 이름은 앱과 버전마다 달라서 각 앱의 MCP 안내를 따르세요. 브라우저가 열리면 vox.ai 계정으로 로그인하세요. 이미 로그인돼 있으면 이 단계는 건너뛰어요. 이어서 요청한 앱 이름이 보이는 승인 화면에서 연결 승인을 누르세요. 워크스페이스를 고르는 단계는 없어요. 연결은 계정이 속한 모든 워크스페이스에서 쓸 수 있고, 처음에는 기본 워크스페이스로 시작해요. 다른 워크스페이스에서 작업하려면 아래 워크스페이스 전환하기를 따르세요. 계정에 허용된 권한으로 도구를 사용해요.

​
연결 확인

AI 앱에 다음과 같이 요청하고, 조회된 워크스페이스 이름을 확인하세요.

​
워크스페이스 전환하기

연결 하나는 한 번에 워크스페이스 하나에서 일해요. 다른 곳에서 작업하려면 대화에서 “다른 워크스페이스로 바꿔줘”처럼 요청하세요. AI 앱이 list_organizations로 대상을 찾고 set_organization으로 바꿔요. 전환해도 다시 연결할 필요는 없어요.
워크스페이스 전환은 같은 연결을 쓰는 모든 대화에 적용돼요. 다른 대화도 이후 호출부터 바뀐 워크스페이스에서 작업해요.
전환 뒤에는 에이전트와 번호를 다시 조회하세요. 이전 워크스페이스에서 읽은 ID를 그대로 쓰면 안 돼요.

​
도구로 작업하기

에이전트와 메뉴얼을 만들고 수정하거나, 버전을 저장·게시하고 보유 번호에 연결할 수 있어요. 통화 결과 조회와 실제 발신, 시트를 이용한 대량 발신도 지원해요. 전체 도구와 입력·실행 규칙은 MCP 도구에서 확인하세요. 공식 문서 검색도 연결하려면 https://docs.tryvox.co/mcp를 별도 서버로 추가하세요. 이 서버는 로그인이 필요 없어요. MCP를 쓰지 않는 AI에는 llms.txt나 문서 전체를 전달할 수 있어요.

​
문제가 생겼을 때

로그인한 계정이 맞는지 확인하고 워크스페이스의 오너나 관리자에게 권한을 요청하세요. 연결에는 제품 조회·수정 권한이 필요해요.
AI 앱에서 로그인을 처음부터 다시 시작하세요. 연결 화면을 오래 열어 두면 요청이 만료될 수 있어요.
AI 앱에서 MCP 로그인을 다시 시작하세요. vox.ai 로그인 세션은 최대 7일, 활동이 없으면 3일 뒤 만료돼요.
텍스트 채팅 시험에서는 종료와 API 도구만 실행되고, 주소 검색·통화 연결·에이전트 전환·문자 보내기·키패드 입력 같은 내장 도구는 실행되지 않아요. 내장 도구 동작은 음성 통화로 시험하세요.
같은 발신을 다시 요청하지 말고 통화나 대량 발신 상태를 먼저 조회하세요. 결과 확인 규칙에 따라 실행 여부를 확인해야 해요.

​
관련 문서