> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# vox.ai 플러그인

> 코딩 에이전트에 vox.ai를 연결해 대화로 에이전트를 만들고 운영할 수 있어요.

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

## 준비물

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

## 설치하고 로그인하기

사용하는 앱의 탭을 골라 설치하고 로그인하세요.

<Tabs>
  <Tab title="Claude Code">
    Claude Code에서 다음 명령을 차례로 실행하세요.

    ```text theme={null}
    /plugin marketplace add https://github.com/vox-public/plugin.git
    /plugin install vox-ai@vox-ai
    /reload-plugins
    ```

    `/mcp`를 열고 `vox-ai`를 골라 로그인하세요.
  </Tab>

  <Tab title="Codex">
    터미널에서 다음 명령을 차례로 실행하세요. 마지막 명령이 로그인을 시작해요.

    ```bash theme={null}
    codex plugin marketplace add https://github.com/vox-public/plugin.git
    codex plugin add vox-ai@vox-ai
    codex mcp login vox-ai
    ```
  </Tab>

  <Tab title="Grok Build">
    터미널에서 플러그인을 설치하세요.

    ```bash theme={null}
    grok plugin install https://github.com/vox-public/plugin.git
    ```

    Grok Build에서 `/mcps`를 열고 `vox-ai`를 골라 로그인하세요.
  </Tab>
</Tabs>

브라우저에서 vox.ai 계정으로 로그인하세요. 이미 로그인돼 있으면 생략돼요. 이어서 요청한 앱 이름이 보이는 승인 화면에서 **연결 승인**을 누르세요. 워크스페이스를 고르는 단계는 없고, 처음에는 기본 워크스페이스로 시작해요. 문서 검색 연결은 로그인이 필요 없어요.

## 연결 확인

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

```text theme={null}
vox.ai에 연결된 워크스페이스를 확인하고 에이전트 목록을 보여줘.
```

## 업무 요청하기

목표와 확인할 결과를 함께 말하세요.

* **처음 만들기**: “치과 예약 안내 에이전트를 Single과 메뉴얼로 만들어줘. 초진 여부와 희망 시간을 확인하는 절차를 넣어줘.”
* **기존 메뉴얼 고치기**: “예약 안내 에이전트의 메뉴얼을 읽고 토요일 영업시간만 오후 2시로 바꿔줘. 바뀔 부분을 먼저 보여줘.”
* **통화 분석하기**: “어제 예약 안내 통화에서 같은 질문이 반복된 사례를 찾아 원인과 메뉴얼 수정안을 제안해줘.”

저장과 게시는 별도 작업이에요. 실제 전화 발신, 게시, 번호 연결 변경 전에는 [실행 규칙](/docs/ai/mcp-reference#안전하게-실행하기)에 따라 대상과 내용을 확인하세요.

## 스킬 사용하기

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

```text theme={null}
/vox-ai:voice-agent-design
치과 예약 안내 에이전트에 필요한 메뉴얼 구성을 잡아줘.
```

### 스킬 목록

플러그인에는 스킬 26개가 들어 있어요. 업무를 말로 요청하면 맞는 스킬이 자동으로 쓰이고, Claude Code에서는 `/vox-ai:스킬 이름`으로 직접 부를 수도 있어요.

**설계**

| 스킬 | 이럴 때 써요 |
| - | - |
| `voice-agent-design` | 에이전트의 목적·대상·완료 기준을 정하고 유형을 고를 때. 기본은 프롬프트 에이전트와 메뉴얼이고, 키패드 메뉴처럼 규칙이 분명한 업무만 플로우 에이전트를 골라요 |
| `manual-authoring` | 메뉴얼(업무 절차)을 처음부터 운영 수준으로 쓸 때. 단계·분기, 도구 호출과 실패 처리를 다뤄요 |
| `knowledge-grounding` | 홈페이지·문서·업무 자료를 에이전트의 지식으로 정리할 때 |
| `tool-integration-design` | 외부 API로 조회·예약·접수를 하도록 연동 방식과 실패 대응을 설계할 때 |
| `post-call-result-design` | 통화 후 추출할 항목과 업무 성공 기준을 정할 때 |
| `voice-interaction-design` | 모델·언어·목소리·응답 속도·끼어들기·무응답 대응을 정할 때 |

**만들기와 고치기**

| 스킬 | 이럴 때 써요 |
| - | - |
| `build-first-voice-agent` | URL·파일·설명으로 첫 에이전트를 만들고 메뉴얼·결과 저장·직접 시험까지 이어갈 때 |
| `explore-agent-context` | 기존 에이전트의 설정·메뉴얼·도구·버전을 파악할 때 |
| `edit-manual-safely` | 기존 에이전트를 이어서 고치거나 메뉴얼·프롬프트 일부를 바꿀 때 |
| `review-shared-impact` | 메뉴얼·지식·도구를 바꾸기 전에 영향 범위를 확인할 때 |
| `resume-agent-work` | 연결이 끊기거나 일부만 저장돼 멈춘 작업을 이어갈 때 |

**도구와 통화 결과**

| 스킬 | 이럴 때 써요 |
| - | - |
| `connect-agent-tools` | 외부 업무 API를 도구로 만들고 메뉴얼에 연결할 때 |
| `configure-call-results` | 통화 후 추출·결과 저장을 연결하거나 고칠 때 |
| `troubleshoot-agent-tool` | 통화 중 도구가 호출되지 않거나 오류가 날 때 원인을 좁힐 때 |

**번호와 발신**

| 스킬 | 이럴 때 써요 |
| - | - |
| `connect-phone-service` | 가진 번호를 에이전트에 연결·해제하고 수신을 확인할 때. 번호 구매·해지는 대시보드에서 해요 |
| `operate-outbound-and-followup` | 단건 발신과 시트 기반 대량 발신을 실행·중지·재개하고 결과를 확인할 때 |
| `configure-supporting-channel` | 채팅·위젯을 구성하거나 음성 업무를 보조 채널로 넓힐 때 |

**시험과 개선**

| 스킬 | 이럴 때 써요 |
| - | - |
| `prepare-voice-test` | 직접 음성으로 시험할 수 있게 준비하고 기대 결과를 정리할 때 |
| `try-and-improve-voice-agent` | 직접 말해 보고 피드백이나 실패 통화를 근거로 고쳐 다시 시험할 때 |
| `tune-voice-behavior` | 끼어들기·무응답·속도·언어·목소리·모델을 시험 결과로 조정할 때 |
| `inspect-call-evidence` | 특정 통화의 발화·도구·추출 결과로 실패 원인을 확인할 때 |
| `review-call-performance` | 일정 기간의 통화를 모아 개선 과제를 찾을 때 |

**작업 환경**

| 스킬 | 이럴 때 써요 |
| - | - |
| `agents-platform` | 연결된 워크스페이스와 쓸 수 있는 도구를 확인하고 작업을 시작할 때 |
| `product-documentation` | 공식 문서에서 기능·요금·사용법을 찾을 때 |
| `dashboard-navigation` | 대시보드의 설정 위치·통화 재생 같은 사용법을 안내받을 때 |
| `cli-authoring` | 에이전트를 파일·Git·CI로 관리하거나 CLI를 쓰겠다고 할 때 |

파일과 Git으로 작업할 때 쓰는 CLI의 로컬 지침은 [CLI](/docs/ai/cli#코딩-에이전트와-함께-쓰기)에서 따로 설정해요.

## 업데이트하기

* **Claude Code**: `/plugin marketplace update vox-ai`, `/plugin update vox-ai@vox-ai`를 차례로 실행하세요.
* **Codex**: `codex plugin marketplace upgrade`를 실행하세요.
* **Grok Build**: `grok plugin update`를 실행하세요.

업데이트한 뒤 앱 안내에 따라 다시 불러오고 새 대화에서 쓰세요.

## 문제가 생겼을 때

<AccordionGroup>
  <Accordion title="이전 vox-skills와 설치 이름이 겹쳐요">
    이전 플러그인과 마켓플레이스를 제거한 뒤 다시 설치하세요. 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`는 그대로 두세요.
  </Accordion>

  <Accordion title="설치했는데 도구가 보이지 않아요">
    앱을 최신 버전으로 업데이트하고 위 탭의 로그인 절차를 확인하세요. 로그인한 뒤 새 대화에서 서버 연결과 도구 목록을 확인하세요.
  </Accordion>

  <Accordion title="다시 로그인하라고 해요">
    설치할 때 쓴 앱의 MCP 로그인 절차를 다시 실행하세요. [로그인 안내](/docs/ai/mcp#문제가-생겼을-때)에서 세션 만료와 권한 문제를 확인할 수 있어요.
  </Accordion>

  <Accordion title="채팅으로 시험하면 주소 검색·연결·문자가 동작하지 않아요">
    텍스트 채팅 시험에서는 종료와 API 도구만 실행되고, 주소 검색·통화 연결·에이전트 전환·문자 보내기·키패드 입력 같은 내장 도구는 실행되지 않아요. 내장 도구 동작은 음성 통화로 시험하세요.
  </Accordion>

  <Accordion title="다른 워크스페이스에서 작업하고 싶어요">
    [워크스페이스 전환하기](/docs/ai/mcp#워크스페이스-전환하기)에 따라 대화에서 전환하세요. 다시 연결할 필요는 없어요. 같은 연결을 쓰는 다른 대화의 작업 대상도 함께 바뀌어요.
  </Accordion>
</AccordionGroup>

## 관련 문서

* [MCP](/docs/ai/mcp): 직접 연결과 워크스페이스 전환
* [MCP 도구](/docs/ai/mcp-reference): 도구 목록과 실행 규칙
* [CLI](/docs/ai/cli): 에이전트를 파일과 Git으로 관리하기


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.