> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/ko/configuration/overleaf-toolkit/zotero-integration.md).

# Zotero 통합

{% hint style="info" %}
이 기능은 처음에 다음에 의해 개발되었습니다 [davrot](https://github.com/davrot) 및 [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), 다음에 의해 수정됨 [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro) OAuth를 사용합니다. v6.2.0 이상부터 도입되었습니다. 아직 베타 상태입니다. 문제가 있으면 피드백을 부탁드립니다.
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/e310088bbc2425d99115a76ae560cb110fe1c33f" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/372e571f8042655bd5459519cb281c0bc67907c7" alt=""><figcaption></figcaption></figure></div>

### Zotero 연동 설정

1. 열기 [이 링크](https://www.zotero.org/oauth/apps) 를 열어 Zotero OAuth 클라이언트를 생성하세요(이미지처럼)
2. 선택 **애플리케이션 유형**: **브라우저**
3. 다음과 함께 콜백 URL을 설정하세요 `${OVERLEAF_SITE_URL}/user/zotero/oauth/callback`
4. 다음을 구성하세요 `config/variables.env`

<figure><img src="/files/fc99ee5737d729e68492a1084d37437834d3ce86" alt="" width="375"><figcaption></figcaption></figure>

{% code title="config/variables.env" %}

```dotenv
#################
#    Zotero     #
#################
# 'zotero'는 ENABLED_LINKED_FILE_TYPES에 포함되어야 합니다( develop/docker-compose.yml에서 설정)
ENABLED_LINKED_FILE_TYPES=project_file,project_output_file,url,zotero

# Zotero OAuth 클라이언트에서(https://www.zotero.org/oauth/apps에서 등록)
# 애플리케이션 유형: 브라우저 
# 콜백 URL -> ${OVERLEAF_SITE_URL}/user/zotero/oauth/callback
ZOTERO_CLIENT_ID=
ZOTERO_CLIENT_SECRET=
# Mongo에서 Zotero API 키를 암호화합니다(키 파일을 쓰지 않도록 개발 환경에서 설정
# /var/lib/overleaf/data에 저장되며, 개발 웹 컨테이너는 이를 생성할 수 없습니다)
# 생성 방법: `openssl rand -hex 32`
ZOTERO_CIPHER_PASSWORD=dev-zotero-cipher-password
# 선택 사항: 모듈의 서버 측 Zotero 요청(OAuth + API)을 다음을 통해 라우팅
# HTTP 프록시를 통해(웹 컨테이너에서 접근 가능해야 함; github-sync와 동일)
# http://10.0.0.1:10808
# (선택 사항) ZOTERO_PROXY_URL=
```

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/ko/configuration/overleaf-toolkit/zotero-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.