Adding first set of user documentation

[matzew]

Adding initial set of document, adding a README as an overview for all of the content, and specific guides

• for kubernetes
• for agents, starting with 'claude code CLI'

Next PR will add VS code, similar to this blog

The Kubernetes guide is inspired by the referenced blog post, but does focus on just kubernetes

[matzew]

For other "agents", like VS Code, or even Claude Desktop, I think creating screenshots makes more sense, rather than for the initial "Claude Code CLI", @manusa

[manusa]

I'll check thoroughly in a bit.

In the meantime, and related to his PR, one of the things I wanted to do was to update the main README.md Getting Started section to be more like the one in https://github.com/microsoft/playwright-mcp, with collapsible sections for each MCP Host/Client.

In scope of this PR (since it's focusing on Claude Code), maybe we can already add a collapsible

<details>
<summary>Claude Code</summary>
Follow the [dedicated MCP getting started guide]($linkToClaudeCodeGettingStarted) in our [user documentation].($linkToDocs)
</details>

to the main README.md too.

[Cali0707]

This looks great @matzew ! One question is, can we mention somewhere that all of the serviceaccount/custom kubeconfig is not technically necessary, but is recommended?

[matzew]

Ah, sure! Sent from Gmail Mobile

…

On Mon 27. Oct 2025 at 13:41, Calum Murray ***@***.***> wrote: *Cali0707* left a comment (containers/kubernetes-mcp-server#411) <#411 (comment)> This looks great @matzew <https://github.com/matzew> ! One question is, can we mention somewhere that all of the serviceaccount/custom kubeconfig is not technically necessary, but is recommended? — Reply to this email directly, view it on GitHub <#411 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AABGPTWDYYR7HZCICB24CVD3ZYHHBAVCNFSM6AAAAACKJVUCFSVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTINJRGA4DIMBSGM> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[matzew]

@Cali0707 Added a note

[matzew]

@manusa added the collapsible section for this new document.

For a general overhaul, we can use a separate PR - but I like the pattern of doing these sections!

[manusa]

Besides the comment about the namespace flag, everything else looks good. Thx!!!

[matzew]

@manusa updated an rebased

[Cali0707]

LGTM from my end

@manusa @matzew do we want to throw up a GH pages site around these markdown files?

[manusa]

LGTM, thx!

[matzew]

do we want to throw up a GH pages site around these markdown files?

yes, but that is separate steps. I was thinking about that too

[manusa]

LGTM from my end

@manusa @matzew do we want to throw up a GH pages site around these markdown files?

There's an old branch of mine (https://github.com/containers/kubernetes-mcp-server/tree/doc/docusaurus) from when this was still a personal PoC.

I think we should create some sort of website but discuss exactly how we want to do this (also considering the downstream implications).