feat: extends documentation

Author: Sandro Lange

README.md

@@ -19,6 +19,8 @@ A .NET 8 Web API that integrates with [Paperless-ngx](https://github.com/paperle
   - **/api/Export**       -> uses multiple filters via query parameters (see swagger) and returns a compress zip file containing the documents and a metadata.xlsx file
   - **/api/Export/view**  -> exports a saved view (user defined) and returns the same zip. Query parameters, ordering and so on is taken from the configured settings of the corresponding view
 - Exposes an OpenAPI compatible Swagger Documentation at /swagger
+- can store documents and excel metadata of saved views and return an url to download them later (one time download link)
+- provides a first version of a Mcp Server which allows to export saved views by name and/or id
 
 Saved Views can be created by a user inside the Paperless UI. When exporting using this api we apply the most common filters from the view and try to export the metadata as accurate as possible.
 
@@ -38,9 +40,65 @@ The following additional environment variables are optional but useful:
 
 **EXCEL__NUMBER_FORMAT** <- how to format numbers in Excel, can be a valid number mask like 0.00 (2 decimal places)
 
+**STORAGE__DATA_PATH** <- where to store files for one-time downloads (see McpServer section)
 
 There are pre-built Docker-Images for amd64 and arm64:
 
 docker.io/mctristan/paperless-export-api
 
 use the :latest tag for the latest release, the corresponding version tag (i.e. v0.0.1) for a specific version.
+
+## MCP Server
+
+#### Note: 
+The Model Context Protocol support is an early trial as the protocol is rather new and the tool supported rather limited.
+There is no docker support for the McpServer part yet so you have to have a dotnet runtime installed and you would need to check out the source and configure your favorite Ai tool to use the server.
+
+A sample Claude configuration could look like this:
+
+in `claude_desktop_config.json`
+```
+{
+  "mcpServers": {
+    "paperless-saved-view-exporter": {
+      "command": "/Users/myusername/.dotnet/dotnet",
+      "args": [
+        "run",
+        "--project",
+        "/Users/myusername/Desktop/Projects/ExportPaperless/ExportPaperless.McpServer",
+        "--no-build"
+      ],      
+      "env": {        
+        "MCP__EXPORT_PAPERLESS_API_URL": "http://localhost:5288/"
+      }
+    }
+  }
+}
+```
+
+Of course the ExportPaperless API needs to be running (i.e. as docker image or via dotnet run) as long as you want to use the McpServer tool.
+
+Unfortunately Claude AI is not very helpful with error handling at the moment, you will most of the time only get an "invocation error" - that's it.
+Make sure your environment variables are correct (both in your paperless export api and the claude configuration file).
+
+Make also sure you allow the access to the various tools (i.e.: always allow).
+
+A sample query for Claude would then be:
+
+```
+Can you help me export the documents of my saved view Invoices 2024 from my paperless instance?
+```
+
+or
+
+```
+Can you export invoices from paperless for me?
+```
+
+or
+
+```
+Can you export the saved view Invoices 2024 as excel for me?
+```
+
+I guess you get the idea. What you will get in return (if everything works out) is a URL of .zip or .xlsx file which you can download (one time download).