连接器指南阅读约 3 分钟9 个 MCP 工具7 种语言

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

Paperless-ngx 文档管理:对扫描文档、通信对象、文档类型、标签、存储路径以及任何文档经 OCR 识别的内容进行全文搜索。在您自己的实例上使用 REST API,令牌身份验证。

HC作者:HelpCode 团队更新于 3 分钟阅读 在 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

类别

文档管理

身份验证

API Key

所需环境变量

PAPERLESS_URLPAPERLESS_API_TOKEN
在 Cloud 上一键安装

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

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

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

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

开始免费试用

摘要

Paperless-ngx 文档管理:对扫描文档、通信对象、文档类型、标签、存储路径以及任何文档经 OCR 识别的内容进行全文搜索。在您自己的实例上使用 REST API,令牌身份验证。

试试这样问

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 + Microsoft Copilot

Paperless-ngx 文档管理:对扫描文档、通信对象、文档类型、标签、存储路径以及任何文档经 OCR 识别的内容进行全文搜索。在您自己的实例上使用 REST API,令牌身份验证。

前提条件

完整的设置说明已内置在连接器中 (在 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 — 在 Microsoft Copilot 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器:把 AnythingMCP 作为工具添加到智能体,然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接,AnythingMCP 支持这种方式。

  1. 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
  2. 填写 Server name(例如 AnythingMCP)、说明连接器用途的 Server description,以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
  3. 身份验证选择 API key,把 Type 设为 Header,请求头名称填 X-API-Key,然后选择 Create。
  4. 在 Add tool 中选择 Create a new connection,粘贴 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
  5. 在智能体的 Test 窗格中试一试:提出需要用到 Paperless-ngx 的工具的请求。
  6. 选择 Publish,然后进入 Channels → Microsoft 365 and Microsoft Teams,保持勾选 Make agent available in Microsoft Copilot,再选择 Add channel。See agent in Teams 会为你安装该智能体;在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。

希望每个用户各自登录?请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥:每个用户会在智能体首次调用时登录 AnythingMCP。

自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接,因此 localhost 无法使用。

可用工具

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

这适用于哪个 Copilot? 适用于工作中的 Microsoft 365 Copilot,通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。

我需要什么? 一个可以使用 Copilot Studio 的工作账户(许可证或试用版),用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限:把它共享给他们,或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略,这些策略同样适用于 MCP 服务器。

智能体不调用工具。 检查请求头名称是否正好是 X-API-Key,密钥是否属于与 URL 相同的 MCP 服务器,并把 Server description 写得具体:Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体;在已打开的对话中输入 "start over" 即可使用新版本。

下一步

这份指南对你有帮助吗?

你的 Paperless-ngx 智能体只差一次点击。

安装连接器,粘贴密钥,向 Microsoft Copilot 提问。免费试用 7 天,无需信用卡。

相关指南

连接器

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

Paperless-ngx 文档管理:对扫描文档、通信对象、文档类型、标签、存储路径以及任何文档经 OCR 识别的内容进行全文搜索。在您自己的实例上使用 REST API,令牌身份验证。

连接器

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

Paperless-ngx 文档管理:对扫描文档、通信对象、文档类型、标签、存储路径以及任何文档经 OCR 识别的内容进行全文搜索。在您自己的实例上使用 REST API,令牌身份验证。

连接器

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

Paperless-ngx 文档管理:对扫描文档、通信对象、文档类型、标签、存储路径以及任何文档经 OCR 识别的内容进行全文搜索。在您自己的实例上使用 REST API,令牌身份验证。

连接器

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

Paperless-ngx 文档管理:对扫描文档、通信对象、文档类型、标签、存储路径以及任何文档经 OCR 识别的内容进行全文搜索。在您自己的实例上使用 REST API,令牌身份验证。

连接器

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

Paperless-ngx 文档管理:对扫描文档、通信对象、文档类型、标签、存储路径以及任何文档经 OCR 识别的内容进行全文搜索。在您自己的实例上使用 REST API,令牌身份验证。

连接器

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

Paperless-ngx 文档管理:对扫描文档、通信对象、文档类型、标签、存储路径以及任何文档经 OCR 识别的内容进行全文搜索。在您自己的实例上使用 REST API,令牌身份验证。