Paperless MCP

Paperless MCP draait lokaal vanuit een Python-pakket dat op PyPI is gepubliceerd: pvliesdonk-paperless-mcp, versie 3.0.0. Hij spreekt MCP via stdio, dus de client start hem als programma en communiceert ermee via standaardinvoer en -uitvoer. Hij vereist Python; clients starten het meestal met uvx (uit uv) of na pip install - het gebruikelijke commando is uvx pvliesdonk-paperless-mcp. Hij leest deze omgevingsvariabelen: 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 en PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES; stel ze in de configuratie van de client voor deze server in.

Paperless MCP draait lokaal vanuit een containerimage in een OCI-register zoals Docker Hub of GitHub Container Registry: ghcr.io/pvliesdonk/paperless-mcp:v3.0.0. Het pakket start een lokale server die MCP spreekt via Streamable HTTP; de client maakt er vervolgens verbinding mee via een URL. Hij leest deze omgevingsvariabelen: 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 en PAPERLESS_MCP_INSTANCE_DESCRIPTION; stel ze in de configuratie van de client voor deze server in.

In het JSON-formaat mcpServers, dat veel MCP-clients voor desktop en code-editors lezen, ziet de vermelding er zo uit (tijdelijke aanduidingen tussen punthaken):

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

Afgeleid van de registervermelding, hier niet getest. Wat de server doet en onder welke voorwaarden, bepaalt de uitgever; bekijk de repository of website voordat je de server toegang geeft tot je accounts of bestanden. Een MCP-server aan een assistent toevoegen · Voordat je verbinding maakt