# 安装 Paperless-ngx

- 类型: MCP 工具
- 说明: MCP server for Paperless-ngx 3.x — full REST API coverage, schema-aware, token-frugal.
- 仓库: https://github.com/tobee89/mcp-paperless-ngx

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "Paperless-ngx" MCP 服务：
执行：claude mcp add 'io-github-tobee89-mcp-paperless-ngx' -- npx -y mcp-paperless-ngx
```

### Codex
```
请帮我安装 askskill 上的 "Paperless-ngx" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-tobee89-mcp-paperless-ngx]
command = "npx"
args = ["-y","mcp-paperless-ngx"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "Paperless-ngx" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-tobee89-mcp-paperless-ngx": { "command": "npx", "args": ["-y","mcp-paperless-ngx"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env PAPERLESS_URL=YOUR_VALUE --env PAPERLESS_TOKEN=YOUR_VALUE --env PAPERLESS_PUBLIC_URL=YOUR_VALUE --env PAPERLESS_TOOLSETS=YOUR_VALUE --env PAPERLESS_READ_ONLY=YOUR_VALUE --env PAPERLESS_HEADERS=YOUR_VALUE --env PAPERLESS_DOWNLOAD_DIR=YOUR_VALUE --env PAPERLESS_MAX_PAGE_SIZE=YOUR_VALUE --env PAPERLESS_TIMEOUT_MS=YOUR_VALUE --env PAPERLESS_API_VERSION=YOUR_VALUE --transport stdio io-github-tobee89-mcp-paperless-ngx -- npx -y mcp-paperless-ngx
```
需要环境变量：PAPERLESS_URL, PAPERLESS_TOKEN, PAPERLESS_PUBLIC_URL, PAPERLESS_TOOLSETS, PAPERLESS_READ_ONLY, PAPERLESS_HEADERS, PAPERLESS_DOWNLOAD_DIR, PAPERLESS_MAX_PAGE_SIZE, PAPERLESS_TIMEOUT_MS, PAPERLESS_API_VERSION

### Codex
```bash
codex mcp add --env PAPERLESS_URL=YOUR_VALUE --env PAPERLESS_TOKEN=YOUR_VALUE --env PAPERLESS_PUBLIC_URL=YOUR_VALUE --env PAPERLESS_TOOLSETS=YOUR_VALUE --env PAPERLESS_READ_ONLY=YOUR_VALUE --env PAPERLESS_HEADERS=YOUR_VALUE --env PAPERLESS_DOWNLOAD_DIR=YOUR_VALUE --env PAPERLESS_MAX_PAGE_SIZE=YOUR_VALUE --env PAPERLESS_TIMEOUT_MS=YOUR_VALUE --env PAPERLESS_API_VERSION=YOUR_VALUE io-github-tobee89-mcp-paperless-ngx -- npx -y mcp-paperless-ngx
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-tobee89-mcp-paperless-ngx]
command = "npx"
args = ["-y","mcp-paperless-ngx"]

[mcp_servers.io-github-tobee89-mcp-paperless-ngx.env]
PAPERLESS_URL = "YOUR_VALUE"
PAPERLESS_TOKEN = "YOUR_VALUE"
PAPERLESS_PUBLIC_URL = "YOUR_VALUE"
PAPERLESS_TOOLSETS = "YOUR_VALUE"
PAPERLESS_READ_ONLY = "YOUR_VALUE"
PAPERLESS_HEADERS = "YOUR_VALUE"
PAPERLESS_DOWNLOAD_DIR = "YOUR_VALUE"
PAPERLESS_MAX_PAGE_SIZE = "YOUR_VALUE"
PAPERLESS_TIMEOUT_MS = "YOUR_VALUE"
PAPERLESS_API_VERSION = "YOUR_VALUE"
```
需要环境变量：PAPERLESS_URL, PAPERLESS_TOKEN, PAPERLESS_PUBLIC_URL, PAPERLESS_TOOLSETS, PAPERLESS_READ_ONLY, PAPERLESS_HEADERS, PAPERLESS_DOWNLOAD_DIR, PAPERLESS_MAX_PAGE_SIZE, PAPERLESS_TIMEOUT_MS, PAPERLESS_API_VERSION

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-tobee89-mcp-paperless-ngx": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-paperless-ngx"
      ],
      "env": {
        "PAPERLESS_URL": "YOUR_VALUE",
        "PAPERLESS_TOKEN": "YOUR_VALUE",
        "PAPERLESS_PUBLIC_URL": "YOUR_VALUE",
        "PAPERLESS_TOOLSETS": "YOUR_VALUE",
        "PAPERLESS_READ_ONLY": "YOUR_VALUE",
        "PAPERLESS_HEADERS": "YOUR_VALUE",
        "PAPERLESS_DOWNLOAD_DIR": "YOUR_VALUE",
        "PAPERLESS_MAX_PAGE_SIZE": "YOUR_VALUE",
        "PAPERLESS_TIMEOUT_MS": "YOUR_VALUE",
        "PAPERLESS_API_VERSION": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-tobee89-mcp-paperless-ngx&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1wYXBlcmxlc3Mtbmd4Il0sImVudiI6eyJQQVBFUkxFU1NfVVJMIjoiWU9VUl9WQUxVRSIsIlBBUEVSTEVTU19UT0tFTiI6IllPVVJfVkFMVUUiLCJQQVBFUkxFU1NfUFVCTElDX1VSTCI6IllPVVJfVkFMVUUiLCJQQVBFUkxFU1NfVE9PTFNFVFMiOiJZT1VSX1ZBTFVFIiwiUEFQRVJMRVNTX1JFQURfT05MWSI6IllPVVJfVkFMVUUiLCJQQVBFUkxFU1NfSEVBREVSUyI6IllPVVJfVkFMVUUiLCJQQVBFUkxFU1NfRE9XTkxPQURfRElSIjoiWU9VUl9WQUxVRSIsIlBBUEVSTEVTU19NQVhfUEFHRV9TSVpFIjoiWU9VUl9WQUxVRSIsIlBBUEVSTEVTU19USU1FT1VUX01TIjoiWU9VUl9WQUxVRSIsIlBBUEVSTEVTU19BUElfVkVSU0lPTiI6IllPVVJfVkFMVUUifX0
需要环境变量：PAPERLESS_URL, PAPERLESS_TOKEN, PAPERLESS_PUBLIC_URL, PAPERLESS_TOOLSETS, PAPERLESS_READ_ONLY, PAPERLESS_HEADERS, PAPERLESS_DOWNLOAD_DIR, PAPERLESS_MAX_PAGE_SIZE, PAPERLESS_TIMEOUT_MS, PAPERLESS_API_VERSION