조테로에 모아둔 논문, 이제AI에게물어봐요

중급자용© AIKOREACLUB

54yyyu/zotero-mcp

조테로에 모아 둔 논문, 이제 AI에게 물어봐요

논문 관리 프로그램 조테로의 내 서재를 클로드·챗GPT·클로드 코드와 이어 줘요. 논문을 찾고 읽고 하이라이트 치고 새 논문을 넣는 일까지 대화로 시켜요

★ 5,719MCP 서버 + 터미널 도구(zotero-cli) + 조테로 플러그인 · MIT확인 2026-11-03

조테로에 논문을 300편쯤 모아 두면 꼭 이런 순간이 와요. "어텐션이 순환 구조를 대체한 과정을 다룬 논문이 분명 있었는데, 어디 있더라." 제목이 기억 안 나면 태그를 뒤지고 PDF를 하나씩 열어야 하죠.조테로 MCP는 그 서재를 AI 비서에게 열어 주는 도구예요. 클로드나 챗GPT가 내 서재를 검색하고, PDF를 쪽 단위로 읽고, 답에 쪽 번호를 달아요. 조테로 안에 채팅 창을 붙이면 지금 읽고 있는 쪽과 드래그한 문장을 알고 답하고, 인용을 누르면 PDF의 그 문장이 바로 켜져요. 한 패키지에 MCP 서버, 터미널 도구, 조테로 플러그인 세 가지 길이 다 들어 있어요.

AI는 내 조테로 서재를 볼 수 없어요. 길은 세 갈래

내 조테로 서재에서 어텐션 다룬 논문 찾아 줘

죄송하지만 저는 사용자의 조테로 서재에 접근할 수 없어요. 논문 제목이나 초록을 붙여 넣어 주시면 도와드릴게요.연결 없이는 이렇게 끝나요. 서재는 내 컴퓨터에만 있으니까요.

조테로 MCP가 여는 길 세 갈래 · 눌러서 비교해 보세요

대화창에 미리 차지하는 토큰README 측정값

세 갈래 표와 토큰 수치는 README에 있는 것이고, 위 대화와 설명은 저희가 그린 예시예요. 토큰 수는 README가 cl100k_base 기준으로 다시 잰 값이라 모델에 따라 달라질 수 있어요.

한눈에

무엇인가요

세 가지 길. 첫째는 MCP 서버예요. 클로드 데스크톱이나 챗GPT처럼 MCP는 되지만 터미널이 없는 앱용이에요. 둘째는 zotero-cli와 에이전트 스킬이에요. 클로드 코드·코덱스·커서처럼 터미널을 쓸 줄 아는 에이전트에게 명령어 쓰는 법만 가르쳐요. 셋째는 Zotero Agent 플러그인이에요. 조테로 창 오른쪽에 채팅 패널이 생기고, 내 클로드 코드나 코덱스가 그 뒤에서 일해요.무엇을 하나요. 제목·저자·태그·전문·뜻으로 검색하고, 메타데이터·BibTeX·전문·쪽 범위를 읽어요. 수식이나 표가 깨지면 쪽 이미지로 봐요. 하이라이트와 영역 상자를 정확한 자리에 치고, 노트를 쓰고, DOI·URL·ISBN·BibTeX로 논문을 넣고, 컬렉션과 태그를 정리하고, 중복을 합쳐요.왜 길이 둘로 갈리나요. MCP 서버는 요청마다 도구 설명 약 1만 7천 토큰을 보내지만, 에이전트 스킬은 필요할 때까지 98토큰만 차지해요. 그래서 README는 터미널이 있는 에이전트에는 스킬을 권해요.

함께 쓰는 도구 · 클로드 데스크톱 · 챗GPT · 클로드 코드 · 코덱스 · 커서 · 윈드서프 · 제미나이 CLI · 체리 스튜디오 · 조테로 안 채팅 패널(Zotero Agent)

이런 분께

조테로에 논문이 수백 편 쌓여 있어 '그 논문 어디 있더라'가 잦은 대학원생·연구자
논문을 읽으며 AI에게 바로 묻고, 그 답을 조테로 노트로 남기고 싶은 분
클로드 코드로 문헌 조사 작업을 자동화하려는데 조테로가 끼어 있는 분

어떻게 작동하나요

로컬이 기본이에요. ZOTERO_LOCAL=true 로 두면 읽기는 내 컴퓨터의 zotero.sqlite 파일에서 바로 해요. 자격 증명이 없어도 돼요. 쓰기는 조테로 10 이상이면 한 번 허가해 로컬로 하고, 옛 버전은 웹 API 키로 해요.에이전트는 키를 먼저 찾아요. 스킬이 가르치는 순서는 '검색해서 항목 키를 얻고 → 그 키로 읽거나 고친다'예요. 긴 논문은 통째로 읽히지 않고 목차를 본 뒤 필요한 쪽만 읽게 해요. 빈 결과가 나오면 '논문이 없다'가 아니라 '색인이 아직 없다'일 수 있다는 것도 가르쳐요.조테로 안 채팅은 내 에이전트가 일해요. 플러그인은 모델을 직접 돌리지 않아요. 이미 로그인한 클로드 코드·코덱스·pi를 뒤에서 부르고, 열어 둔 항목·쪽·선택 글을 알려 줘요. 답의 인용은 zotero:// 링크라 누르면 그 쪽이 열려요.

할 수 있는 일

서재 검색제목·저자·태그·컬렉션·전문 검색에 더해, 뜻이 비슷한 논문을 찾는 의미 검색(로컬·OpenAI·제미나이·올라마 임베딩)도 돼요

쪽 단위로 읽기긴 PDF는 목차를 먼저 보고 필요한 쪽만 읽어요. 글자 추출이 깨진 수식·그림·표는 쪽 이미지로 봐요

하이라이트와 노트정확한 단어, 그림, 표, 수식 위에 하이라이트나 영역 상자를 치고 노트를 써요. 여러 개를 한 번에 계획해 쓰기 전에 어디 찍히는지 미리 볼 수 있어요

논문 넣기DOI, URL, ISBN, PubMed 번호, BibTeX, 파일로 논문을 추가해요. 이미 있으면 중복 대신 재사용해요

조테로 안에서 채팅지금 열어 둔 논문, 쪽, 선택한 글을 알고 답해요. 답을 조테로 노트로 저장하고 그림도 그려 줘요

인용 집계·철회 알림Scite 추가 기능을 설치하면 인용 수와 철회 여부를 함께 봐요(계정 필요 없음)

바로 쓸 수 있나요

도구 연결 필요

필요한 것조테로 7 이상(서재를 고치려면 10 이상), 파이썬 3.10 이상, 터미널. 그리고 MCP가 되는 AI 앱(클로드 데스크톱·챗GPT)이나 클로드 코드 같은 에이전트. 조테로 안 채팅은 Node.js와 클로드 코드·코덱스·pi 중 하나의 로그인이 더 필요해요

비용서버와 CLI는 무료(MIT), 조테로 플러그인은 AGPL-3.0. AI 쪽 요금(구독이나 API 키)은 따로예요. 의미 검색 임베딩은 로컬 모델이면 무료, OpenAI·제미나이면 요금이 나가요

시작하기

설치
파이썬 3.10 이상이 필요해요. pip install zotero-mcp-server 도 돼요. 터미널이 낯설면 커뮤니티가 만든 맥용 설치 프로그램(ehawkin/zotero-mcp-setup)을 README가 소개해요.
```
uv tool install zotero-mcp-server
```
조테로 로컬 API 켜기
조테로 7 이상에서 설정 → 고급(Advanced)으로 가서 '이 컴퓨터의 다른 프로그램이 조테로와 통신하도록 허용'에 체크해요.
클로드 데스크톱이라면
설정 파일을 자동으로 고쳐 줘요. 챗GPT, 체리 스튜디오 같은 다른 앱은 docs/getting-started.md를 봐요.
```
zotero-mcp setup
```
클로드 코드·코덱스·커서라면
프로젝트 폴더에서 실행하면 어떤 에이전트가 설정돼 있는지 찾아 각자 형식으로 스킬을 넣어요. 이미 있는 파일은 --force 없이는 덮어쓰지 않아요.
```
zotero-mcp install-skill
```
조테로 안에서 채팅하려면
플러그인 파일(.xpi) 위치를 알려 줘요. 조테로에서 도구 → 플러그인 → 톱니바퀴 → 파일에서 플러그인 설치로 넣어요. Node.js와 클로드 코드·코덱스·pi 중 하나가 로그인돼 있어야 해요.
```
zotero-cli plugin
```
서재를 고치게 하려면(선택)
조테로 10 이상에서 한 번 실행하고 '항상 허용'을 고르면 추가·하이라이트·태그 정리가 로컬로 돼요.
```
zotero-mcp authorize-local
```

처음 해 볼 한마디

Find papers in my library on attention mechanisms

README 예시 질문이에요. "이 논문의 핵심 결과를 요약해 줘", "이 PDF의 주요 주장을 하이라이트해 줘"도 예시로 나와요. 한국어로 물어도 되는지는 README에 적혀 있지 않아요.

처음 쓰는 순서

uv tool install zotero-mcp-server설치
조테로 설정 → 고급로컬 API 허용 체크
setup 또는 install-skill내 AI 앱에 맞는 길 고르기
검색부터"내 서재에서 ... 논문 찾아 줘"로 시험
db update의미 검색을 쓰려면 색인 만들기(semantic 추가 설치)
authorize-local하이라이트·노트까지 맡기려면 쓰기 허가

README의 빠른 시작과 CLI 문서를 처음 쓰는 순서로 묶었어요.

읽고 있는 논문에 묻고, 하이라이트까지

조테로 · Attention Is All You Need · 4 / 15쪽

3.2.1 Scaled Dot-Product Attention

Attention(Q, K, V) = softmax(QK^T / √d_k) V

the dot products grow large in magnitude, pushing the softmax function into regions where it has extremely small gradients

README의 화면과 CLI 문서의 명령을 따라 저희가 그린 예시예요. 질문과 답은 README 화면에 나온 내용을 우리말로 옮겼고, 논문 쪽은 선으로만 그렸어요. 실제 답과 명령은 쓰는 에이전트와 서재에 따라 달라져요.

비슷한 도구

조테로 MCP는 이미 있는 서재를 AI 손에 쥐여 주는 연결 도구이고, 아래 둘은 각각 질문 답하기와 번역을 맡는 도구예요(각 README 기준).

논문 더미에 물으면 몇 쪽인지까지 답해요조테로 대신 PDF 폴더를 읽고 답마다 논문·쪽 꼬리표를 붙이는 쪽Future-House/paper-qa

수식은 그대로, 글만 한국어로 바뀐 논문 PDF조테로 플러그인(zotero-pdf2zh)으로 서재의 논문을 통째로 번역하는 쪽PDFMathTranslate/PDFMathTranslate

주의할 점

AI가 단 출처는 반드시 원문을 열어 확인하세요. 답에 붙은 쪽 인용은 누르면 바로 열리니 그 자리에서 문장을 대조하는 습관이 필요해요.
플러그인 자체는 서버가 없고 아무것도 보내지 않지만, 내가 고른 에이전트는 자기 제공자(앤트로픽, OpenAI 등)에게 보내요. 메시지, 열어 둔 항목·쪽·선택 글, 논문 메타데이터(저자·학술지·DOI·초록·태그), 에이전트가 읽은 PDF 글까지요. 비공개 원고가 든 서재라면 이 점을 알고 쓰세요.
쓰기를 허가하면 AI가 서재를 고치고 지울 수 있어요(항목 삭제, 중복 병합 명령이 있어요). 되돌리기 어려우니 조테로 데이터 폴더를 백업해 두세요.
조테로 안 채팅의 에이전트는 패널에 갇히지 않아요. 터미널에서처럼 웹 검색, 셸 명령, 파일 읽기를 해요. 권한 모드를 '매번 묻기'로 두고, 스킬은 내가 쓰거나 믿는 것만 넣으라고 문서가 말해요.
라이선스가 둘이에요. MCP 서버와 zotero-cli는 MIT, 조테로 플러그인(plugin/)은 AGPL-3.0이에요.
며칠 켜 둔 조테로가 창은 멀쩡한데 로컬 API(포트 23119)만 멈출 수 있어요. 패널이 '응답 없음'이라고 하면 조테로를 다시 켜요.

낯선 말

조테로(Zotero) · 논문과 참고 문헌을 모아 두고 인용을 만들어 주는 무료 프로그램이에요
MCP · AI 앱이 바깥 도구를 같은 방식으로 부르게 하는 연결 규격이에요
에이전트 스킬 · 코딩 AI가 특정 일을 할 때 꺼내 읽는 지침 묶음이에요. 여기서는 zotero-cli 쓰는 법이에요
토큰 · AI가 글을 세는 단위예요. 대화창에 쌓일수록 비용이 늘고 기억할 자리가 줄어요
의미 검색 · 단어가 달라도 뜻이 비슷한 글을 찾는 검색이에요. 글을 숫자 벡터로 바꿔 비교해요
BibTeX·DOI · 참고 문헌을 적는 표준 형식과, 논문마다 붙는 고유 번호예요

AI 답은 참고 자료예요. 법·세금·돈·건강처럼 삶에 큰 영향을 주는 일에서는 AI 답이 정답이 될 수 없어요. 최종 판단은 전문가나 공식 기관에서 확인하세요.