--- title: "Nexus MCP 서버" slug: "nexus-mcp-server" updated: 2026-08-28T02:02:02Z published: 2026-08-28T02:02:02Z canonical: "helpcenter.autify.com/nexus-mcp-server" --- > ## Documentation Index > Fetch the complete documentation index at: https://helpcenter.autify.com/llms.txt > Use this file to discover all available pages before exploring further. # Nexus MCP 서버 Nexus MCP 서버는 Autify Nexus의 원격 워크스페이스를 **Model Context Protocol(MCP)**을 통해 다루기 위한 인터페이스입니다. Claude Desktop, Claude Code, Cursor와 같이 MCP를 지원하는 AI 클라이언트에서 연결하면 시나리오 작성과 편집, 테스트 플랜 실행, 실행 결과 분석과 같은 작업을 자연어로 수행할 수 있습니다. ## Model Context Protocol(MCP)이란 Model Context Protocol은 AI 어시스턴트가 외부 서비스나 데이터 소스를 안전하게 다룰 수 있도록 마련된 개방형 표준입니다. MCP를 지원하는 클라이언트와 MCP 서버(본 기능)가 표준화된 프로토콜을 통해 통신함으로써, AI가 다양한 작업을 대신 수행할 수 있습니다. ## Nexus MCP 서버로 할 수 있는 일 AI 클라이언트에서 Nexus MCP 서버에 연결하면 다음과 같은 작업을 수행할 수 있습니다. - 시나리오 생성, 검색, 조회, 업데이트, 아카이브, 복원 - 시나리오 내 스텝의 추가, 수정, 순서 변경, 삭제 - 테스트 플랜 생성, 조회, 업데이트, 실행, 취소, 아카이브, 복원 - 실행 결과 검색 및 상세 조회, 스텝 단위의 오류 정보·스크린샷·DOM 스냅샷 가져오기 - 워크스페이스 내 라벨 / 디렉터리 목록 가져오기 ## 제공되는 도구 목록 Nexus MCP 서버가 공개하는 도구(AI 클라이언트에서 호출 가능한 작업)는 다음과 같습니다. ### 워크스페이스 | 도구 | 용도 | | --- | --- | | `list_workspaces` | 접근 가능한 워크스페이스 목록을 가져옵니다. | | `read_directories` | 워크스페이스 내 디렉터리 목록을 가져옵니다. | | `read_labels` | 워크스페이스 내 라벨 목록을 가져옵니다. | | `create_label` | 레이블을 생성합니다. | | `rename_label` | 레이블 이름을 변경합니다. | | `delete_label` | 레이블을 삭제합니다. | | `apply_labels_to_scenarios` | 지정한 시나리오에 레이블을 적용합니다. | ### 워크스페이스 변수 | 도구 | 용도 | | --- | --- | | `list_workspace_variables` | 워크스페이스 변수 목록을 가져옵니다. | | `read_workspace_variables` | 지정한 워크스페이스 변수의 세부 정보를 가져옵니다. | | `create_workspace_variable` | 워크스페이스 변수를 생성합니다. | | `update_workspace_variable` | 워크스페이스 변수를 업데이트합니다. | | `delete_workspace_variable` | 워크스페이스 변수를 삭제합니다. | ### 시나리오 | 도구 | 용도 | | --- | --- | | `create_scenarios` | 자연어 스텝으로 여러 시나리오를 한 번에 생성합니다. | | `create_scenario` | 라벨, 디렉터리, 데이터 테이블 등의 메타데이터와 함께 단일 시나리오를 생성합니다. | | `search_scenarios` | 시나리오를 텍스트로 검색합니다. | | `read_scenarios` | UUID로 시나리오 상세 정보를 조회합니다. | | `update_scenarios` | 시나리오의 라벨, 디렉터리, 데이터와 같은 메타데이터를 업데이트합니다. | | `archive_scenarios` / `restore_scenarios` | 시나리오를 아카이브 또는 복원합니다. | | `query_scenario_history` | 시나리오 변경 이력을 가져옵니다. | | `load_scenario_revision` | 지정한 이력 버전의 시나리오 콘텐츠를 불러옵니다. | ### 시나리오 스텝 | 도구 | 용도 | | --- | --- | | `edit_scenario_steps` | 시나리오 내 스텝을 추가, 수정 또는 삭제합니다. | | `move_scenario_steps` | 시나리오 내 스텝의 순서를 변경합니다. | | `delete_scenario_steps` | 시나리오에서 스텝을 삭제합니다. | ### 공유 그룹 | 도구 | 용도 | | --- | --- | | `list_shared_groups` | 워크스페이스의 공유 그룹 목록을 가져옵니다. | | `read_shared_groups` | 공유 그룹의 메타데이터, 인수, 내부 스텝 및 참조된 시나리오를 가져옵니다. | | `extract_shared_group` | 일반 그룹 스텝을 새 공유 그룹으로 추출합니다. | | `inline_shared_group` | 시나리오 내의 공유 그룹 참조를 해당 시나리오 전용 일반 그룹으로 전개합니다. | | `delete_shared_groups` | 참조되지 않은 공유 그룹을 삭제합니다. | ### 저장된 검색 | 도구 | 용도 | | --- | --- | | `list_saved_searches` | 저장된 검색 목록을 가져옵니다. | | `create_saved_search` | 시나리오 검색 조건을 저장합니다. | | `delete_saved_search` | 저장된 검색을 삭제합니다. | ### 테스트 플랜 | 도구 | 용도 | | --- | --- | | `list_test_plans` | 테스트 플랜 목록을 가져옵니다(이름으로 필터링 가능). | | `read_test_plan` | UUID로 테스트 플랜의 구성과 대상 시나리오 목록을 조회합니다. | | `create_test_plan` | 실행 설정과 스케줄을 포함한 테스트 플랜을 생성합니다. | | `update_test_plan` | 테스트 플랜을 업데이트합니다. | | `execute_test_plan` | 테스트 플랜을 실행합니다. | | `cancel_test_plan_runs` | 실행 중인 테스트 플랜을 취소합니다. | | `archive_test_plans` / `restore_test_plans` | 테스트 플랜을 아카이브 또는 복원합니다. | ### 실행 결과 | 도구 | 용도 | | --- | --- | | `search_execution_results` | 상태, 플랫폼, 브라우저 등의 조건으로 실행 결과를 검색합니다. | | `read_execution_results` | 실행 결과 전체(시나리오별 결과와 스텝 상세)를 가져옵니다. | | `read_step_result` | 특정 스텝의 오류 상세, 스크린샷, 브라우저 로그를 가져옵니다. | | `read_step_result_dom_snapshot` | 스텝 실행 전후의 DOM 스냅샷(HTML)을 가져옵니다. | | `archive_execution_results` / `restore_execution_results` | 실행 결과를 아카이브 또는 복원합니다. | | `convert_natural_language_steps` | 실행 결과에 포함된 변환 가능한 자연어 스텝을 실행 시 생성된 성공한 노코드 스텝으로 변환합니다. | ## 관련 문서 - [Nexus MCP 서버에 연결하기](/v1/docs/ko/connect-to-nexus-mcp-server)