Paperless MCP

Paperless MCP wird lokal ausgeführt, und zwar aus einem auf PyPI veröffentlichten Python-Paket: pvliesdonk-paperless-mcp, Version 3.0.0. Der Server spricht MCP über stdio: Der Client startet ihn als Programm und kommuniziert mit ihm über Standardein- und -ausgabe. Benötigt wird Python; Clients starten das Paket meist mit uvx (aus uv) oder nach pip install - der übliche Befehl lautet uvx pvliesdonk-paperless-mcp. Der Server liest diese Umgebungsvariablen: PAPERLESS_MCP_KV_STORE_URL, PAPERLESS_MCP_TOOLS_ALLOW, PAPERLESS_MCP_TOOLS_DENY, PAPERLESS_MCP_SERVER_NAME, PAPERLESS_MCP_INSTANCE_DESCRIPTION, PAPERLESS_MCP_INSTRUCTIONS_EXTRA, PAPERLESS_MCP_INSTRUCTIONS, PAPERLESS_MCP_LOG_LEVEL, PAPERLESS_MCP_LOG_FORMAT, PAPERLESS_MCP_PAPERLESS_URL, PAPERLESS_MCP_API_TOKEN (geheim), PAPERLESS_MCP_HTTP_TIMEOUT_SECONDS, PAPERLESS_MCP_HTTP_RETRIES, PAPERLESS_MCP_DEFAULT_PAGE_SIZE, PAPERLESS_MCP_PAPERLESS_PUBLIC_URL, PAPERLESS_MCP_TRANSFER_TTL_DEFAULT_S, PAPERLESS_MCP_TRANSFER_TTL_MAX_S, PAPERLESS_MCP_TRANSFER_GRACE_TTL_S, PAPERLESS_MCP_TRANSFER_LEASE_S und PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES; legen Sie sie in der Konfiguration des Clients für diesen Server fest.

Paperless MCP wird lokal ausgeführt, und zwar aus einem Container-Image in einer OCI-Registry wie Docker Hub oder GitHub Container Registry: ghcr.io/pvliesdonk/paperless-mcp:v3.0.0. Das Paket startet einen lokalen Server, der MCP über Streamable HTTP spricht; der Client verbindet sich dann per URL mit ihm. Der Server liest diese Umgebungsvariablen: PAPERLESS_MCP_SHUTDOWN_GRACE_S, PAPERLESS_MCP_BASE_URL, PAPERLESS_MCP_BEARER_TOKEN (geheim), PAPERLESS_MCP_OIDC_CONFIG_URL, PAPERLESS_MCP_OIDC_CLIENT_ID, PAPERLESS_MCP_OIDC_CLIENT_SECRET (geheim), PAPERLESS_MCP_OIDC_AUDIENCE, PAPERLESS_MCP_OIDC_REQUIRED_SCOPES, PAPERLESS_MCP_OIDC_ADVERTISED_SCOPES, PAPERLESS_MCP_OIDC_JWT_SIGNING_KEY (geheim), PAPERLESS_MCP_OIDC_VERIFY_ACCESS_TOKEN, PAPERLESS_MCP_KV_STORE_URL, PAPERLESS_MCP_APP_DOMAIN, PAPERLESS_MCP_TOOLS_ALLOW, PAPERLESS_MCP_TOOLS_DENY, PAPERLESS_MCP_AUTH_MODE, PAPERLESS_MCP_BEARER_TOKENS_FILE, PAPERLESS_MCP_BEARER_DEFAULT_SUBJECT, PAPERLESS_MCP_SERVER_NAME und PAPERLESS_MCP_INSTANCE_DESCRIPTION; legen Sie sie in der Konfiguration des Clients für diesen Server fest.

Im JSON-Format mcpServers, das viele MCP-Clients für Desktop und Editor lesen, sieht der Eintrag so aus (Platzhalter in spitzen Klammern):

{
  "mcpServers": {
    "paperless-mcp": {
      "command": "uvx",
      "args": [
        "pvliesdonk-paperless-mcp"
      ],
      "env": {
        "PAPERLESS_MCP_KV_STORE_URL": "<wert>",
        "PAPERLESS_MCP_TOOLS_ALLOW": "<wert>",
        "PAPERLESS_MCP_TOOLS_DENY": "<wert>",
        "PAPERLESS_MCP_SERVER_NAME": "<wert>",
        "PAPERLESS_MCP_INSTANCE_DESCRIPTION": "<wert>",
        "PAPERLESS_MCP_INSTRUCTIONS_EXTRA": "<wert>",
        "PAPERLESS_MCP_INSTRUCTIONS": "<wert>",
        "PAPERLESS_MCP_LOG_LEVEL": "<wert>",
        "PAPERLESS_MCP_LOG_FORMAT": "<wert>",
        "PAPERLESS_MCP_PAPERLESS_URL": "<wert>",
        "PAPERLESS_MCP_API_TOKEN": "<geheim>",
        "PAPERLESS_MCP_HTTP_TIMEOUT_SECONDS": "<wert>",
        "PAPERLESS_MCP_HTTP_RETRIES": "<wert>",
        "PAPERLESS_MCP_DEFAULT_PAGE_SIZE": "<wert>",
        "PAPERLESS_MCP_PAPERLESS_PUBLIC_URL": "<wert>",
        "PAPERLESS_MCP_TRANSFER_TTL_DEFAULT_S": "<wert>",
        "PAPERLESS_MCP_TRANSFER_TTL_MAX_S": "<wert>",
        "PAPERLESS_MCP_TRANSFER_GRACE_TTL_S": "<wert>",
        "PAPERLESS_MCP_TRANSFER_LEASE_S": "<wert>",
        "PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES": "<wert>"
      }
    }
  }
}

Abgeleitet aus dem Registry-Eintrag, hier nicht getestet. Was der Server tut und zu welchen Bedingungen, legt sein Herausgeber fest; prüfen Sie sein Repository oder seine Website, bevor Sie ihm Zugriff auf Ihre Konten oder Dateien geben. So fügen Sie einem Assistenten einen MCP-Server hinzu · Vor dem Verbinden