MCP 接入 · 让 AI 编程助手直连你的文献库
你平时在 Zotero 外面用 Claude Code / Codex / VSCode / Cursor / Trae / Qoder 这类 AI 编程助手吗？
它们通常只能看你项目里的文件——看不到你 Zotero 里的文献。想让 AI 帮你综述、读 PDF、写笔记，要么复制粘贴半天，要么截图贴给它，效率极低。
AI4Paper MCP 接入就是给这条路开了一扇门：一次配置，AI 工具自己就能翻你的 Zotero。
谁该看这篇
- 你只在 Zotero 里用 AI4Paper 的阅读辅助 / 速搜 / 知识库问答 → 跳过这篇
- 你在 Zotero 外还用 Claude Code / VSCode / Cursor 等 AI 编程工具 → 继续看
一、MCP 能干什么
一句话：让你那些 AI 工具自己调 AI4Paper 的 24 个工具，去 Zotero 里查文献 / 读 PDF / 写笔记 / 管集合。
场景 1：AI 帮你翻文献（不用复制粘贴）
你问 AI：
我的 Zotero 里关于"大模型评测"的论文有几篇？按引用量排序列前 10
AI 自动调：zotero_search_items → 一秒拉出结果给你分析。
场景 2：AI 帮你读 PDF（全文级深度）
你打开一篇 PDF，对 AI 说：
读当前这篇 PDF 全文，写个 800 字中文综述段落，重点讲方法
AI 自动调：zotero_get_current_reader_context + zotero_get_pdf_text → 直接把全文喂给它自己分析。
场景 3：AI 帮你批量做笔记（写回 Zotero）
把"GenAI 运动打卡"集合里每篇论文都生成一段 TL;DR，作为子笔记存进去
AI 自动调：zotero_get_collection_items → 循环 zotero_get_pdf_text + zotero_write_note → Zotero 里几十篇论文几分钟全有总结笔记。
场景 4：AI 帮你整理 / 打标签
把我 Zotero 里所有 2024 年之后的论文建个新集合"2024-已读"，按研究方法打标签
AI 自动调：zotero_search_items + zotero_create_collection + zotero_add_items_to_collection + zotero_add_tag。
完整工具清单（24 个）
读类（默认开启，共 17 个）： 搜索 / 看条目 / 读 PDF 全文 / 读笔记 / 读 PDF 批注 / 列集合 / 拉集合内容 / 工作面快照 / 阅读器当前上下文 / AI 速搜 / 领域监控查询 / 领域监控更新...
写类（默认关闭，需手动开，共 7 个）： 写笔记 / 批量写笔记 / 加标签 / 建集合 / 批量建集合 / 放进集合 / 移出集合
二、为什么选择 MCP
2.1 标准协议，一配全通
MCP 是 Anthropic 推出的开放标准，目前市面上主流 AI 编程助手都在支持：
| AI 工具 | 支持 MCP |
|---|---|
| Claude Code（Anthropic） | ✅ |
| Claude Desktop | ✅ |
| OpenAI Codex CLI | ✅ |
| 智谱 GLM Coding Plan（兼容 Claude Code） | ✅ |
| VSCode + Cline | ✅ |
| VSCode + Copilot Agent（预览） | ✅ |
| Cursor | ✅ |
| Windsurf | ✅ |
| Trae（字节 AI IDE） | ✅ |
| Qoder（阿里 AI IDE · 含 Cline） | ✅ |
| 其他支持自定义 HTTP MCP 的工具 | ✅ |
AI4Paper 只开一个端口，上面所有工具都能连——不用每家单独适配。
2.2 AI 自主调用，不用你教
和"把文献一段段复制进 AI 聊天框"相比：
| 💬 普通 AI 聊天框 | 🔌 MCP 接入 | |
|---|---|---|
| 做什么 | 你手动复制内容喂给 AI | 让外部 AI 工具直接读你 Zotero |
| AI 知道你有啥 | 不知道，每次要你喂 | 自动看到集合/标签/文献结构 |
| AI 能写回吗 | 不能 | 能（建集合 / 写笔记 / 加标签） |
| 适合谁 | 偶尔问一两篇 | 用 AI 编程工具的深度用户 |
简单说：复制粘贴是"喂一口、AI 答一句"，MCP 是"给 AI 一把你家钥匙"。
2.3 本地运行，数据不出机
- AI4Paper MCP 服务只监听
127.0.0.1（本机回环） - 你的文献从 Zotero → 本地 AI 工具 → （如果那工具是云端 AI，比如 Claude Code）→ 对应 AI 厂商
- AI4Paper 自身不参与任何对外传输
- 带 Token 认证，别人扫描你端口也进不来
2.4 不消耗 AI4Paper 额度
MCP 接入走的是你自己 AI 工具的 token（Claude Code / GLM / Codex 订阅），AI4Paper 这边只暴露文献，不烧你的 AI4Paper 月度额度。
三、如何配置 AI4Paper MCP
总思路：AI4Paper 把"配置文本"做好了放在设置页，你一键复制 → 粘到你 AI 工具的配置里 → 完事。
3.1 打开 AI4Paper MCP 配置页
Zotero → 工具 → AI4Paper → MCP 配置（或在 AI4Paper 设置页找 MCP 入口）。
3.2 看清楚三件事
① 运行状态（上半部分）：
- 端点：
http://127.0.0.1:23119/ai4paper/mcp - 服务名：
ai4paper-zotero - Token：一串
a4p-mcp-xxxxxx— 像密码一样保管，别在群里随便发
② 三个开关：
启用 MCP← 必须勾启用认证← 建议勾（不勾就没 Token 校验，等于裸奔）允许写入工具← 新手建议先关（开着 AI 能写 Zotero，方便但有误操作风险）
③ 四张"配置卡片"（按你 AI 工具类型选一张）：
| 卡片名 | 用在哪 | 复制出来是什么 |
|---|---|---|
| 通用 HTTP 接入说明 | 任何支持 HTTP MCP 的工具（兜底） | 一段文字说明 + URL + Token |
| MCP TOML 配置 | Codex CLI | 一段 [mcp_servers.xxx] TOML |
| MCP JSON 配置 | VSCode + Cline / Cursor / Trae / Qoder / Claude Desktop | 一段 {"mcpServers": {...}} JSON |
| MCP 命令行接入 | Claude Code / GLM Coding Plan | 一条 claude mcp add ... 命令 |
每张卡片都有**「复制」按钮**——不用手敲，点了就在剪贴板。
3.3 粘到你 AI 工具的配置里
这一步每家 AI 工具位置不同，去它们自己的官方文档搜 "MCP config" 就能找到——咱们给的就是一段标准配置文本，哪里接都一样。
几家常见的提示：
- Claude Code：复制命令行卡片内容 → 粘到终端回车（一条命令搞定，最简单）
- Codex CLI：把 TOML 追加到
~/.codex/config.toml文件末尾 - GLM Coding Plan：配好智谱环境变量后，复制命令行卡片内容执行
- VSCode + Cline：打开 Cline 的 MCP Servers → Edit MCP Settings → 粘 JSON
- Cursor / Windsurf：设置里找 MCP → 粘 JSON
- Trae / Qoder：和 VSCode + Cline 一样粘 JSON，它们都是 VSCode 的封装
3.4 验证接上了
AI 工具里随便问一句：
我 Zotero 里一共多少篇文献？最常见的 3 个标签是什么？
能答上来就是接好了。AI 会自动调 zotero_get_workspace_snapshot，大多数工具还会在对话里显示"[tool call: zotero_get_workspace_snapshot]"这种标记，你能看到它确实调了。
四、常见问题
Q1: 配完连不上？
按顺序排查：
- Zotero 开着吗？
- MCP 配置页「启用 MCP」勾上了吗？
- 粘到 AI 工具里的 URL 有没有
/ai4paper/mcp这段（漏掉就连不上） - Token 有没有复制全（带
a4p-mcp-前缀） - 端口
23119被占了吗：lsof -i:23119（Mac/Linux）或netstat -ano | findstr 23119（Windows）
Q2: 写入工具要不要开？
刚接入先关。开着后 AI 有建集合 / 写笔记 / 加标签的权限——方便但有风险（AI 误判可能把条目挪错集合）。用熟了再开。
Q3: AI 工具会把我文献传云端吗？
AI4Paper 这边只在本机监听，不出机。但你的 AI 工具本身（比如 Claude Code）模型推理是云端，查到的文献内容会作为上下文发给 AI 厂商——这是所有云端 AI 的通用行为，和 MCP 没关系。介意的话用本地模型 + Cline 配 Ollama。
Q4: Token 能换吗？
可以——MCP 配置页里刷新（或手动把 Token 项清空再重启 Zotero 会生成新的）。换了之后所有已接入的客户端都要重新粘新 Token。
Q5: 关了 Zotero 还能用吗？
不能。AI4Paper MCP 跑在 Zotero 进程里，Zotero 关了服务就停了。下次开 Zotero 自动恢复，客户端下次调用会自动连上。
Q6: 可以同时接多个 AI 工具吗？
可以。Claude Code、VSCode Cline、Cursor 可以同时连同一个 127.0.0.1:23119/ai4paper/mcp，互相不干扰。
Q7: 会消耗 AI4Paper 月度额度吗？
不会。MCP 只是暴露文献接口，AI 推理用的是你 AI 工具自己的订阅（Claude Code 用 Anthropic 额度、Codex 用 OpenAI 额度、GLM Coding Plan 用智谱额度），和 AI4Paper 额度完全独立。
Q8: 远程用能接吗？比如同事连我机器？
默认不行——只听 127.0.0.1。非要远程访问得改端口 + 防火墙 + 加密，极不推荐（安全风险大）。
Q9: 有些 AI 工具（比如旧版 VSCode）不支持 MCP 怎么办？
那就用不了。等该工具跟进——MCP 是 2024 年 11 月发布的标准，2025-2026 年主流工具基本都已支持。
总结三句话：
- 能干什么：让你的 AI 编程助手自己翻 Zotero、读 PDF、批量做笔记
- 为什么选 MCP：一种配置通用所有工具，本地运行，不烧 AI4Paper 额度
- 怎么配：Zotero → AI4Paper → MCP 配置 → 按 AI 工具类型复制对应卡片 → 粘到 AI 工具配置里 → 验证
回到 配置 AI 服务，看 AI 服务怎么配。