Review:

* note on recommendation about use SA versus exciting (default) kubeconfig
* adding a collapsible section
* removed incorrect args

Signed-off-by: Matthias Wessendorf <[email protected]>

Author: matzew

README.md

@@ -54,6 +54,15 @@ If you're using the native binaries you don't need to have Node or Python instal
 
 - Access to a Kubernetes cluster.
 
+<details>
+<summary><b>Claude Code</b></summary>
+
+Follow the [dedicated Claude Code getting started guide](docs/GETTING_STARTED_CLAUDE_CODE.md) in our [user documentation](docs/).
+
+For a secure production setup with dedicated ServiceAccount and read-only access, also review the [Kubernetes setup guide](docs/GETTING_STARTED_KUBERNETES.md).
+
+</details>
+
 ### Claude Desktop
 
 #### Using npx

docs/GETTING_STARTED_CLAUDE_CODE.md

@@ -88,20 +88,10 @@ to fetch and display the relevant information from your cluster:
 
 Common command-line flags you can add to the `args` array:
 
-| Flag | Description | Example |
-|------|-------------|---------|
-| `--read-only` | Enable read-only mode (recommended) | Already included above |
-| `--kubeconfig <path>` | Path to kubeconfig file | Use `KUBECONFIG` env var instead |
-| `--context <name>` | Use specific context from kubeconfig | `"--context", "my-cluster"` |
-| `--namespace <ns>` | Default namespace for operations | `"--namespace", "production"` |
-
-**Example with custom namespace:**
-
-```bash
-claude mcp add-json kubernetes-mcp-server \
-  '{"command":"npx","args":["-y","kubernetes-mcp-server@latest","--read-only","--namespace","production"],"env":{"KUBECONFIG":"'${HOME}'/.kube/mcp-viewer.kubeconfig"}}' \
-  -s user
-```
+| Flag | Description |
+|------|-------------|
+| `--read-only` | Enable read-only mode (recommended) |
+| `--kubeconfig <path>` | Path to kubeconfig file (or use `KUBECONFIG` env var) |
 
 ## Next Steps
 

docs/GETTING_STARTED_KUBERNETES.md

@@ -2,7 +2,9 @@
 
 This guide walks you through the foundational setup for using the Kubernetes MCP Server with your Kubernetes cluster. You'll create a dedicated, read-only ServiceAccount and generate a secure kubeconfig file that can be used with various MCP clients.
 
-> **Note:** After completing this guide, continue with the [Claude Code CLI guide](GETTING_STARTED_CLAUDE_CODE.md). See the [docs README](README.md) for all available guides.
+> **Note:** This setup is **recommended for production use** but not strictly required. The MCP Server can use your existing kubeconfig file (e.g., `~/.kube/config`), but using a dedicated ServiceAccount with limited permissions follows the principle of least privilege and is more secure.
+
+> **Next:** After completing this guide, continue with the [Claude Code CLI guide](GETTING_STARTED_CLAUDE_CODE.md). See the [docs README](README.md) for all available guides.
 
 ## What You'll Create