feat: add stateless configuration

Author: rahulguptajss

cmd/cmds.go

@@ -2,13 +2,14 @@ package cmd
 
 import (
 	"fmt"
-	"github.com/alecthomas/kong"
-	"github.com/netapp/ontap-mcp/config"
-	"github.com/netapp/ontap-mcp/server"
 	"log/slog"
 	"os"
 	"path/filepath"
 	"strings"
+
+	"github.com/alecthomas/kong"
+	"github.com/netapp/ontap-mcp/config"
+	"github.com/netapp/ontap-mcp/server"
 )
 
 var logger = setupLogger()
@@ -29,7 +30,7 @@ type StartCmd struct {
 	Port           int    `default:"8080" help:"Listening port" env:"ONTAP_MCP_PORT"`
 	InspectTraffic bool   `default:"false" help:"Inspect MCP HTTP traffic"`
 	ReadOnly       bool   `default:"false" help:"Run MCP in read-only mode. This disables all tool calls that modify ONTAP state."`
-	Stateless      bool   `default:"false" help:"Run in stateless mode (no Mcp-Session-Id tracking). Required when deploying behind proxies or gateways that don't preserve session headers, e.g. Power Platform on-premises data gateway."`
+	Stateless      bool   `default:"false" help:"Run in stateless mode (no mcp-session-id header validation). Required when deploying behind proxies or gateways that don't preserve session headers, e.g. on-premises data gateways."`
 }
 
 func (a *StartCmd) Run(cli *CLI) error {

docs/install.md

@@ -134,7 +134,7 @@ Some commonly used flags:
 | Flag | Description |
 |---|---|
 | `--read-only` | Disable all mutating operations. Only read-only tools are registered. |
-| `--stateless` | Disable `Mcp-Session-Id` tracking. Required when deploying behind proxies or gateways that do not preserve session headers. |
+| `--stateless` | Disable mcp-session-id header validation. Required when deploying behind proxies or gateways that do not preserve session headers, e.g. on-premises data gateways. |
 | `--inspect-traffic` | Log all MCP HTTP request and response bodies for debugging. |
 
 ## Next Steps

docs/tools.md

@@ -8,7 +8,7 @@ All ONTAP MCP tools are annotated with hint metadata: `readOnlyHint`, `idempoten
 
 If you want to run the ONTAP MCP server in read-only mode, you can start the server with the `--read-only` flag. In this mode, only tools with the `readOnlyHint` will be available for use, ensuring that no modifications can be made to the ONTAP cluster.
 
-To run without session tracking (e.g. behind proxies that strip headers), use the `--stateless` flag. See the [configuration documentation](install.md#configuration) for more details.
+To run without mcp-session-id header validation (e.g. behind proxies that strip session headers), use the `--stateless` flag. See the [configuration documentation](install.md#configuration) for more details.
 
 ## API Discovery
 

server/server.go

@@ -80,7 +80,7 @@ func (a *App) StartServer() {
 		a.logger.Info("MCP server is running in read-only mode; mutating operations are disabled")
 	}
 	if a.options.Stateless {
-		a.logger.Info("MCP server is running in stateless mode; Mcp-Session-Id tracking is disabled")
+		a.logger.Info("MCP server is running in stateless mode; mcp-session-id header validation is disabled")
 	}
 	server := a.createMCPServer()
 	a.runHTTPServer(server)