Skip to main content
vox.ai 플러그인은 제품을 다루는 vox-ai MCP 연결, 공식 문서를 검색하는 vox-docs, 업무별 스킬을 함께 설치해요.

​
준비물

작업할 워크스페이스에 접근할 수 있는 vox.ai 계정과 플러그인을 지원하는 최신 Claude Code·Codex·Grok Build가 필요해요.

​
설치하고 로그인하기

사용하는 앱의 탭을 골라 설치하고 로그인하세요.
Claude Code에서 다음 명령을 차례로 실행하세요.
/mcp를 열고 vox-ai를 골라 로그인하세요.
브라우저에서 vox.ai 계정으로 로그인하세요. 이미 로그인돼 있으면 생략돼요. 이어서 요청한 앱 이름이 보이는 승인 화면에서 연결 승인을 누르세요. 워크스페이스를 고르는 단계는 없고, 처음에는 기본 워크스페이스로 시작해요. 문서 검색 연결은 로그인이 필요 없어요.

​
연결 확인

새 대화에서 다음과 같이 요청하세요. 연결한 워크스페이스 이름과 에이전트 목록이 맞는지 확인하세요.

​
업무 요청하기

목표와 확인할 결과를 함께 말하세요.
  • 처음 만들기: “치과 예약 안내 에이전트를 Single과 메뉴얼로 만들어줘. 초진 여부와 희망 시간을 확인하는 절차를 넣어줘.”
  • 기존 메뉴얼 고치기: “예약 안내 에이전트의 메뉴얼을 읽고 토요일 영업시간만 오후 2시로 바꿔줘. 바뀔 부분을 먼저 보여줘.”
  • 통화 분석하기: “어제 예약 안내 통화에서 같은 질문이 반복된 사례를 찾아 원인과 메뉴얼 수정안을 제안해줘.”
저장과 게시는 별도 작업이에요. 실제 전화 발신, 게시, 번호 연결 변경 전에는 실행 규칙에 따라 대상과 내용을 확인하세요.

​
스킬 사용하기

스킬은 에이전트 설계, 메뉴얼 수정, 번호 연결과 통화 분석을 어떤 순서로 처리할지 알려 주는 지침이에요. 코딩 에이전트가 요청에 맞는 스킬을 골라 써요. Claude Code에서는 아래처럼 직접 호출할 수도 있어요. Codex와 Grok Build에서는 설치된 스킬을 고르거나 업무를 말로 요청하세요.

​
스킬 목록

플러그인에는 스킬 26개가 들어 있어요. 업무를 말로 요청하면 맞는 스킬이 자동으로 쓰이고, Claude Code에서는 /vox-ai:스킬 이름으로 직접 부를 수도 있어요. 설계 만들기와 고치기 도구와 통화 결과 번호와 발신 시험과 개선 작업 환경 파일과 Git으로 작업할 때 쓰는 CLI의 로컬 지침은 CLI에서 따로 설정해요.

​
업데이트하기

  • Claude Code: /plugin marketplace update vox-ai, /plugin update vox-ai@vox-ai를 차례로 실행하세요.
  • Codex: codex plugin marketplace upgrade를 실행하세요.
  • Grok Build: grok plugin update를 실행하세요.
업데이트한 뒤 앱 안내에 따라 다시 불러오고 새 대화에서 쓰세요.

​
문제가 생겼을 때

이전 플러그인과 마켓플레이스를 제거한 뒤 다시 설치하세요. Claude Code는 /plugin uninstall vox-ai@vox-ai와 /plugin marketplace remove vox-ai, Codex는 codex plugin marketplace remove vox-ai, Grok Build는 grok plugin uninstall vox-ai와 grok plugin marketplace remove vox-ai를 실행하세요. npx skills add로 설치한 스킬은 해당 설치 위치에서 제거하고, CLI가 관리하는 .claude/skills/vox-ai와 .codex/skills/vox-ai는 그대로 두세요.
앱을 최신 버전으로 업데이트하고 위 탭의 로그인 절차를 확인하세요. 로그인한 뒤 새 대화에서 서버 연결과 도구 목록을 확인하세요.
설치할 때 쓴 앱의 MCP 로그인 절차를 다시 실행하세요. 로그인 안내에서 세션 만료와 권한 문제를 확인할 수 있어요.
텍스트 채팅 시험에서는 종료와 API 도구만 실행되고, 주소 검색·통화 연결·에이전트 전환·문자 보내기·키패드 입력 같은 내장 도구는 실행되지 않아요. 내장 도구 동작은 음성 통화로 시험하세요.
워크스페이스 전환하기에 따라 대화에서 전환하세요. 다시 연결할 필요는 없어요. 같은 연결을 쓰는 다른 대화의 작업 대상도 함께 바뀌어요.

​
관련 문서

  • MCP: 직접 연결과 워크스페이스 전환
  • MCP 도구: 도구 목록과 실행 규칙
  • CLI: 에이전트를 파일과 Git으로 관리하기