스크린샷을 Codex·Claude Code의 자료함으로: 로컬 MCP 설계

자료를 찾는 일을 에이전트에게 맡길 수 있습니다

캡처는 빠르게 저장하기 좋지만 나중에 맥락을 되살리는 데 시간이 듭니다. 자료함에서 관련 화면의 글자를 검색할 수 있으면 ‘랜딩 디자인 참고를 찾아 공통점을 정리해줘’, ‘지난번 저장한 에러 메시지를 찾아줘’처럼 질문할 수 있습니다.

Copy & Taste Agent Bridge 0.1은 이 흐름을 위한 별도 설치 미리보기입니다. 로컬 CLI와 표준 입출력 기반 MCP 서버를 제공합니다. 자체적으로 외부 AI API를 호출하지 않고, 연결된 Codex나 Claude Code가 반환된 자료를 해석합니다. 일반 사용자가 앱만 설치하면 자동으로 연결되는 기능은 아닙니다.

첫 번째 경계: 공유할 캡처를 사용자가 고릅니다

앱에서 이름이 정확히 ‘AI 자료함’인 컬렉션을 만들고 공유해도 되는 캡처만 넣습니다. 이 컬렉션 밖의 기록과 일반 클립보드 복사 항목은 읽기 결과에 포함하지 않습니다. 비밀번호 관리자에서 복사한 텍스트를 자동으로 자료함 전체와 함께 보내는 구조가 아닙니다.

브리지는 화면 캡처의 OCR 텍스트만 반환합니다. 원본 이미지, 이미지 파일 경로, 클립보드 전체를 조회하는 MCP 도구는 없습니다. OCR이 없는 이미지도 제외하므로 시각 자료를 모두 이해하는 이미지 검색 기능은 아닙니다.

두 번째 경계: 의심되는 항목을 통째로 제외합니다

OCR와 저장된 텍스트에서 비밀키 관련 단어, 알려진 토큰 형식, 인증 헤더, 긴 자격 문자열 등의 패턴을 검사합니다. 일부만 가리고 나머지를 반환하는 대신 항목 전체를 제외합니다. 검색어와 분류값에도 제한을 둡니다.

이 필터는 안전을 증명하지 않습니다. OCR이 비밀키를 잘못 읽거나 새로운 형식을 놓칠 수 있고, 반대로 공개된 개발 문서를 민감한 자료로 오인할 수도 있습니다. 사용자의 사전 검토와 제한된 컬렉션이 기본이고, 탐지는 보조 수단입니다.

세 번째 경계: 앱 기록은 읽기 전용입니다

브리지는 앱의 SQLite 저장소를 읽기 전용으로 엽니다. 스키마가 맞지 않거나 읽기에 실패하면 중단하며, 데이터를 복구한다는 이유로 초기화하지 않습니다. 분류는 디자인·코드·리서치·문서·영수증·기타 중 하나를 별도 권한 제한 파일에 기록합니다.

MCP 도구는 검색, 내용 읽기, 상태 확인, 분류만 제공합니다. 원본 삭제, 이미지 업로드, 임의 SQL 실행, 파일 실행, 웹 주소 방문 기능은 없습니다. 캡처 속 명령문은 참고 자료이며 에이전트가 따라야 할 지시가 아닙니다. 도구 설명만으로 프롬프트 인젝션을 완전히 막을 수 있는 것은 아닙니다.

연결한 뒤 이렇게 요청해 보세요

1. Agent Bridge를 설치하고 copytaste status로 공유 범위를 확인합니다. 처음에는 AI 자료함이 비어 있어도 정상입니다.
2. 민감정보가 없는 캡처 두세 개를 컬렉션에 넣습니다. 검색 결과가 의도한 자료인지 로컬에서 확인합니다.
3. Codex 또는 Claude Code에 로컬 MCP를 등록합니다. ‘copytaste에서 디자인 관련 자료를 찾아 요약해줘’로 시작합니다.
4. 분류가 필요하면 ‘공유된 캡처를 읽고 여섯 분류 중 알맞은 것으로 정리해줘’라고 요청합니다. 분류는 Agent Bridge 검색에 쓰이며 앱 컬렉션에는 반영되지 않습니다.

다운로드·CLI·MCP 설정 안내 ↗

로컬이라는 말의 범위를 확인하세요

브리지 자체는 네트워크 요청을 만들지 않습니다. 하지만 AI 클라이언트가 MCP 응답을 모델에 전달하면 그 텍스트는 해당 서비스의 데이터 처리 정책을 따릅니다. 이 기능은 에어갭 환경이나 무조건적인 비전송 보장을 제공하지 않습니다.

공유를 그만하려면 캡처를 AI 자료함에서 빼거나 MCP 연결을 제거하세요. 이후 요청에서는 새로 권한과 필터를 검사합니다. 이미 전송한 자료는 AI 서비스의 대화 기록이나 로그에 남을 수 있으므로 해당 서비스에서 별도로 관리해야 합니다.