Paperless-NGX MCP 快速开始指南

安装

npm install -g paperless-mcp

配置

1. 获取 API 令牌

• 登录 Paperless-NGX 实例
• 点击右上角用户名 > 我的个人资料
• 点击循环箭头按钮生成新令牌

2. 添加到 Claude MCP 配置中

VSCode 扩展：编辑 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "paperless": {
      "command": "npx",
      "args": ["paperless-mcp", "http://your-paperless-instance:8000", "your-api-token"]
    }
  }
}

Claude 桌面应用：编辑 ~/Library/Application Support/Claude/claude_desktop_config.json，使用相同的配置格式

使用示例

你可以要求 Claude 执行以下操作：

• "显示所有标记为'发票'的文档"
• "搜索包含'纳税申报表'的文档"
• "创建一个名为'收据'的红色标签"
• "下载文档 #123"
• "列出所有联系人"
• "创建一个名为'银行对账单'的文档类型"

主要功能

文档操作

• 列出文档: list_documents({page: 1, page_size: 25})
• 获取文档: get_document({id: 123})
• 搜索文档: search_documents({query: "发票 2024"})
• 下载文档: download_document({id: 123, original: false})
• 上传文档: post_document({file: "base64内容", filename: "发票.pdf", ...})
• 批量编辑: bulk_edit_documents({documents: [1,2,3], method: "add_tag", tag: 5})

标签管理

• 列出标签: list_tags()
• 创建标签: create_tag({name: "发票", color: "#ff0000"})

联系人管理

• 列出联系人: list_correspondents()
• 创建联系人: create_correspondent({name: "ABC公司"})

文档类型管理

• 列出文档类型: list_document_types()
• 创建文档类型: create_document_type({name: "发票"})

现在您可以开始使用 Claude 来管理您的 Paperless-NGX 文档了！