로컬 MCP로 관리

Claude, Codex 등 MCP를 지원하는 AI 앱에서 Secure Pipes를 사용하여 저장된 설정과 연결 활동을 조회하고 허용된 범위에서 연결 및 설정을 관리할 수 있습니다.

활성화 및 연결

자동화 → 로컬 MCP에서 활성화하고 클라이언트 형식을 선택하여 설정을 복사합니다. 실행 파일이나 socket 경로를 추측하지 말고 현재 설치에서 생성한 설정을 쓰세요. AI 클라이언트를 다시 연결하고 앱을 실행·잠금 해제 상태로 유지합니다. 저장된 설정이 없으면 로컬 MCP는 기본적으로 켜집니다. 기존 켜짐/꺼짐 설정은 유지됩니다. Pro 또는 유효한 체험이 필요합니다.

권한과 자격 증명

저장된 변경 권한이 없으면 기본적으로 수동 승인이 필요합니다. 기존 권한 설정은 유지됩니다. 허용 안 함, 수동 승인, 자동 승인을 선택하면 저장됩니다. 수동 승인은 앱에서 확인하며 자동 승인은 지원되는 변경을 개별 확인 없이 허용합니다. 저장된 암호·개인 키 경로 등은 읽지 못하며 암호와 키 경로를 쓸 수도 없습니다. 앱에서 설정하세요. 지원되는 생성 도구는 사용자 이름과 인증 활성화를 지정할 수 있습니다.

조회·진단·일괄 생성

연결, 모든 매핑, 프록시, 규칙, 시나리오, 앱, 그룹, 서비스 상태, 활성 프록시/공유 연결 및 지원되는 일반/DNS 설정을 조회합니다. 메모리의 최근 로그 메타데이터 분석은 단서일 뿐 원인 확정이 아닙니다. 변경 권한으로 연결/그룹 시작·중지, 시나리오 전환, 순서/즐겨찾기와 지원 서비스 및 작업을 관리합니다. 실행 중 앱의 실제 도구 정의를 따르세요.

프록시, SSH 사전 설정 호스트, 로컬/원격 전달, SOCKS, 규칙, 시나리오는 요청당 최대 128개를 생성합니다. 전달 프로필은 여러 매핑을 포함할 수 있습니다. 앱 규칙을 만들기 전에 관련 식별자를 모두 읽고 bundle ID를 추측하지 마세요. 인증은 앱에서 완성합니다.

연결 상세 정보와 스크립트 참조

list_connections의 UUID로 get_connection_detail을 호출합니다: {"id":"CONNECTION-UUID"}. mappingCount와 전체 순서의 mappings에는 비활성 행도 포함됩니다. local_forward, remote_forward, socks, reverse_socks와 수신/대상 측, 주소, 포트, 활성 상태를 반환합니다. SOCKS 대상은 동적입니다. 메모, 사용자 SSH 텍스트, 매핑 비고도 반환하므로 비밀을 넣지 마세요. 저장된 자격 증명 필드는 제외됩니다.

get_automation_reference로 색인 후 섹션이나 명령을 검색합니다. 예: {"interface":"spcli","query":"open-remote-desktop","language":"ko"}. nextOffset으로 이어서 읽습니다. 현재 빌드의 설명과 예제만 제공하며 스크립트를 실행하지 않습니다. 연결 상태, DNS 실패 요약, 시작·준비 대기·실패 처리 스크립트를 요청해 보세요.

문제 해결

앱 실행, MCP 스위치, 잠금, 라이선스, 클라이언트의 설치 경로를 확인하세요. 업데이트 후 재연결/도구 새로 고침으로 이전 브리지와 캐시를 바꿉니다. Transport closed는 클라이언트 연결을 재시작해야 할 수 있습니다. 닫힌 전송을 반복 시도해도 복구되지 않습니다. MCP 로그를 확인하고 개인 설정·메모·로그는 공개하지 마세요.