Clarifying experimental and allow_dml settings (#26)

* Update README.md

Clarified install instructions

* Update README.md

* Update README.md

uri clarification and project id requirement for cloud

* Update README.md

Co-authored-by: Aniket Kulkarni <aniket-s-kulkarni@users.noreply.github.com>

* Update README.md

Co-authored-by: Aniket Kulkarni <aniket-s-kulkarni@users.noreply.github.com>

* Update README.md

Co-authored-by: Aniket Kulkarni <aniket-s-kulkarni@users.noreply.github.com>

* Update settings.md

* Update settings.md

* Update README.md

---------

Co-authored-by: Aniket Kulkarni <aniket-s-kulkarni@users.noreply.github.com>

Author: alex-aidun-dremio

README.md

@@ -176,9 +176,9 @@ This file is located by default at `$HOME/.config/dremioai/config.yaml` but can
 dremio:
     uri: https://.... # the Dremio URI
     pat: "@~/ws/tokens/idl.token" # PAT can be put in a file and used here with @ prefix
-    # optional
-    # project_id: ....
-
+    project_id: <string> Project ID required for Dremio Cloud
+    enable_experimental: <bool> # Optional: Enable experimental features
+    allow_dml: <bool> # Optional: Allow MCP Server to create views in Dremio
 tools:
     server_mode: FOR_DATA_PATTERNS # the serverm
 

docs/settings.md

@@ -16,6 +16,8 @@ dremio:
   uri: https://api.dremio.cloud
   pat: your-pat-here
   project_id: project123
+  experimental_enabled: false
+  allow_dml: false
 tools:
   server_mode: FOR_SELF
 ```
@@ -53,6 +55,7 @@ dremio:
   pat: <string> # Personal Access Token
   project_id: <string> # Optional: Project ID for Dremio Cloud
   enable_experimental: <bool> # Optional: Enable experimental features
+  allow_dml: <bool> # Optional: Allow MCP Server to create views in Dremio
 ```
 
 URI can be specified as:
@@ -79,6 +82,8 @@ Server modes:
 -   `FOR_DATA_PATTERNS`: Data pattern analysis
 -   `EXPERIMENTAL`: Experimental features
 
+NOTE: if you intend to use experimental features you must also set experimental_enabled: true as shown above. 
+
 Multiple modes can be combined using comma separation: `FOR_SELF,FOR_PROMETHEUS`
 
 ### Prometheus Settings
@@ -139,8 +144,9 @@ Example:
 dremio:
   uri: "https://api.dremio.cloud"
   pat: "@~/tokens/dremio.pat"
-  project_id: "project123" # optional only for DC
-
+  project_id: "project123" # required only for DC
+  enable_experimental: <bool> # Optional: Enable experimental features
+  allow_dml: <bool> # Optional: Allow MCP Server to create views in Dremio
 tools:
   server_mode: "FOR_SELF,FOR_DATA_PATTERNS"