Connector guide2-minute read9 MCP toolsEN · DE · IT

如何将 Paperless-ngx 连接到 Gemini — 通过 MCP

Paperless-ngx document management: full-text search over scanned documents, correspondents, document types, tags, storage paths and the OCR'd content of any document. REST API on your own instance, token auth.

HCBy HelpCode team更新于 2 min read 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Paperless-ngx

Paperless-ngx

Paperless-ngx document management: full-text search over scanned documents, correspondents, document types, tags, storage paths and the OCR'd content of any document. REST API on your own instance, token auth.

个工具

9

区域

DE

类别

Document Management

身份验证

API Key

所需环境变量

PAPERLESS_URLPAPERLESS_API_TOKEN
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • GDPR & SOC 2 ready
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

跳过安装。2 分钟内即可运行。

cloud.anythingmcp.com 开始免费试用,一键添加 Paperless-ngx,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。

开始免费试用

Summary

Paperless-ngx document management: full-text search over scanned documents, correspondents, document types, tags, storage paths and the OCR'd content of any document. REST API on your own instance, token auth.

试试这样问

Paperless-ngx 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Paperless-ngx · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 无需安装? 直接使用 cloud.anythingmcp.com 登录、点击 Connectors → Paperless-ngx、粘贴凭证、生成 MCP API key — 完成。无 Docker、无 git clone、无本地服务器。

Paperless-ngx + Gemini

Paperless-ngx document management: full-text search over scanned documents, correspondents, document types, tags, storage paths and the OCR'd content of any document. REST API on your own instance, token auth.

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

PAPERLESS_URL, PAPERLESS_API_TOKEN

步骤 1 — 获取凭证

Getting a token

  1. Sign in to Paperless-ngx, open the user menu → My Profile, and copy the API Auth Token (create one if the field is empty).
  2. Put it in PAPERLESS_API_TOKEN and your instance's base URL in PAPERLESS_URL — no trailing slash and no /api, e.g. https://paperless.example.com.

The Authorization header is Token …, Django REST Framework's scheme — not Bearer. The adapter sends it correctly.

…(continued in the in-app connector instructions)

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

Gemini CLI 从 ~/.gemini/settings.json (Windows: %APPDATA%\gemini\settings.json) 读取 MCP 服务器。添加:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" }
    }
  }
}
  1. 从 AnythingMCP 获取你的 MCP API key
  2. 保存文件并重启 gemini
  3. 在 Gemini CLI 中运行 /mcpPaperless-ngx 应显示为可用。
  4. Vertex AI Studio: 将 https://cloud.anythingmcp.com/mcp 传入请求的 tools 数组,使用相同的 Bearer 头。

可用工具

ToolWhat it does
paperless_ngx_search_documentsFull-text search across the OCR'd content of every document
paperless_ngx_list_documentsList documents filtered by correspondent, document type, tag or creation date — the structured alternative to full-text search when you alre
paperless_ngx_get_documentRead one document's metadata: title, correspondent, type, tags, created and added dates, archive serial number and the full OCR'd content
paperless_ngx_get_document_metadataRead the technical metadata of one document: original filename, media type, checksum, page count and any embedded PDF metadata
paperless_ngx_list_correspondentsList correspondents — the senders documents are filed under — with their document count and matching rules
paperless_ngx_list_document_typesList the document types configured in the instance (invoice, contract, payslip …) with their document counts
paperless_ngx_list_tagsList tags with their colour, inbox flag and document count
paperless_ngx_list_storage_pathsList the storage paths documents are filed into, with their path template and document count
paperless_ngx_get_statisticsRead instance-wide statistics: total documents, documents in the inbox, character count and the breakdown by file type

FAQ

Gemini 1.5 Pro 或 2.x 支持 MCP 吗? 支持 — Gemini CLI ≥ 0.4 与 Vertex AI tools API 均接受带 Bearer 头的 MCP httpUrl 连接器。

下一步

这份指南对你有帮助吗?

Your Paperless-ngx agent is one click away.

Install the connector, paste the key, prompt Gemini. Free for 7 days, no credit card.

相关指南

connectors

如何将 Paperless-ngx 连接到 ChatGPT — 通过 MCP

Paperless-ngx document management: full-text search over scanned documents, correspondents, document types, tags, storage paths and the OCR'd content of any document. REST API on your own instance, token auth.

connectors

如何将 Paperless-ngx 连接到 Claude — 通过 MCP

Paperless-ngx document management: full-text search over scanned documents, correspondents, document types, tags, storage paths and the OCR'd content of any document. REST API on your own instance, token auth.

connectors

如何将 Paperless-ngx 连接到 Cursor — 通过 MCP

Paperless-ngx document management: full-text search over scanned documents, correspondents, document types, tags, storage paths and the OCR'd content of any document. REST API on your own instance, token auth.

connectors

Paperless-ngx 接入 MCP — 从任意 AI 代理驱动 Paperless-ngx

Paperless-ngx document management: full-text search over scanned documents, correspondents, document types, tags, storage paths and the OCR'd content of any document. REST API on your own instance, token auth.

connectors

如何将 AFAS Profit 连接到 Gemini — 通过 MCP

AFAS Profit — Dutch ERP and HR: read any published GetConnector, list what is available, and inspect a connector's metadata. Token auth with AFAS's base64-wrapped XML token.

connectors

如何将 Aruba Fatturazione Elettronica 连接到 Gemini — 通过 MCP

Aruba Fatturazione Elettronica: send and track Italian e-invoices through the Sistema di Interscambio, read received invoices and their SDI notifications. Token auth against Aruba's B2B gateway.