Paperless MCP

Paperless MCP se ejecuta en local a partir de un paquete de Python publicado en PyPI: pvliesdonk-paperless-mcp, versión 3.0.0. Usa MCP mediante stdio, así que el cliente lo inicia como programa y se comunica con él a través de la entrada y salida estándar. Necesita Python; los clientes suelen iniciarlo con uvx (de uv) o tras pip install - el comando habitual es uvx pvliesdonk-paperless-mcp. Lee estas variables de entorno: 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 (secreto), 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 y PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES; hay que definirlas en la configuración del cliente para este servidor.

Paperless MCP se ejecuta en local a partir de una imagen de contenedor en un registro OCI como Docker Hub o GitHub Container Registry: ghcr.io/pvliesdonk/paperless-mcp:v3.0.0. El paquete inicia un servidor local que usa MCP mediante Streamable HTTP; después, el cliente se conecta a él por URL. Lee estas variables de entorno: PAPERLESS_MCP_SHUTDOWN_GRACE_S, PAPERLESS_MCP_BASE_URL, PAPERLESS_MCP_BEARER_TOKEN (secreto), PAPERLESS_MCP_OIDC_CONFIG_URL, PAPERLESS_MCP_OIDC_CLIENT_ID, PAPERLESS_MCP_OIDC_CLIENT_SECRET (secreto), PAPERLESS_MCP_OIDC_AUDIENCE, PAPERLESS_MCP_OIDC_REQUIRED_SCOPES, PAPERLESS_MCP_OIDC_ADVERTISED_SCOPES, PAPERLESS_MCP_OIDC_JWT_SIGNING_KEY (secreto), 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 y PAPERLESS_MCP_INSTANCE_DESCRIPTION; hay que definirlas en la configuración del cliente para este servidor.

En el formato JSON mcpServers que leen muchos clientes MCP de escritorio y de editores de código, la entrada tiene este aspecto (marcadores de posición entre corchetes angulares):

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

Obtenido de la entrada del registro, sin probar aquí. Lo que hace el servidor, y en qué condiciones, lo determina su editor; conviene revisar su repositorio o sitio web antes de darle acceso a cuentas o archivos propios. Cómo añadir un servidor MCP a un asistente · Antes de conectar