Pocket Archive

Pocket Archive MCP 服务

将 Claude、ChatGPT、Cursor、VS Code、Codex 或任何 MCP 应用连接到你的 Pocket Archive。Pocket Archive 是一款 AI 文档整理工具，可整理收据、账单、合同、保修单和税务文件。你的 Agent 可以搜索文档、读取文档文本、上传新文件、跟踪截止日期，并将记录整理到智能集合中；你可以批准只读或读写访问权限。

服务 URL： https://api.pocketarchive.io/mcp · Streamable HTTP · OAuth 登录 · 在 pocketarchive.io 查看设置指南

这是一个托管的（远程）MCP 服务，无需在本地安装或运行任何内容。此仓库包含连接详情、可复用的 Skill 和可选的客户端适配器。

开始之前

你需要一个 Pocket Archive 账户。免费创建账户。所有套餐均包含 MCP 访问权限，包括 Free 套餐；上传文件仍会占用套餐中的文本识别和存储额度。

设置应用

所有应用使用相同的服务 URL：https://api.pocketarchive.io/mcp。应用首次连接时，会在浏览器中打开 Pocket Archive。确认应用名称，然后选择只读或允许更改。

Claude Code

claude mcp add --transport http pocket-archive https://api.pocketarchive.io/mcp

然后在 Claude Code 中运行 /mcp，选择 pocket-archive 并登录。

Claude（网页和桌面端）

打开 Settings → Connectors，然后选择 Add custom connector。将其命名为 Pocket Archive，粘贴服务 URL，然后选择 Connect。

Codex

codex mcp add pocket-archive --url https://api.pocketarchive.io/mcp
codex mcp login pocket-archive

Cursor

将 Pocket Archive 添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "pocket-archive": {
      "url": "https://api.pocketarchive.io/mcp"
    }
  }
}

Cursor 首次连接时会打开浏览器供你登录。

VS Code

将 Pocket Archive 添加到工作区中的 .vscode/mcp.json，或从命令面板运行 MCP: Open User Configuration，将其添加到所有工作区：

{
  "servers": {
    "pocket-archive": {
      "type": "http",
      "url": "https://api.pocketarchive.io/mcp"
    }
  }
}

从文件或扩展视图启动服务；VS Code 会打开浏览器供你登录。

ChatGPT

在 Settings → Apps & Connectors → Advanced settings 中开启开发者模式。使用服务 URL 创建连接器，并选择 OAuth 登录。开发者模式是一项 Beta 功能，是否可用取决于你的 ChatGPT 套餐。

连接详情

对于其他 MCP 应用，或用于检查兼容性：

设置	值
服务名称	pocket-archive
端点	https://api.pocketarchive.io/mcp
传输方式	Streamable HTTP
身份验证	浏览器 OAuth 授权码，使用 PKCE S256
注册	动态公共客户端注册（DCR），token_endpoint_auth_method=none
资源	https://api.pocketarchive.io/mcp
范围	archive:read，可选 archive:write

使用客户端的连接／登录操作。客户端会发现 OAuth 元数据，注册自身名称和回调 URL，打开浏览器授权页面，并将获准的授权码换取 MCP 凭据。授权页面会显示已注册客户端的名称和回调主机；每个获准的连接都可以单独授权和撤销。

如果你已在同一浏览器中登录 Pocket Archive 网页版，授权页面会沿用该登录状态。否则，你需要登录，然后返回授权请求。Agent 会获得自己的 MCP 令牌，不会看到你的网页会话。只读连接仅开放读取工具。Pocket Archive 中的 设置 → 已连接的应用 会列出并允许撤销连接。

客户端需要支持远程 Streamable HTTP 和此 OAuth 流程才能直接连接。仅支持 stdio、旧版 HTTP+SSE、机密客户端身份验证或 Client ID Metadata Documents 的客户端需要适配器。并非所有 Agent 产品都经过测试；兼容性取决于这些能力，而非产品名称。

工具

只读连接只能看到读取工具。允许更改后会添加写入工具。

文档

工具	访问权限	功能
search_documents	读取	按关键词搜索，并可使用文档类型、标签、日期、供应商和金额进行筛选；返回摘录和引文
list_documents_page	读取	使用筛选条件、排序和分页列出文档
list_documents	读取	将文档作为单个数组列出（旧版）
get_document	读取	获取文档字段、OCR 文本和处理状态
list_document_pages	读取	逐页读取 OCR 文本，并提供用于引文的页码
download_original_document	读取	获取原始文件的短时下载链接
get_document_upload_status	读取	在上传完成前后检查上传状态
create_upload_session	写入	为不超过 50 MiB 的 PDF、JPEG、PNG 或 HEIC 文件预留签名上传 URL
create_document	写入	完成上传并开始 OCR、分析和索引
update_document	写入	更新文档元数据或提取的字段
delete_document	写入	将文档移至回收站
restore_document	写入	从回收站恢复文档
retry_document_processing	写入	重试失败的处理阶段

待处理事项（截止日期、续订和后续跟进）

工具	访问权限	功能
list_attention_items	读取	列出整个档案库或某个文档的待处理事项（操作收件箱）
get_attention_item	读取	获取待处理事项及其相关信息
create_attention_item	写入	创建待处理事项，可选择关联文档
update_attention_item	写入	更新事项详情、日期或状态
delete_attention_item	写入	删除待处理事项及其提醒

智能收藏集

工具	访问权限	功能
list_collection_templates	读取	列出收藏集模板及其设置问题
list_collections	读取	列出收藏集
get_collection	读取	获取收藏集及其就绪状态和详情
list_collection_documents	读取	列出收藏集中的文档和建议
list_collection_requirements	读取	列出收藏集的清单
list_collection_requirement_documents	读取	列出与清单项匹配的文档
list_collection_attention_items	读取	列出收藏集的待处理事项
create_collection	写入	根据模板创建收藏集
update_collection	写入	更新、归档或恢复收藏集
delete_collection	写入	删除收藏集（其文档会保留）
refresh_collection	写入	重新评估收藏集及其建议
include_collection_document	写入	将文档添加到收藏集
decide_collection_document	写入	接受或排除建议的文档
remove_collection_document	写入	从收藏集中移除文档
create_collection_requirement	写入	添加清单项
update_collection_requirement	写入	更新或完成清单项
delete_collection_requirement	写入	删除清单项
confirm_collection_requirement_document	写入	确认某文档符合清单项要求
decide_collection_requirement_document	写入	接受或拒绝清单项的建议匹配项
remove_collection_requirement_document	写入	从清单项中移除文档

示例提示词

• “找出我去年的 Costco 收据，并计算总额。”
• “哪些保修将在未来三个月内到期？”
• “将此 PDF 上传到我的归档中，并在处理完成后告诉我它是什么。”
• “为 2026 年创建一个税务收藏集，并告诉我还缺哪些文档。”
• “列出本月所有有截止日期的事项，并为租约续签添加提醒。”

使用 Skill

skills/pocket-archive/SKILL.md 包含与 Agent 无关的归档工作流：查找记录、上传文件并等待处理，以及下载原件。支持 SKILL.md 的 Agent 可以通过自身的 Skill 安装机制加载此文件夹。其他框架可以将这些说明与已发现的 MCP 工具架构搭配使用，作为任务指导。MCP 客户端无需安装 Skill 即可调用这些工具。

# Claude Code
mkdir -p ~/.claude/skills/pocket-archive && curl -fsSL https://raw.githubusercontent.com/ShisunXia/pocket-archive-mcp/main/skills/pocket-archive/SKILL.md -o ~/.claude/skills/pocket-archive/SKILL.md

# Codex
mkdir -p ~/.codex/skills/pocket-archive && curl -fsSL https://raw.githubusercontent.com/ShisunXia/pocket-archive-mcp/main/skills/pocket-archive/SKILL.md -o ~/.codex/skills/pocket-archive/SKILL.md

在 Claude 应用中，下载 pocket-archive.zip，并在 自定义 → Skills 中上传。必须启用代码执行。

Skill 提供工作流指导；宿主负责 MCP 发现、OAuth、凭据存储、工具调用，以及任何二进制上传／下载功能。如果宿主无法执行二进制 HTTP 传输，Agent 会引导用户通过网页上传，而不会声称已上传本地文件路径。

文件

• mcp.json：包含 streamable-http 服务的 Agent Plugins MCP 配置。在支持此格式的宿主中使用；其他客户端应使用其原生格式配置端点。

• skills/pocket-archive/SKILL.md：共享工作流说明。

• .codex-plugin/plugin.json 和 .mcp.json：可选的 Codex 插件适配器。此适配器中的 http 类型映射到同一个 Streamable HTTP 端点。按照 Codex 插件格式，将此仓库（包括其点文件）打包为一个插件根目录。

• skills/pocket-archive/agents/openai.yaml：可选的 OpenAI 显示和依赖项元数据；其他 Agent 可忽略。

• server.json：官方 MCP Registry 的条目。

• glama.json：Glama 的维护者声明。

配置文件不会自动安装到 Agent 中。为客户端打包时，请包含它所需的适配器和 Skill。此仓库不包含任何凭据。

隐私与安全

身份验证遵循 MCP 授权规范。文档文本属于你的数据，Agent 会被要求将其视为数据，而非指令。请参阅 Pocket Archive 的隐私政策，了解如何处理你的数据。

支持

• 设置指南：pocketarchive.io/ai-agents
• 帮助与联系：pocketarchive.io/contact
• 有关此仓库的问题或疑问：提交 issue
• 条款 · 隐私

许可证

此仓库中的文件根据 MIT 许可证发布。Pocket Archive 名称和徽标不受此许可证约束。Pocket Archive 服务的使用受其条款约束。