> ## 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 MCP

> MCP를 지원하는 AI 앱을 vox.ai에 연결해 에이전트와 통화를 대화로 다룰 수 있어요.

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

## 준비물

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

## 직접 연결하기

AI 앱의 MCP 서버 설정에 다음 주소를 추가하세요.

```text theme={null}
https://mcp.tryvox.co/mcp
```

명령으로 연결하는 앱에서는 아래 방법을 쓰세요.

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http vox-ai https://mcp.tryvox.co/mcp
    ```

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

  <Tab title="Codex">
    ```bash theme={null}
    codex mcp add vox-ai --url https://mcp.tryvox.co/mcp
    codex mcp login vox-ai
    ```
  </Tab>

  <Tab title="Grok Build">
    ```bash theme={null}
    grok mcp add vox-ai https://mcp.tryvox.co/mcp
    ```

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

Cursor, Claude Desktop, Claude Cowork, ChatGPT처럼 원격 MCP 서버를 추가할 수 있는 다른 AI 앱도 같은 방식으로 연결해요. 앱의 MCP 서버(커넥터) 추가 화면에서 위 주소를 직접 입력하고, 인증은 OAuth 로그인으로 진행하세요. 메뉴 위치와 이름은 앱과 버전마다 달라서 각 앱의 MCP 안내를 따르세요.

브라우저가 열리면 vox.ai 계정으로 로그인하세요. 이미 로그인돼 있으면 이 단계는 건너뛰어요. 이어서 요청한 앱 이름이 보이는 승인 화면에서 **연결 승인**을 누르세요. 워크스페이스를 고르는 단계는 없어요.

연결은 계정이 속한 모든 워크스페이스에서 쓸 수 있고, 처음에는 기본 워크스페이스로 시작해요. 다른 워크스페이스에서 작업하려면 아래 [워크스페이스 전환하기](#워크스페이스-전환하기)를 따르세요. 계정에 허용된 권한으로 도구를 사용해요.

## 연결 확인

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

```text theme={null}
list_organizations로 접근할 수 있는 워크스페이스와 현재 연결 대상을 보여줘.
```

## 워크스페이스 전환하기

연결 하나는 한 번에 워크스페이스 하나에서 일해요. 다른 곳에서 작업하려면 대화에서 "다른 워크스페이스로 바꿔줘"처럼 요청하세요. AI 앱이 `list_organizations`로 대상을 찾고 `set_organization`으로 바꿔요. 전환해도 다시 연결할 필요는 없어요.

```text theme={null}
워크스페이스 목록에서 '예약 운영'을 찾아 그곳으로 전환해줘.
```

<Note>
  워크스페이스 전환은 같은 연결을 쓰는 모든 대화에 적용돼요. 다른 대화도 이후 호출부터 바뀐 워크스페이스에서 작업해요.
</Note>

전환 뒤에는 에이전트와 번호를 다시 조회하세요. 이전 워크스페이스에서 읽은 ID를 그대로 쓰면 안 돼요.

## 도구로 작업하기

에이전트와 메뉴얼을 만들고 수정하거나, 버전을 저장·게시하고 보유 번호에 연결할 수 있어요. 통화 결과 조회와 실제 발신, 시트를 이용한 대량 발신도 지원해요. 전체 도구와 입력·실행 규칙은 [MCP 도구](/docs/ai/mcp-reference)에서 확인하세요.

공식 문서 검색도 연결하려면 `https://docs.tryvox.co/mcp`를 별도 서버로 추가하세요. 이 서버는 로그인이 필요 없어요. MCP를 쓰지 않는 AI에는 [llms.txt](https://docs.tryvox.co/llms.txt)나 [문서 전체](https://docs.tryvox.co/llms-full.txt)를 전달할 수 있어요.

## 문제가 생겼을 때

<AccordionGroup>
  <Accordion title="연결할 워크스페이스가 없다고 나와요">
    로그인한 계정이 맞는지 확인하고 워크스페이스의 오너나 관리자에게 권한을 요청하세요. 연결에는 제품 조회·수정 권한이 필요해요.
  </Accordion>

  <Accordion title="연결 요청이 만료됐다고 나와요">
    AI 앱에서 로그인을 처음부터 다시 시작하세요. 연결 화면을 오래 열어 두면 요청이 만료될 수 있어요.
  </Accordion>

  <Accordion title="한동안 쓰다가 다시 로그인하라고 해요">
    AI 앱에서 MCP 로그인을 다시 시작하세요. vox.ai 로그인 세션은 최대 7일, 활동이 없으면 3일 뒤 만료돼요.
  </Accordion>

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

  <Accordion title="발신 결과가 unknown이에요">
    같은 발신을 다시 요청하지 말고 통화나 대량 발신 상태를 먼저 조회하세요. [결과 확인 규칙](/docs/ai/mcp-reference#안전하게-실행하기)에 따라 실행 여부를 확인해야 해요.
  </Accordion>
</AccordionGroup>

## 관련 문서

* [MCP 도구](/docs/ai/mcp-reference): 전체 도구와 저장·게시, 재시도 규칙
* [플러그인](/docs/ai/plugin): MCP 연결과 업무별 스킬을 함께 설치하기
* [워크스페이스 역할](/docs/workspace/roles): 계정 권한 확인


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