> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crazyrouter.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Zotero 설정 가이드
> Zotero에서 OpenAI 호환 인터페이스를 지원하는 AI 플러그인을 통해 Crazyrouter를 연동하고, 직접 연동 가능한 플러그인과 불가능한 플러그인 유형을 명확히 구분합니다
> 업데이트: 2026-06-06
Zotero 자체는 문헌 관리 도구이며, Crazyrouter 설정 진입점을 직접 내장하고 있지 않습니다. 실제 연동 방식은 일반적으로: 먼저 AI 호출을 지원하는 Zotero 플러그인을 설치한 뒤, 해당 플러그인에서 Crazyrouter의 OpenAI 호환 주소, API 키, 모델명을 입력하는 것입니다.
이 페이지에서 가장 중요한 원칙은 "아무 Zotero AI 플러그인이나 골라서 연동할 수 있다"가 아니라, 먼저 플러그인 유형을 구분하는 것입니다:
* 직접 연동 가능: 플러그인이 `Base API URL` / `API URL` / `Endpoint` 사용자 지정을 지원함
* 직접 연동 불가능 또는 공개 메인 경로로 부적합: 플러그인이 공식 OpenAI 키 입력만 지원하며, 사용자 지정 업스트림 주소 입력 항목이 없음
## 먼저 결론부터
Zotero에서 Crazyrouter를 사용하는 공개 권장 연동 방법은 다음과 같습니다:
* 사용자 지정 OpenAI 호환 주소를 지원하는 Zotero AI 플러그인을 선택합니다
* 기본 주소를 `https://api.crazyrouter.com/v1`로 입력합니다
* API 키를 `sk-xxx`로 입력합니다
* 첫 번째 검증 모델은 `gpt-5.5`를 사용합니다
모든 Zotero AI 플러그인이 사용자 지정 업스트림 주소를 지원하는 것은 아닙니다. 어떤 플러그인이 "OpenAI API 키 입력" 항목만 있고 `Base URL` 또는 `API URL` 설정이 없다면, 이 플러그인은 일반적으로 요청을 Crazyrouter로 직접 전환할 수 없습니다. 이런 플러그인은 공개 기본 가이드로 사용하지 않아야 합니다.
## 왜 이렇게 작성했는가
현재 Zotero AI 플러그인 생태계는 편차가 크기 때문입니다:
* Zotero 공식 문서에 따르면, 플러그인은 커뮤니티 생태계이며 설치 방식은 통일되어 있지만 기능은 통일되어 있지 않습니다
* 일부 플러그인은 사용자 지정 `base API URL`을 명확히 지원합니다
* 일부 플러그인의 공개 문서에는 `OpenAI API Key` 입력만 기재되어 있습니다
따라서 Crazyrouter 공개 문서에서는 사용자가 "사용자 지정 OpenAI 호환 주소를 지원하는" 플러그인을 선택하도록 우선 안내해야 하며, 모든 플러그인이 기본적으로 직접 연동 가능하다고 가정해서는 안 됩니다.
## 이런 분들께 적합합니다
* Zotero에서 논문 요약, 번역, 질의응답을 하고 싶은 사용자
* 문헌 읽기와 Crazyrouter 모델 호출을 하나의 워크플로에 통합하고 싶은 분
* 문헌 항목, PDF 읽기, 노트 정리 과정에 AI 보조를 추가하고 싶은 분
* 스크립트를 직접 작성하지 않고, Zotero의 그래픽 인터페이스에서 바로 설정을 완료하고 싶은 분
## 사전 준비 조건
| 항목 | 설명 |
| -------------- | ----------------------------------------------------- |
| Crazyrouter 계정 | 먼저 [crazyrouter.com](https://crazyrouter.com)에서 가입합니다 |
| Crazyrouter 토큰 | Zotero용으로 별도의 토큰을 생성하는 것을 권장합니다 |
| Zotero 데스크톱 버전 | 플러그인은 주로 데스크톱에서 실행됩니다 |
| AI 플러그인 | 사용자 지정 OpenAI 호환 주소 지원이 필요합니다 |
| 문헌 또는 PDF | 테스트할 항목을 최소 1개 준비합니다 |
첫 라운드에는 다음만 허용하는 것을 권장합니다:
* `gpt-5.5`
* `claude-opus-4-8`
* `gemini-3.1-pro`
## Zotero 설치
### Windows
1. [Zotero 공식 다운로드 페이지](https://www.zotero.org/download/)를 엽니다
2. Windows 설치 패키지를 다운로드합니다
3. 설치 프로그램을 실행합니다
4. Zotero를 시작합니다
### macOS
1. [Zotero 공식 다운로드 페이지](https://www.zotero.org/download/)를 엽니다
2. macOS 설치 패키지를 다운로드합니다
3. Zotero를 `Applications`로 드래그합니다
4. Zotero를 시작합니다
### Linux
1. [Zotero 공식 다운로드 페이지](https://www.zotero.org/download/)를 엽니다
2. 공식 Linux 패키지를 다운로드합니다
3. 압축을 풀고 Zotero 공식 안내에 따라 실행합니다
4. Zotero가 정상적으로 열리는지 확인합니다
Zotero 공식 문서에 따르면, 플러그인은 주로 데스크톱 버전에 설치됩니다. 이런 종류의 AI 플러그인은 일반적으로 모바일 기기를 첫 라운드 설정 진입점으로 사용하기에 적합하지 않습니다.
## Zotero AI 플러그인 선택 방법
공개 문서에서는 다음 조건을 만족하는 플러그인을 우선 선택하는 것을 권장합니다:
* `Base API URL`, `API URL` 또는 `Endpoint`를 입력할 수 있음
* `API Key`를 입력할 수 있음
* 모델명을 수동으로 입력할 수 있음
* Zotero 환경설정에서 이러한 파라미터를 수정할 수 있으면 더 좋습니다
### 권장하는 공개 판단 방법
플러그인 문서에서 다음과 같은 기능을 명확히 언급하고 있다면, 일반적으로 Crazyrouter 연동에 더 적합합니다:
* `Customize base API URL`
* `API URL`
* `Custom endpoint`
* `Model preferences`
예를 들어, `zotero-chatgpt`의 공개 README에는 사용자 지정 `base API URL` 지원이 명확히 언급되어 있습니다. 반면 `Aria`의 공개 README는 `OpenAI API Key`와 모델 선호 설정 입력에 중점을 두고 있으며, 공개 설명에서 "사용자 지정 업스트림 주소"를 주요 기능으로 다루고 있지 않습니다. 따라서 Crazyrouter 문서에서는 "사용자 지정 OpenAI 호환 주소를 지원하는 플러그인을 선택"하는 것을 더 안정적인 메인 경로로 삼아야 합니다.
## 권장 설정 형식
플러그인마다 필드명이 다를 수 있지만, 처음에는 아래와 같은 방식으로 입력하는 것을 권장합니다:
| 플러그인 필드 | 권장 값 |
| ---------------------- | ------------------------------------------------- |
| Base API URL / API URL | `https://api.crazyrouter.com/v1` |
| Full Endpoint | `https://api.crazyrouter.com/v1/chat/completions` |
| API Key | `sk-xxx` |
| Model | `gpt-5.5` |
플러그인에서 "기본 주소"를 입력하도록 요구한다면 `https://api.crazyrouter.com/v1`을 우선 입력하십시오. 플러그인이 "완전한 채팅 인터페이스 주소"를 명확히 요구하는 경우에만 `https://api.crazyrouter.com/v1/chat/completions`를 입력하십시오.
## 설정 단계
처음에는 다음만 허용하는 것을 권장합니다:
* `gpt-5.5`
* `claude-opus-4-8`
처음부터 많은 모델을 한꺼번에 개방하지 마십시오. 이렇게 하면 문제 해결이 더 쉬워집니다.
사용 중인 시스템에 맞춰 Zotero를 설치하고, 논문 항목을 정상적으로 가져오거나 볼 수 있는지 확인합니다.
Zotero 공식 플러그인 설치 문서에 따라, 먼저 플러그인의 `.xpi` 파일을 다운로드한 다음 Zotero에서:
* `Tools`를 엽니다
* `Plugins`로 이동합니다
* `.xpi` 파일을 플러그인 창으로 드래그합니다
완료 후 Zotero를 재시작합니다.
일반적인 진입 경로는 다음과 같습니다:
* `Edit` → `Preferences`
* 플러그인 자체의 환경설정 페이지
* 플러그인 사이드바 또는 툴바 진입점
플러그인마다 위치가 다를 수 있지만, 핵심은 API와 모델 설정 영역을 찾는 것입니다.
플러그인이 기본 주소 모드를 지원한다면 다음과 같이 입력하는 것을 권장합니다:
* `Base API URL`: `https://api.crazyrouter.com/v1`
* `API Key`: `sk-xxx`
* `Model`: `gpt-5.5`
플러그인이 완전한 인터페이스 주소만 지원한다면 대신 다음을 입력합니다:
* `Endpoint`: `https://api.crazyrouter.com/v1/chat/completions`
일부 플러그인은 API 키, 모델, 또는 환경설정을 수정한 후 Zotero를 재시작해야 적용됩니다. 첫 설정을 완료한 후에는 한 번 재시작하는 것을 권장합니다.
처음부터 복잡한 리뷰 작업을 하지 마십시오. 처음에는 다음만 권장합니다:
* 요약이 있는 문헌 하나를 선택합니다
* 또는 비교적 작은 PDF 하나를 엽니다
* 요약 / 번역 / 간단한 질의응답을 한 번 실행합니다
테스트 프롬프트는 다음을 사용할 수 있습니다:
```text theme={null}
Summarize this paper in 3 bullet points.
```
## 권장 검증 순서
다음 순서로 진행하는 것을 권장합니다:
1. 먼저 Zotero 본체와 플러그인이 모두 정상적으로 열리는지 확인합니다
2. 먼저 `gpt-5.5`를 검증합니다
3. 먼저 단일 문헌 요약을 수행합니다
4. 그다음 번역을 수행합니다
5. 그다음 여러 문헌 비교, 장문 분석 또는 대량 작업을 수행합니다
## 권장 모델
| 시나리오 | 권장 모델 | 이유 |
| ------------ | ----------------- | ------------------------------------------------------------------------ |
| 첫 라운드 연결 검증 | `gpt-5.5` | 2026년 3월 23일 프로덕션 환경에서 실측 성공했으며, 플러그인에서 Crazyrouter로의 기본 연결 검증에 가장 적합합니다 |
| 심층 분석 및 설명 | `claude-opus-4-8` | 복잡한 요약, 방법 비교, 장문 설명에 더 적합합니다 |
| Gemini 대체 옵션 | `gemini-3.1-pro` | 두 번째 호환성 검증 경로로 적합합니다 |
## Zotero에 적합한 사용 방식
### 단일 논문 요약
첫 라운드 검증으로 가장 적합합니다. 컨텍스트가 단순하고 결과를 판단하기 쉽기 때문입니다.
### PDF 번역
먼저 한 페이지 또는 짧은 단락으로 테스트한 후, 점진적으로 범위를 확대하는 것을 권장합니다.
### 여러 문헌 비교
첫 단계로는 권장하지 않습니다. 단일 문헌 요약과 번역이 이미 안정화된 후에, 여러 문헌 비교, 리뷰 개요, 연구 공백 추출 등 더 복잡한 작업을 시도하십시오.
### 노트 정리
플러그인이 결과를 Zotero 노트에 다시 작성하는 것을 지원한다면, 먼저 짧은 요약부터 시작하고 처음부터 대량으로 긴 노트를 생성하지 마십시오.
## 토큰 모범 사례
| 설정 | 권장 사항 | 설명 |
| --------- | ------ | ----------------------------------------- |
| 전용 토큰 | 필수 | Zotero는 IDE나 자동화 프로세스와 토큰을 공유하지 않아야 합니다 |
| 모델 화이트리스트 | 강력히 권장 | 처음에는 1\~2개 모델만 허용합니다 |
| 할당량 상한 | 강력히 권장 | 긴 PDF, 여러 차례의 요약은 소비량을 증폭시킵니다 |
| 시나리오별 토큰 | 권장 | 개인 학술 용도와 팀 공유 용도를 분리합니다 |
| 유출 처리 | 즉시 교체 | 시연, 녹화, 공유된 설정 페이지에 노출된 경우 즉시 키를 교체해야 합니다 |
## 검증 체크리스트
* [ ] Zotero 데스크톱 버전을 설치했습니다
* [ ] 사용자 지정 OpenAI 호환 주소를 지원하는 AI 플러그인을 설치했습니다
* [ ] Zotero 전용 Crazyrouter 토큰을 생성했습니다
* [ ] 기본 주소를 `https://api.crazyrouter.com/v1` 또는 완전한 인터페이스 주소로 입력했습니다
* [ ] `sk-xxx`를 올바르게 입력했습니다
* [ ] 먼저 `gpt-5.5`만 설정했습니다
* [ ] 설정 변경 후 필요에 따라 Zotero를 재시작했습니다
* [ ] 단일 문헌 요약 또는 단일 번역 검증을 완료했습니다
* [ ] Crazyrouter 백엔드 로그에서 해당 요청을 확인할 수 있습니다
## 자주 발생하는 오류와 해결 방법
| 현상 | 일반적인 원인 | 해결 방법 |
| ------------------------------- | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| 플러그인에 OpenAI 키만 있고 Base URL이 없음 | 플러그인이 사용자 지정 업스트림을 지원하지 않음 | 사용자 지정 `Base API URL` 또는 `Endpoint`를 지원하는 플러그인으로 교체 |
| 401 unauthorized | 토큰 오류, 불완전한 복사, 또는 만료 | 토큰을 다시 생성하고 다시 입력 |
| 404 | 기본 주소 또는 완전한 인터페이스 주소를 잘못 입력 | 기본 주소를 `https://api.crazyrouter.com/v1`로 되돌리거나, 완전한 주소를 `https://api.crazyrouter.com/v1/chat/completions`로 되돌립니다 |
| 403 / model not allowed | 토큰이 현재 모델을 허용하지 않음 | Crazyrouter 토큰 설정에서 해당 모델을 허용합니다 |
| `model not found` | 모델명이 잘못 입력됨 | 먼저 `gpt-5.5`로 되돌려 최소 검증을 수행합니다 |
| 플러그인이 반응하지 않거나 설정 변경이 적용되지 않음 | 플러그인이 Zotero 재시작을 필요로 함 | Zotero를 재시작한 후 다시 시도합니다 |
| 요약은 실패했지만 인터페이스는 오류를 반환하지 않음 | 현재 항목에 요약이 없거나, PDF에 첨부 파일이 없거나, 플러그인이 컨텍스트를 가져오지 못함 | 먼저 요약이나 PDF가 있는 항목으로 테스트를 변경합니다 |
| 장문 처리가 매우 느림 | PDF가 너무 길거나 작업이 과도하게 무거움 | 먼저 단일 단락, 단일 페이지, 또는 단일 문헌 요약으로 범위를 줄입니다 |
## FAQ
### Zotero에서 Crazyrouter를 직접 설정할 수 있나요?
일반적으로 Zotero 본체에서 직접 설정하는 것이 아니라, OpenAI 호환 인터페이스를 지원하는 AI 플러그인을 통해 설정합니다.
### 어떤 유형의 플러그인이 Crazyrouter 연동에 가장 적합한가요?
`Base API URL`, `API URL` 또는 `Endpoint` 사용자 지정을 지원하는 플러그인을 우선 선택하십시오.
### 플러그인이 OpenAI API 키만 입력할 수 있다면 어떻게 하나요?
이런 유형의 플러그인은 일반적으로 Crazyrouter 업스트림으로 직접 변경할 수 없으며, 공개 기본 방안으로 적합하지 않습니다. 사용자 지정 주소를 지원하는 플러그인으로 교체하는 것을 권장합니다.
### 기본 주소는 무엇을 입력해야 하나요?
`https://api.crazyrouter.com/v1`을 우선 입력하십시오.
### 첫 번째 모델은 무엇을 입력해야 하나요?
먼저 `gpt-5.5`를 입력하십시오.
### 여러 문헌 분석이나 복잡한 리뷰는 언제 시도해야 하나요?
단일 문헌 요약과 단일 번역이 이미 안정화된 후에, 작업 복잡도를 점진적으로 높여가십시오.
목표가 "먼저 Zotero에서 Crazyrouter를 정상적으로 작동시키는 것"이라면, 가장 중요한 것은 처음부터 가장 강력한 플러그인을 추구하는 것이 아니라, 먼저 선택한 플러그인이 실제로 사용자 지정 OpenAI 호환 주소를 지원하는지 확인한 다음 `gpt-5.5`로 단일 문헌 요약을 정상적으로 작동시키는 것입니다.