하루 종일 막혔던 Zotero 연결, 포기하지 않고 뚫은 2주차 이야기
2026.08.06
소개
결과표는 만드는데 논의(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 서버 없음" 설정 화면 스크린샷)
실시간 연결을 접고, 더 단순한 길로 방향을 바꿨다.
Zotero에서 내 라이브러리 선택
파일 → 내보내기 라이브러리... → 형식 CSL JSON 선택
저장한 파일을 Claude 채팅창에 드래그해서 첨부
끝. 논문 제목·저자·연도가 정확히 읽혔다.
(여기에 Zotero "내보내기" 화면, Claude 파일 첨부 화면 스크린샷)
결과와 배운 점
Before (실시간 연결) | After (파일 내보내기) | |
|---|---|---|
소요 시간 | 몇 시간 | 5분 미만 |
결과 |
| 논문 제목·저자·연도 정확히 확인 |
목표 달성 | 실시간 연결 실패 | 참고문헌 연결 목표는 달성 |
꿀팁 — 막혔을 때 확인 순서
1. 파일 확장자가 진짜 맞는지 (dir로 실제 이름 확인 — 숨겨져 있을 수 있음)
2. 로컬 서버면: netstat -ano | findstr [포트번호] 로 포트 개방 여부 확인
3. 그래도 안 되면: 이 방법이 "지금 쓰는 앱 버전"에 맞는지부터 의심시행착오: 방화벽·백신·포트 다 정상인데도 안 되니 중간에 포기하고 싶었다. 다음 확인 지점을 하나씩 짚어가며 끝까지 붙잡으니 결국 뚫렸다. 조사한 "최신 방법"도 실제 쓰는 앱 버전과 안 맞을 수 있다는 걸 몸으로 배웠다. 조사만 믿지 말고 실제로 돌려보며 검증하는 게 중요하다.
앞으로 계획: 3주차엔 PDCA(계획→실행→점검→개선)를 익히고, 그 틀로 프로젝트("결과표+참고문헌 → 논의 초안 자동생성")의 다음 단계를 계획대로 만든다.
도움 받은 글 (옵션)
로그인하고 댓글을 남겨 주세요
ERR_EMPTY_RESPONSE를 계속 붙잡다가 결국 “이 방법이 지금 쓰는 Claude 앱 버전에 맞나?”로 질문을 바꾼 지점이 좋았습니다. 포트, 백신, Zotero 설정을 다 확인했는데도 안 되면 보통 더 세게 밀어붙이기 쉬운데, 여기서는 실시간 연결을 잠깐 내려놓고 CSL JSON 내보내기로 목표를 먼저 달성했잖아요. 연구 도구 연결은 멋진 자동화보다도, 막혔을 때 5분짜리 우회로를 남겨두는 게 꽤 중요하다는 걸 보여준 사례 같았습니다.



![[Paseo] 비개발자가 AI 여러 개를 한 화면에서 부리는 환경을 직접 세팅한 기록 -원격 작업 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2Fa6f1e9bbc41a64afa8f026f7.jpg&w=3840&q=75)
설치 스크립트가 끝까지 돌면 됐다고 보게 됩니다. 에러도 없었으니까요. 그다음부터는 내 쪽 설정을 의심하기 시작하고요.
박정미님이 하루를 보내신 데가 딱 거기였습니다. 조테로 설정도 켜져 있고, 재부팅도 했고, 백신도 꺼져 있었는데 포트가 닫혀 있었고요. 확인할 게 남지 않죠. netstat에 아무것도 안 뜨는 화면이 제일 막막했겠습니다.
스크립트는 끝까지 돌았는데 설정 파일을 열어보니 관련 내용이 아예 없었다는 대목이 제일 무서웠어요. 신호가 거짓이었네요. 잘 돌았다는 표시와 실제로 뭐가 쓰였는지는 따로 봐야 하는 거였고요. 스크립트가 가정한 방식과 지금 앱이 쓰는 방식이 달랐던 거니까요.
꿀팁 첫 줄에 파일 확장자가 진짜 맞는지 dir로 확인하라고 적어두신 것도 좋았습니다. 안 보이는 함정이네요. 3주차에 PDCA로 다시 붙으시는 이야기 기다리겠습니다.