Windows에서 Claude가 내 로컬 파일을 검색하고 읽게 하는 법 (MCP 단계별 설정)
Claude는 기본적으로 내 컴퓨터의 파일을 볼 수 없습니다. Claude Desktop에게 지난 분기 단가표 파일을 찾아 달라고 하면 검색할 대상이 없습니다. Model Context Protocol(MCP)이 이 빈틈을 메웁니다: Claude가 내 PC에서 실행되는 도구를 호출하고, 그 도구가 검색을 합니다. 이 글은 LocalSynapse를 로컬 서버로 삼아 Windows에서 단계별로 설정합니다.
무엇이 필요한가요?
- Windows 10 또는 11(64비트). LocalSynapse는 macOS에서도 실행되지만 아래 경로는 Windows 기준입니다.
- Claude Desktop, Claude Code, 또는 로컬 서버를 실행할 수 있는 다른 MCP 클라이언트.
- LocalSynapse — 무료, 계정·로그인 불필요.
Claude Desktop을 내 로컬 파일에 어떻게 연결하나요?
- LocalSynapse를 설치합니다. 설치기는 현재 Windows 사용자용으로 설치하며 기본 경로는
%LOCALAPPDATA%\Programs\LocalSynapse\LocalSynapse.exe입니다. Windows 빌드는 코드 서명이 없어 Microsoft Defender SmartScreen 경고가 뜰 수 있습니다. 추가 정보 → 실행을 선택하세요. - 폴더를 색인하게 둡니다. LocalSynapse는 Word(.docx), Excel(.xlsx), PowerPoint(.pptx), PDF, HWP/HWPX, OpenDocument, RTF, HTML, 이메일(.eml, .msg), 일반 텍스트 파일을 읽습니다. 키워드 검색은 추가 다운로드 없이 됩니다. 의미 검색에는 선택 사항인 AI 모델(약 2.3GB)이 필요하며, 설치를 선택할 때만 내려받습니다.
- MCP 페이지에서 Claude Desktop 항목의 연결 버튼을 누릅니다. LocalSynapse가
%APPDATA%\Claude\claude_desktop_config.json에localsynapse항목을 씁니다. 파일에 있던 다른 MCP 서버는 그대로입니다. - Claude Desktop을 다시 시작합니다. 앱도 같은 안내를 띄웁니다: 새 서버는 Claude Desktop이 시작될 때 인식됩니다.
- 동작을 확인합니다. Claude에게 "LocalSynapse로 색인 상태를 확인해 줘"라고 물어보세요.
get_pipeline_status를 호출해 추출과 임베딩 진행 상황을 알려 줘야 합니다.
연결 버튼은 무엇을 쓰나요?
아래가 항목 전체입니다. command는 지금 실행 중인 LocalSynapse의 경로이고 MCP 페이지에 그 경로가 그대로 표시되므로, 직접 추가해도 됩니다:
{
"mcpServers": {
"localsynapse": {
"command": "C:\\Users\\사용자이름\\AppData\\Local\\Programs\\LocalSynapse\\LocalSynapse.exe",
"args": ["mcp"]
}
}
}
Claude Code에는 어떻게 추가하나요?
같은 MCP 페이지에 Claude Code용 명령과 복사 버튼이 있습니다. 형태는 claude mcp add localsynapse -- "<LocalSynapse.exe 경로>" mcp이고 경로가 이미 채워져 있습니다. 터미널에 붙여 넣으세요. 되돌리는 claude mcp remove localsynapse도 표시됩니다.
Cursor, Cline 등 다른 MCP 클라이언트는요?
로컬(stdio) MCP 서버를 실행할 수 있는 클라이언트라면 같습니다: command는 LocalSynapse.exe, 인자는 mcp 하나입니다. 클라이언트가 필요할 때 LocalSynapse를 백그라운드로 실행하므로 LocalSynapse 창을 열어 둘 필요가 없습니다. 일반 참고는 MCP 연동 페이지에, 다른 클라이언트의 설정 예는 Hermes Agent 가이드에 있습니다.
연결되면 Claude는 무엇을 할 수 있나요?
Claude는 9개 도구를 받습니다:
search_files— 문서 안에 적힌 내용을 검색합니다(키워드 검색과 의미 검색 결합). 일치 구절과 문서 내 위치를 돌려줍니다.get_file_content— 색인된 파일의 추출 텍스트를 한 번에 최대 20개까지 읽습니다.list_indexed_files— 색인된 파일을 폴더·확장자·추출 상태로 걸러 나열합니다.get_pipeline_status— 색인 진행 상황.get_spreadsheet— .xlsx 통합 문서를 셀·타입·병합 영역으로 (자세히).get_email_thread— 색인된 이메일의 상위 메일과 답장, 오래된 순.get_timeline,get_work_session— 기간 내, 또는 특정 파일·시점 주변의 파일 변경과 메일 도착.preview_index_removal— 색인 정리가 무엇을 고를지 보여 주는 읽기 전용 미리 보기.
전형적인 흐름: "협력사 계약서에 해지 통보 기간이 뭐라고 돼 있었지?"라고 물으면 Claude가 search_files로 계약서 PDF의 해당 구절을 찾아, 어느 파일에서 왔는지와 함께 답합니다.
문제 해결
- Claude에 도구가 안 보입니다. 연결 후 Claude Desktop을 다시 시작했는지, 위 설정 파일에
localsynapse항목이 있는지 확인하세요. - 예전에 등록했는데 MCP 페이지가 "Not connected"라고 합니다. 페이지는 지금 실행 중인 LocalSynapse를 가리키는 항목만 연결됨으로 셉니다. 연결 버튼을 다시 눌러 갱신하세요.
- 검색 결과가 비어 있습니다. Claude에게
get_pipeline_status를 실행하게 하세요. 색인이 아직 그 파일까지 못 갔을 수 있습니다. 클라우드에만 있는 파일(예: OneDrive "온라인 전용" 파일)은 건너뜁니다 — 이유와 해결법.
LocalSynapse가 하지 않는 것
- 도구 결과를 어시스턴트 제공사로부터 숨기지 않습니다. 파일은 업로드되지 않지만, Claude가 도구로 읽은 내용은 대화의 일부가 됩니다. 무엇이 로컬에 남고 무엇이 나가는지와 개인정보 페이지를 참고하세요.
- 클라우드 전용 자리표시자 파일은 내려받지 않고 건너뜁니다.
- OCR이 없습니다. 텍스트 층이 없는 스캔 PDF는 색인할 내용이 없습니다.
- 구형 .doc, .xls, .ppt는 내용 색인 대상이 아닙니다.
- Windows와 macOS만 지원합니다. Windows 빌드는 코드 서명이 없고, macOS 빌드는 Apple 서명이 없습니다.
- CPU에서 실행됩니다. GPU는 필요하지도, 쓰지도 않습니다.