SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

Claude 連接 Zotero 教學:讀論文全文與 PDF 註記

Claude 連接器目錄裡找不到 Zotero,實際可用的是開源 zotero-mcp。依你用 Claude Desktop 或 Claude Code 選接法,固定 0.17.1 版,並說明哪些段落會送到 Anthropic,以及繁中語意搜尋怎麼自己測。

Claude 連接 Zotero 有哪些方法?

要把 Claude 連接到 Zotero,目前實際可用的是社群專案 zotero-mcp,不是 Anthropic 的官方連接器。它讓 Claude 讀你 Zotero 文獻庫裡的書目資料、全文、PDF 指定頁面和註記。該走哪條路,取決於你用的是哪一個 Claude:Claude Desktop 走 MCP 伺服器,Claude Code 可以走 MCP,也可以走更省 token 的技能(skill),想在 Zotero 視窗裡直接對話就裝 Zotero Agent 外掛。

以下所有指令都以 PyPI 上的 zotero-mcp-server 0.17.1 為準,這一版在 2026-11-13 發布。這個專案更新很快,0.16.0 和 0.17.0 是在 2026-11-10 同一天發布的。所以下面的安裝指令都固定版本號,不寫「最新版」。版本一換,指令和預設值都可能跟著變。

先確認:Claude 的連接器目錄裡有沒有 Zotero?

MCP(Model Context Protocol,模型上下文協定)是一套開放協定,讓 AI 助理呼叫外部工具。Claude 的連接器(connector)目錄就是一份可以直接加進 Claude 的 MCP 伺服器清單,每一筆都標示 Verified 或 Community。

我們在 2026-11-14 查詢目錄時,沒有找到 Zotero 連接器。不過目錄頁面的搜尋結果,用抓取工具讀出來並不可靠,所以請你自己再查一次。在 Claude 裡打開 Customize > Connectors > Discover,在 Search connectors 輸入 Zotero。如果之後出現了 Zotero 的連接器,先看它的標示,再決定要不要改用它。

zotero-mcp 是什麼?授權怎麼算?

zotero-mcp 是 GitHub 上的 54yyyu/zotero-mcp。截至 2026-11-14,它約有 5.9k 顆星,沒有封存,前一天還有新的提交。我們沒有看到 Anthropic 或 Zotero 表示他們維護或背書這個專案,所以請把它當作社群專案看待。

授權分成兩塊。MCP 伺服器和 zotero-cli 採用 MIT 授權。plugin/ 目錄裡的 Zotero Agent 外掛採用 AGPL-3.0-or-later。PyPI 上整個套件的授權標示是 MIT AND AGPL-3.0-or-later。如果你打算修改外掛,再分享給實驗室的同學,請先讀 AGPL 的條款。

依 README 的說明,它能做到這些事:

  • 依標題、作者、標籤、收藏夾、全文或語意搜尋文獻。
  • 讀取書目資料、BibTeX、全文,以及 PDF 的指定頁面範圍。文字擷取出現亂碼時,可以改讀頁面影像。
  • 讀取 PDF 註記,包括螢光筆標記、區域框選和筆記。
  • 在本機模式下,讀取的資料直接來自你電腦上的 zotero.sqlite。

開始之前要準備什麼?

  • Python 3.10 以上。PyPI 上的套件資料寫的是 requires_python >=3.10,版本太舊就裝不起來。
  • Zotero 7 以上。打開 Settings → Advanced,勾選 Allow other applications on this computer to communicate with Zotero。中文介面會顯示翻譯過的名稱,在同一個進階設定頁裡找對應的選項。
  • 如果要讓 Claude 寫回 Zotero,需要 Zotero 10 以上。Zotero 官網目前提供下載的版本就是 Zotero 10。

那個勾選項為什麼一定要開?因為 Zotero 的本機 API 位在 localhost:23119 的 /api/ 底下,而 Zotero 的文件寫得很清楚:沒開這個選項,請求會回傳 403 Forbidden。本機 API 的讀取請求不需要驗證,所以只要選項打開,同一台電腦上的程式就能讀你的文獻庫。

怎麼安裝 zotero-mcp 0.17.1?

README 推薦用 uv tool install,也可以用 pip。兩種都固定版本:

uv tool install zotero-mcp-server==0.17.1
# 或者
pip install zotero-mcp-server==0.17.1

zotero-mcp version

zotero-mcp version 應該印出 0.17.1。這個套件會裝三個指令:zotero-mcp、zotero-mcp-server 和 zotero-cli。如果 shell 回報 command not found,通常是 uv 放工具的目錄不在 PATH 裡,執行 uv tool update-shell 後重開終端機再試。

路線一:Claude Desktop 怎麼接 Zotero MCP?

Claude Desktop 有 macOS、Windows 和 Linux 版本,還沒裝的話可以先看Claude 桌面版要去哪裡下載。README 提供一個自動設定的指令:

zotero-mcp setup

README 的說明是這個指令會自動設定 Claude Desktop。如果你想自己改,設定檔是 claude_desktop_config.json,可以從 Desktop 的 Settings > Developer > Edit Config 打開。MCP 專案的文件列出這三個位置:

  • macOS:~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows:%APPDATA%\Claude\claude_desktop_config.json
  • Linux:~/.config/Claude/claude_desktop_config.json

README 給的手動設定是這一段:

{
  "mcpServers": {
    "zotero": {
      "command": "zotero-mcp",
      "env": { "ZOTERO_LOCAL": "true" }
    }
  }
}

ZOTERO_LOCAL 設成 true,伺服器就走本機模式,直接讀你電腦上的 Zotero。改完之後要完全結束 Claude Desktop 再重新開啟,只關掉視窗不算。重開後問 Claude「列出我 Zotero 裡最近加入的五篇文獻」,它應該會呼叫 zotero 的工具並列出書目。

如果 Desktop 找不到 zotero-mcp,把 command 改成完整路徑。macOS 和 Linux 用 which zotero-mcp 查,Windows 用 where zotero-mcp 查。還有一點要知道:MCP 的文件提醒,這個伺服器是用你自己的使用者權限在執行。

路線二:Claude Code 該用 MCP 還是技能?

Claude Code 兩種都能用,差別在佔用多少上下文。

用 MCP 伺服器

README 的說法是把同一段 mcpServers 設定加進 ~/.claude.json。直接手改這個檔案容易放錯位置,因為它同時存放「只給某個專案用」和「所有專案共用」的伺服器。Claude Code 自己的指令比較穩當:

claude mcp add --scope user --env ZOTERO_LOCAL=true zotero -- zotero-mcp

-- 用來分隔 Claude 的選項和伺服器本身的指令。--scope user 會把設定存進 ~/.claude.json,所有專案都看得到。不加 --scope 時預設是 local,只有目前這個專案能用。加完之後在 Claude Code 裡輸入 /mcp,應該會看到 zotero 處於已連線的狀態。

讀全文時要注意輸出上限。Claude Code 的文件寫明,單次 MCP 工具輸出超過 10,000 token 會出現警告,預設上限是 25,000 token,可以用 MAX_MCP_OUTPUT_TOKENS 調整。一本兩百頁的碩士論文全文很容易超過這個量,所以請 Claude 讀指定頁面範圍,不要一次讀整本。長時間對話的上下文怎麼管,可以參考Claude Code 的上下文管理。

用技能(skill)

技能路線不啟動 MCP 伺服器,而是教代理直接執行 zotero-cli 指令。依 0.17.1 的原始碼,下面這行會把技能裝到 ~/.claude/skills/zotero-cli/,裡面有 SKILL.md 和 reference.md:

zotero-mcp install-skill --target claude-user

如果只想給某個專案用,在專案目錄裡改用 --target claude,它會寫進目前目錄的 .claude/skills/zotero-cli/。請明確寫出 --target,因為不加的時候,它會偵測目前目錄和家目錄裡有哪些代理的設定資料夾,然後全部都裝一份。--list-targets 可以列出所有支援的目標。

為什麼技能比較省?README 的解釋是 MCP 伺服器在每次請求都會送出所有工具的說明,大約 8k token,而你什麼都還沒打。技能平時只佔 98 token,要等代理判斷用得上,才載入完整內容。README 列出的最壞情況,是連完整指令參考一起載入,共 6,582 token。這和 Claude Code 文件的說法一致:技能平時只載入描述,被呼叫時才載入全文。兩種機制的取捨,在代理技能、MCP 與規則檔的比較裡有完整說明,第一次接觸技能的話,可以先讀什麼是代理技能。

技能路線需要能執行 shell 指令的代理。README 列出的有 Claude Code、Cursor、Codex、Windsurf、Gemini CLI、Amp 和 OpenCode。如果你的筆記放在 Obsidian,同一個 Claude Code 工作階段也能一起讀,做法見用 Claude Code 操作 Obsidian 筆記庫。

路線三:能不能在 Zotero 裡直接跟 Claude 對話?

可以,這就是 Zotero Agent 外掛。它在 Zotero 裡加一個對話面板,背後由你自己安裝的 Claude Code、Codex、pi 或 OpenCode 驅動。所以你得先裝好其中一個並登入。安裝方式是先執行:

zotero-cli plugin

它會印出 .xpi 檔的位置和安裝步驟。接著在 Zotero 裡打開 Tools > Plugins,按齒輪圖示,選 Install Plugin From File,再選那個 .xpi 檔。請注意,這是 Zotero 的外掛,和 Claude Code 自己的外掛系統是兩回事,後者見Claude Code 外掛說明。這個外掛採用 AGPL-3.0-or-later 授權。

想讓 Claude 寫入 Zotero,要多做什麼?

讀取不需要授權,寫入需要。Zotero 10 以上的版本,執行一次:

zotero-mcp authorize-local

Zotero 會跳出對話框,選項是 Allow、Always Allow 和 Deny。README 要你選 Always Allow。這是因為 Zotero 的本機寫入金鑰只能在執行時透過 POST /api/local/authorize 申請,不能事先建立,而且它和 zotero.org 網站上的 API 金鑰是兩套東西。之後可以用 zotero-mcp authorize-local --status 查看授權狀態。

如果你的 Zotero 低於 10,或你想走雲端,README 的另一條路是設定 ZOTERO_API_KEY 和 ZOTERO_LIBRARY_ID,透過 Zotero 的 web API 寫入。zotero-mcp setup --no-local 會改用 web API 來設定。

哪些資料會離開你的電腦?

文獻庫本身留在你的電腦上。本機模式讀的是你自己的 zotero.sqlite,PDF 檔不會整批上傳。

但 Claude 模型不在你的電腦上執行。Claude Code 的文件寫明,它會把所有提示和模型輸出經 TLS 1.2 以上加密傳到網路上。工具讀出來的段落,要放進對話才能讓模型讀到,所以 Claude 讀過的每一段摘要、全文和註記,都會成為送到 Anthropic 的對話內容。這是依運作方式推得的結論,文件沒有逐字列出「MCP 工具結果」這一項。

保存期限依帳號類型而定。依 Claude Code 的資料使用文件,個人方案(Free、Pro、Max、Ultra)如果允許資料用於改進模型,保存期是 5 年,而且這些資料會用來訓練新模型,包括你從 Claude Code 送出的內容。不允許的話是 30 天。商業方案的標準保存期是 30 天。這個設定在 claude.ai/settings/data-privacy-controls。

對研究生來說,真正要想的是:尚未發表的論文初稿、審查中的稿件、受訪者的逐字稿,能不能送到外部服務?這要看你的指導教授、研究倫理審查和合作單位的規定,不是工具能替你決定的。如果某個收藏夾不能外送,就不要叫 Claude 讀它。

可以在 claude.ai 網頁版或手機 App 用嗎?

沒有文件記載的方法。Anthropic 的文件說,網頁版和手機 App 只支援遠端連接器,桌面版才另外支援以桌面擴充功能安裝的本機連接器。說明中心也寫明,透過 claude_desktop_config.json 設定的本機 MCP 伺服器,在 claude.ai 上無法使用。

自訂的遠端連接器是由 Anthropic 的雲端去連你的伺服器,所以伺服器必須能從公開網路連到,而且開在標準 HTTPS 的 443 埠。放在私人網路、VPN 後面或被防火牆擋住的伺服器都連不上。

zotero-mcp 的 README 沒有說明任何遠端用法。0.17.1 的原始碼裡,zotero-mcp serve 確實有 --transport 選項,可選 streamable-http 和 sse(後者已標示為即將淘汰)。但要讓 claude.ai 連上,就得把你的私人文獻庫開放到公開網路上,README 沒有寫這條路,這裡也不教。把本來就該上線的 MCP 服務放在伺服器上,做法見在 VPS 上執行 MCP 伺服器,但你的文獻庫不屬於這一類。

繁體中文文獻的語意搜尋找得到嗎?

這一題我們還沒有答案,請你自己測,下面是測試方法。

語意搜尋要另外安裝 semantic 套件組,再設定嵌入模型、建立索引:

uv tool install "zotero-mcp-server[semantic]==0.17.1"
zotero-mcp setup --semantic-config-only
zotero-mcp update-db --fulltext
zotero-mcp db-status

README 只寫支援「local、OpenAI、Gemini 或 Ollama」的嵌入模型,沒有寫預設是哪一個。專案的語意搜尋文件(docs/semantic-search.md,讀的是主分支,不保證和 0.17.1 完全相同)寫的預設是 all-MiniLM-L6-v2,說明它免費、在本機執行。這個模型的模型卡把語言標為英文,並寫明超過 256 個 word piece 的輸入預設會被截斷。同一份文件建議 Ollama 使用者選 bge-m3,說它有「better multilingual retrieval quality」。

請挑五篇從臺灣博碩士論文知識加值系統或華藝線上圖書館匯入、附中文摘要的論文,照這個順序測:

  1. 用預設模型建立索引,執行 zotero-mcp update-db。
  2. 請 Claude 用語意搜尋,以繁體中文描述其中一篇的主題,記下它排第幾。
  3. 用英文描述同一個主題,再搜一次,看中文摘要的論文是否還找得到。
  4. 改用 bge-m3:先執行 ollama pull bge-m3,再跑 zotero-mcp setup --semantic-config-only 選 Ollama,模型名稱填 bge-m3。
  5. 執行 zotero-mcp update-db --force-rebuild 重建索引,重做第 2 步和第 3 步,比較兩次的結果。

換模型一定要加 --force-rebuild,因為舊索引是用舊模型算出來的,新舊向量不能混在一起比。如果語意搜尋找不到,還有一般的全文搜尋可以用中文關鍵字直接比對。另外要知道:選 OpenAI 或 Gemini 當嵌入模型時,建立索引的文字必須送到那家公司才算得出向量。只有 local 和 Ollama 是在你的電腦上計算。

Windows 使用者還要注意一件事。索引預設存在 ~/.config/zotero-mcp/chroma_db,而文件寫明在 Windows 上這個路徑只能用 ASCII 字元。如果你的使用者資料夾是中文名稱,例如 C:\Users\王小明,請在 ~/.config/zotero-mcp/config.json 裡把 persist_directory 改成純英文路徑,再執行 zotero-mcp update-db --force-rebuild。

出問題時先看哪裡?

  • 請求回傳 403 Forbidden:Zotero 的本機 API 沒有打開。回到 Settings → Advanced 勾選那個選項,並確認 Zotero 正在執行。
  • Claude Desktop 看不到 zotero 工具:先確認你是完全結束後重開,再檢查 command 是不是要改成完整路徑。
  • Claude Code 裡沒有工具:輸入 /mcp 看伺服器狀態。如果設定時沒加 --scope user,換到別的專案目錄就看不到它。
  • 讀全文時出現輸出過長的警告:改成請 Claude 讀指定頁面範圍。
  • 寫入失敗:用 zotero-mcp authorize-local --status 檢查授權,並確認 Zotero 是 10 以上。

升級時也請刻意選版本。zotero-mcp update --check-only 只檢查有沒有新版,不會安裝。先讀新版的變更說明,再改掉安裝指令裡的版本號重新安裝。如果你是學生,正在比較方案和用量,可以參考學生使用 Claude 的方式。

FAQ

Claude 有官方的 Zotero 連接器嗎?

我們在 2026-11-14 查詢 Claude 的連接器目錄時沒有找到 Zotero。目錄會變動,請自己到 Customize > Connectors > Discover 搜尋 Zotero。目前實際可用的是社群專案 zotero-mcp,它的 MCP 伺服器採用 MIT 授權。

用 zotero-mcp 時,我的 PDF 會上傳到 Anthropic 嗎?

整個文獻庫和 PDF 檔不會整批上傳,本機模式讀的是你電腦上的 zotero.sqlite。但 Claude 讀過的段落會成為對話內容,而 Claude Code 的文件寫明所有提示和模型輸出都會傳到 Anthropic。不能外送的資料,就不要叫 Claude 讀。

Claude Code 該用 MCP 還是技能接 Zotero?

兩種都能用。README 寫的是 MCP 伺服器每次請求約佔 8k token,技能平時只佔 98 token,用得上時才載入完整內容。如果你主要在 Claude Code 裡工作,執行 zotero-mcp install-skill --target claude-user 走技能路線比較省上下文。

為什麼 Claude 連不上我的 Zotero,出現 403?

Zotero 的本機 API 沒開時,請求會回傳 403 Forbidden。在 Zotero 7 以上打開 Settings → Advanced,勾選 Allow other applications on this computer to communicate with Zotero,並讓 Zotero 保持執行。要寫入的話,還需要 Zotero 10 並執行一次 zotero-mcp authorize-local。

可以在 claude.ai 網頁版或手機上讀我的 Zotero 嗎?

沒有文件記載的方法。網頁版和手機 App 只支援遠端連接器,而遠端連接器必須能從公開網路連到。zotero-mcp 的 README 沒有說明遠端用法,所以請改用 Claude Desktop 或 Claude Code。

這篇文章對您有幫助嗎?