> ## 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. # MCP 도구 참조 > MCP 도구의 역할과 저장·게시, 실행 확인, 재시도 규칙을 확인할 수 있어요. 연결 방법은 [MCP](/docs/ai/mcp)에서 확인하세요. 아래는 외부 AI 앱에 공개된 도구와 실행 규칙이에요. 실제 입력 필드는 연결된 서버가 제공하는 도구 스키마에서 확인하세요. ## 저장과 게시 `save_agent`는 현재 설정을 저장해요. `create_agent_version`으로 현재 설정의 버전을 저장하고, `publish_agent_version`으로 저장한 버전을 프로덕션에 지정해요. 번호 연결은 `set_number_agents`로 따로 바꿔요. 자세한 동작은 [에이전트 버전 관리](/docs/build/versioning)에 있어요. ## 안전하게 실행하기 실제 전화 발신과 운영 설정 변경 전에는 대상과 내용을 확인하세요. 승인 화면과 도구 실행 방식은 사용하는 AI 앱의 설정을 따라요. * **실행 전 확인**: `place_call`의 전화 발신, `launch_campaign`·`resume_campaign`의 대량 발신 시작·재개, `publish_agent_version`의 게시 대상을 확인하세요. 플러그인의 스킬은 실행 전에 대상과 내용을 요약해 확인을 받도록 안내해요. 계획이나 준비를 요청한 것은 실행 승인이 아니에요. * **실행 키(`execution_key`)**: `place_call`, `launch_campaign`, `resume_campaign`에는 실행 키가 필요하고, `pause_campaign`과 `cancel_campaign`에서는 선택 사항이에요. 실행하려는 의도마다 새 키를 만들고, 같은 요청을 다시 보낼 때만 같은 키를 써요. 같은 키로 다시 호출하면 서버는 새로 실행하지 않고 앞선 결과를 돌려줘요. * **결과를 알 수 없을 때**: 응답이 `unknown`이면 자동으로 다시 실행하지 마세요. `get_call`, `list_calls`, `get_campaign`으로 실제 상태를 읽어 확인한 뒤, 더 실행할지는 사용자가 정해요. * **통화 원문과 비밀값**: `get_call`은 통화 원문을 기본으로 빼고, 요청할 때만 포함해요. `get_tool`과 `list_tools`의 인증 헤더 같은 비밀값은 가려져서 나와요. `place_call`은 실제 전화를 걸고 `launch_campaign`은 실제 대량 발신을 시작해요. 발신 요금이 발생할 수 있어요. 접수는 고객과 연결됐다는 뜻이 아니에요. 결과는 `get_call`이나 `get_campaign`으로 확인하세요. ## 공개 도구 목록 외부 AI 앱에 공개된 도구예요. 구분은 읽기만 하는 **조회**, 설정을 바꾸는 **저장**, 실제 영향이 큰 **실행**이에요. 연결한 계정의 권한에 따라 호출이 거절될 수 있어요. ### 워크스페이스 확인과 전환 | 도구 | 구분 | 하는 일 | | - | - | - | | `list_organizations` | 조회 | 접근할 수 있는 워크스페이스와 지금 연결된 워크스페이스를 보여 줘요. | | `set_organization` | 실행 | 이 연결이 일하는 워크스페이스를 바꿔요. 다시 연결할 필요는 없고, 같은 연결을 쓰는 모든 대화에 적용돼요. | | `get_organization` | 조회 | 연결된 워크스페이스의 기본 설정과 구독 요약을 읽어요. | | `update_organization` | 저장 | 연결된 워크스페이스의 설정을 수정해요. | | `list_organization_members` | 조회 | 연결된 워크스페이스의 멤버를 조회해요. | ### 모델과 입력 스키마 탐색 | 도구 | 구분 | 하는 일 | | - | - | - | | `list_models` | 조회 | 에이전트에 쓸 수 있는 LLM과 음성 모델 목록을 조회해요. | | `list_schemas` | 조회 | 에이전트 설정이 쓰는 입력 스키마 목록을 조회해요. | | `get_schema` | 조회 | 스키마 하나의 정확한 필드 정의를 읽어요. | ### 에이전트, 플로우, 버전 | 도구 | 구분 | 하는 일 | | - | - | - | | `list_agents` | 조회 | 이름과 필터로 에이전트를 찾고 에이전트 ID를 확인해요. | | `get_agent` | 조회 | 에이전트의 현재, 프로덕션, 저장된 버전의 설정을 읽어요. | | `save_agent` | 저장 | 에이전트를 만들거나 현재 설정을 수정해요. 게시는 따로 해요. | | `validate_flow` | 조회 | 플로우 에이전트의 노드와 연결을 저장하기 전에 검증해요. | | `list_agent_versions` | 조회 | 에이전트의 저장된 버전 목록을 조회해요. | | `create_agent_version` | 저장 | 현재 설정을 새 버전으로 저장해요. | | `publish_agent_version` | 실행 | 저장한 버전을 프로덕션에 반영해요. | ### 시작 템플릿 | 도구 | 구분 | 하는 일 | | - | - | - | | `list_agent_templates` | 조회 | 프롬프트 에이전트 시작 템플릿 목록을 조회해요. | | `get_agent_template` | 조회 | 템플릿 하나의 상세를 읽어요. | | `instantiate_agent_template` | 저장 | 템플릿으로 에이전트와 연결된 도구, 메뉴얼을 만들어요. 자동으로 게시하지 않아요. | ### 메뉴얼과 외부 연동 도구 | 도구 | 구분 | 하는 일 | | - | - | - | | `list_manuals` | 조회 | 에이전트에 속한 메뉴얼 목록과 현재 리비전을 조회해요. | | `get_manual` | 조회 | 메뉴얼의 전체 내용을 읽어요. | | `save_manual` | 저장 | 메뉴얼을 만들거나 수정해요. 읽어 둔 리비전을 함께 보내 충돌을 막아요. | | `list_tools` | 조회 | 에이전트가 통화 중에 호출하는 도구 목록을 조회해요. | | `get_tool` | 조회 | 도구의 설정과 입력 정의를 읽어요. 인증 헤더 같은 비밀값은 가려져요. | | `save_tool` | 저장 | 도구를 만들거나 수정해요. 도구를 실제로 호출하지는 않아요. | ### 지식 베이스 | 도구 | 구분 | 하는 일 | | - | - | - | | `list_knowledges` | 조회 | 지식 베이스 목록을 조회해요. | | `create_knowledge` | 저장 | 빈 지식 베이스를 만들어요. | | `list_knowledge_documents` | 조회 | 지식 베이스의 문서와 처리 상태를 조회해요. | | `import_knowledge_documents` | 저장 | 텍스트나 웹페이지 주소를 지식으로 등록해요. 파일 업로드는 지원하지 않아요. | | `delete_knowledge_document` | 실행 | 지식 베이스에서 문서 하나를 삭제해요. | ### 보이스 | 도구 | 구분 | 하는 일 | | - | - | - | | `create_voice_model` | 저장 | 동의받은 화자의 음성 파일 주소로 보이스를 만들어요. | ### 보유 전화번호 | 도구 | 구분 | 하는 일 | | - | - | - | | `list_numbers` | 조회 | 보유한 전화번호를 종류별로 조회해요. | | `get_number` | 조회 | 전화번호 하나의 상세와 상태를 읽어요. | | `update_number` | 실행 | 전화번호의 설정을 수정해요. | | `set_number_agents` | 실행 | 전화번호에 연결된 에이전트를 바꾸거나 연결을 해제해요. | ### 통화 조회와 발신 | 도구 | 구분 | 하는 일 | | - | - | - | | `list_calls` | 조회 | 통화 목록을 조건으로 찾아요. | | `get_call` | 조회 | 통화 한 건의 상태와 결과를 읽어요. 통화 원문은 요청할 때만 포함돼요. | | `place_call` | 실행 | 실제 전화를 걸어요. 실행 키가 필요해요. | ### 대량 발신 | 도구 | 구분 | 하는 일 | | - | - | - | | `list_campaigns` | 조회 | 대량 발신 목록과 상태를 조회해요. | | `get_campaign` | 조회 | 대량 발신의 설정과 진행 상태를 읽어요. | | `launch_campaign` | 실행 | 대량 발신을 만들고 바로 시작해요. 실행 키가 필요해요. | | `pause_campaign` | 실행 | 대량 발신의 남은 발신을 잠시 멈춰요. | | `resume_campaign` | 실행 | 멈춘 대량 발신을 다시 시작해요. 실행 키가 필요해요. | | `cancel_campaign` | 실행 | 대량 발신의 남은 발신을 취소해요. 이미 연결된 통화는 끊지 않아요. | ### 발신 대상 시트 | 도구 | 구분 | 하는 일 | | - | - | - | | `list_sheets` | 조회 | 시트 목록을 조회해요. | | `get_sheet` | 조회 | 시트의 발신 대상 행과 동적 변수를 읽어요. | | `create_sheet` | 저장 | 발신 대상과 동적 변수를 담은 시트를 만들어요. 발신은 시작하지 않아요. | ### 고객과 고객 속성 | 도구 | 구분 | 하는 일 | | - | - | - | | `list_customers` | 조회 | 고객을 검색해 고객 ID를 확인해요. | | `get_customer` | 조회 | 고객의 속성과 식별자를 읽어요. | | `find_customer` | 조회 | 전화번호 같은 식별자로 기존 고객을 찾아요. 없는 고객은 만들지 않아요. | | `save_customer` | 저장 | 고객의 속성과 식별자를 만들거나 수정해요. | | `resolve_customer` | 저장 | 식별자로 고객을 찾고, 없으면 새로 만들어요. | | `list_customer_attribute_definitions` | 조회 | 고객 속성 정의 목록을 조회해요. | | `get_customer_attribute_definition` | 조회 | 고객 속성 정의 하나를 읽어요. | | `save_customer_attribute_definition` | 저장 | 고객 속성 정의를 만들거나 수정해요. | 도구가 지원하지 않는 일도 있어요. 파일 업로드로 지식을 등록하는 것, 전화번호를 구하거나 해지하는 것, 음성으로 시험하는 것은 대시보드에서 해요. ## 오류와 예외 * **권한 오류**: 연결한 워크스페이스와 계정의 [역할](/docs/workspace/roles)을 확인하세요. * **실행 결과가 `unknown`**: 같은 요청을 다시 보내지 마세요. `list_calls`에서 받는 번호와 시작 시각으로 통화를 찾거나 `get_campaign`으로 대량 발신 상태를 확인하세요. * **워크스페이스 전환**: `set_organization`은 같은 연결을 쓰는 모든 대화에 적용돼요. 전환 뒤에는 리소스 ID를 다시 조회하세요. ## 관련 문서 * [MCP](/docs/ai/mcp): 직접 연결과 로그인 * [플러그인](/docs/ai/plugin): 업무별 스킬과 MCP 연결 설치 * [에이전트 버전 관리](/docs/build/versioning): 저장한 버전을 프로덕션에 지정하기 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.