MCP 接入 — 让 Claude 操作你的 Zotero
什么是 MCP
MCP（Model Context Protocol）是 Anthropic 推出的开放标准，让 AI 模型能直接调用外部工具和数据。
AI4Paper 内置了 MCP 服务，开启后，Claude Desktop、Claude Code、Codex 等 AI 客户端可以直接读取和操作你本机 Zotero 里的文献库。
你可以把它理解为：给 Claude 装上了一双能摸到你 Zotero 的手。
能做什么
读取文献
| 工具 | 说明 |
|---|---|
zotero_get_workspace_snapshot | 获取当前 Zotero 工作面（选中文献、打开论文、当前集合） |
zotero_get_item_context | 获取单篇论文的完整上下文（元数据 + 摘要 + 正文预览） |
zotero_get_current_reader_context | 获取当前正在阅读的论文 |
zotero_search_items | 关键词搜索文献库 |
zotero_get_selected_items | 获取当前选中的文献 |
zotero_get_item | 按 ID 获取单篇文献 |
zotero_get_pdf_text | 提取 PDF 全文文本 |
zotero_list_collections | 列出所有文件夹 |
zotero_get_collection_items | 获取某个文件夹下的文献 |
zotero_get_notes | 获取笔记 |
zotero_get_annotations | 获取 PDF 批注和高亮 |
搜索与追踪
| 工具 | 说明 |
|---|---|
zotero_topic_search | AI 速搜文献 |
zotero_tracker_list_domains | 列出追踪领域 |
zotero_tracker_create_domain | 创建追踪领域 |
zotero_tracker_update_domain | 更新单个领域 |
zotero_tracker_update_all_domains | 更新所有领域 |
整理与写入（需开启写入权限）
| 工具 | 说明 |
|---|---|
zotero_write_note | 写笔记 |
zotero_batch_write_notes | 批量写笔记 |
zotero_create_collection | 创建文件夹 |
zotero_batch_create_collections | 批量创建文件夹 |
zotero_add_items_to_collection | 将文献加入文件夹 |
zotero_remove_items_from_collection | 将文献移出文件夹 |
zotero_add_tag | 添加标签 |
zotero_organize_pdfs | PDF 整理 |
三步接入
1. 开启 MCP
打开 AI4Paper 偏好设置 → 找到 MCP 接入 → 勾选启用。建议同时启用认证。
2. 复制配置
点击 打开接入配置，在弹窗中选择你的客户端类型，一键复制配置。
支持的客户端：
- Claude Desktop — 复制 JSON 配置
- Claude Code — 复制终端命令
- Codex — 复制 TOML 配置
- 其他 HTTP MCP 客户端 — 复制端点和 Token
3. 粘贴到客户端
将配置粘贴到对应客户端的 MCP 设置中，重启客户端即可。
连接信息
| 项目 | 值 |
|---|---|
| 端点 | http://127.0.0.1:23119/ai4paper/mcp |
| 传输方式 | HTTP MCP |
| 认证 | Authorization: Bearer <token> |
| 兼容头 | x-ai4paper-mcp-token: <token> |
端口以 AI4Paper 界面显示为准。如果修改过 Zotero 本地 HTTP 端口，端点会随之变化。
写入权限
默认只开启只读模式。如果你希望 AI 客户端能创建文件夹、写笔记、整理文献：
- 在偏好设置中开启
允许写入工具 - 写入工具才会出现在客户端的工具列表中
关闭写入权限时，写入类工具完全隐藏，即使客户端强行调用也会被拒绝。
使用场景
论文阅读助手
"帮我总结当前正在阅读的这篇论文的核心贡献，并和我文献库里的相关论文做对比"
Claude 会调用 zotero_get_current_reader_context 获取当前论文，调用 zotero_search_items 找到相关论文，然后为你做对比分析。
文献整理
"把我文献库里所有关于 transformer 的论文整理到一个新文件夹里"
Claude 会搜索文献库，创建文件夹，批量归档。
综述辅助
"帮我做一个关于 LLM 在医学影像领域应用的文献综述大纲，基于我 Zotero 里的论文"
Claude 会读取你的文献、提取关键信息、生成结构化综述大纲。
文献搜索
"帮我搜一下最近两年关于多模态大模型的高引论文，导入到 Zotero"
Claude 会调用 AI4Paper 的速搜文献功能，自动检索并导入。
常见问题
连不上？
检查：Zotero 是否运行 → AI4Paper 是否加载 → MCP 是否启用 → 端点和 Token 是否正确 → Zotero 本地 HTTP Server 是否开启。
看不到写入工具？
偏好设置中开启 允许写入工具。
安全吗？
- MCP 仅在本地运行（127.0.0.1），不对外暴露
- 支持 Token 认证
- 写入权限独立开关
- 不暴露内部提示词
- 需要 Pro 或试用授权
支持哪些 AI 客户端？
所有支持 HTTP MCP 的客户端都可以接入，包括但不限于 Claude Desktop、Claude Code、Codex。