하루 종일 막혔던 Zotero 연결, 포기하지 않고 뚫은 2주차 이야기

소개

결과표는 만드는데 논의(Discussion) 섹션으로 못 넘어가는 게 매번 병목이었다. 그래서 "결과표 + 참고문헌을 주면 연구질문별 논의 초안을 뽑아주는" Claude Skill을 만들기로 했고, 첫 단계로 논문 라이브러리 프로그램 Zotero를 Claude에 실시간 연결하려 했다. PRD 조사 때 확인한, 지금 기준 제일 쉬운 방법(Zotero MCP 설치 스크립트)이었다.

진행 방법

설치 스크립트 한 줄이면 끝날 줄 알았다.

powershell -ExecutionPolicy Bypass -File "$HOME\Downloads\install-zotero-mcp.ps1"

스크립트는 끝까지 돌았지만, http://localhost:23119/api/는 계속 ERR_EMPTY_RESPONSE. 하나씩 뒤졌다.

• Zotero 설정 → "다른 애플리케이션과 통신 허용" 체크 → 이미 켜져 있음

• Zotero 껐다 켜기 / 컴퓨터 재부팅 → 그래도 안 됨

• 포트가 실제 열렸는지 확인:

  netstat -ano | findstr 23119

→ 아무것도 안 나옴 (포트 자체가 안 열림)

• 백신(AhnLab V3) 개인 방화벽 확인 → 이미 꺼져 있음, 범인 아님

• Zotero 설정 편집기에서 httpServer.enabled, httpServer.port 값 확인 → 다 정상

• 윈도우 포트 예약 범위 확인:

  netsh int ipv4 show excludedportrange protocol=tcp

→ 23119는 해당 없음

전부 정상인데도 안 켜졌다. 진짜 원인은 Claude 앱의 "로컬 MCP 서버" 설정 화면에 있었다 — "추가된 서버가 없습니다". 스크립트가 설정 파일(claude_desktop_config.json)에 뭔가 썼다고 했지만, 열어보니 관련 내용이 아예 없었다. 지금 쓰는 Claude 앱(Cowork)은 스크립트가 가정한 옛날 방식(설정 파일 직접 편집)이 아니라 Desktop Extensions·커넥터 레지스트리 방식으로 외부 도구를 연결한다. 스크립트가 잘 돌아도, 이 앱은 애초에 그걸 읽을 방법이 없었다.

(여기에 Claude 앱의 "로컬 MCP 서버 없음" 설정 화면 스크린샷)

실시간 연결을 접고, 더 단순한 길로 방향을 바꿨다.

1. Zotero에서 내 라이브러리 선택

2. 파일 → 내보내기 라이브러리... → 형식 CSL JSON 선택

3. 저장한 파일을 Claude 채팅창에 드래그해서 첨부

끝. 논문 제목·저자·연도가 정확히 읽혔다.

(여기에 Zotero "내보내기" 화면, Claude 파일 첨부 화면 스크린샷)

결과와 배운 점

꿀팁 — 막혔을 때 확인 순서

1. 파일 확장자가 진짜 맞는지 (dir로 실제 이름 확인 — 숨겨져 있을 수 있음)
2. 로컬 서버면: netstat -ano | findstr [포트번호] 로 포트 개방 여부 확인
3. 그래도 안 되면: 이 방법이 "지금 쓰는 앱 버전"에 맞는지부터 의심

시행착오: 방화벽·백신·포트 다 정상인데도 안 되니 중간에 포기하고 싶었다. 다음 확인 지점을 하나씩 짚어가며 끝까지 붙잡으니 결국 뚫렸다. 조사한 "최신 방법"도 실제 쓰는 앱 버전과 안 맞을 수 있다는 걸 몸으로 배웠다. 조사만 믿지 말고 실제로 돌려보며 검증하는 게 중요하다.

앞으로 계획: 3주차엔 PDCA(계획→실행→점검→개선)를 익히고, 그 틀로 프로젝트("결과표+참고문헌 → 논의 초안 자동생성")의 다음 단계를 계획대로 만든다.

도움 받은 글 (옵션)

• zotero-mcp-setup — Zotero를 Claude에 연결하는 설치 스크립트·가이드

• zotero-mcp (원본 프로젝트)