Paperless MCP

Paperless MCP viene eseguito in locale a partire da un pacchetto Python pubblicato su PyPI: pvliesdonk-paperless-mcp, versione 3.0.0. Comunica via MCP su stdio, quindi il client lo avvia come programma e dialoga con esso tramite standard input e standard output. Richiede Python; i client in genere lo avviano con uvx (di uv) o dopo pip install - il comando abituale è uvx pvliesdonk-paperless-mcp. Legge queste variabili d’ambiente: 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 (segreto), 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 e PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES; vanno impostate nella configurazione del client per questo server.

Paperless MCP viene eseguito in locale a partire da un’immagine container in un registro OCI come Docker Hub o GitHub Container Registry: ghcr.io/pvliesdonk/paperless-mcp:v3.0.0. Il pacchetto avvia un server locale che comunica via MCP su Streamable HTTP; il client vi si collega poi tramite URL. Legge queste variabili d’ambiente: PAPERLESS_MCP_SHUTDOWN_GRACE_S, PAPERLESS_MCP_BASE_URL, PAPERLESS_MCP_BEARER_TOKEN (segreto), PAPERLESS_MCP_OIDC_CONFIG_URL, PAPERLESS_MCP_OIDC_CLIENT_ID, PAPERLESS_MCP_OIDC_CLIENT_SECRET (segreto), PAPERLESS_MCP_OIDC_AUDIENCE, PAPERLESS_MCP_OIDC_REQUIRED_SCOPES, PAPERLESS_MCP_OIDC_ADVERTISED_SCOPES, PAPERLESS_MCP_OIDC_JWT_SIGNING_KEY (segreto), 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 e PAPERLESS_MCP_INSTANCE_DESCRIPTION; vanno impostate nella configurazione del client per questo server.

Nel formato JSON mcpServers, letto da molti client MCP desktop e per editor di codice, la voce si presenta così (segnaposto tra parentesi angolari):

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

Ricavato dalla voce del registro, non testato qui. Cosa fa il server, e a quali condizioni, lo stabilisce il suo editore; prima di concedergli l’accesso ai propri account o file conviene consultarne il repository o il sito web. Come aggiungere un server MCP a un assistente · Prima di collegare un server