Safe-by-default MCP server for OpenShift / Kubernetes — projects, pods, logs, deployments, routes and more, with username/password (local IdP) or token auth.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add openshift --env OPENSHIFT_SERVER='<OPENSHIFT_SERVER>' --env OPENSHIFT_TOKEN='<OPENSHIFT_TOKEN>' --env OPENSHIFT_PASSWORD='<OPENSHIFT_PASSWORD>' -- npx -y @dockndevai/mcp-openshift~/.codex/config.toml
[mcp_servers.openshift]
command = "npx"
args = ["-y", "@dockndevai/mcp-openshift"]
env = { OPENSHIFT_SERVER = "<OPENSHIFT_SERVER>", OPENSHIFT_TOKEN = "<OPENSHIFT_TOKEN>", OPENSHIFT_PASSWORD = "<OPENSHIFT_PASSWORD>" }
# codex mcp add openshift --env OPENSHIFT_SERVER='<OPENSHIFT_SERVER>' --env OPENSHIFT_TOKEN='<OPENSHIFT_TOKEN>' --env OPENSHIFT_PASSWORD='<OPENSHIFT_PASSWORD>' -- npx -y @dockndevai/mcp-openshift~/.cursor/mcp.json
{
"mcpServers": {
"openshift": {
"command": "npx",
"args": [
"-y",
"@dockndevai/mcp-openshift"
],
"env": {
"OPENSHIFT_SERVER": "<OPENSHIFT_SERVER>",
"OPENSHIFT_TOKEN": "<OPENSHIFT_TOKEN>",
"OPENSHIFT_PASSWORD": "<OPENSHIFT_PASSWORD>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"openshift": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dockndevai/mcp-openshift"
],
"env": {
"OPENSHIFT_SERVER": "<OPENSHIFT_SERVER>",
"OPENSHIFT_TOKEN": "<OPENSHIFT_TOKEN>",
"OPENSHIFT_PASSWORD": "<OPENSHIFT_PASSWORD>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"openshift": {
"command": "npx",
"args": [
"-y",
"@dockndevai/mcp-openshift"
],
"env": {
"OPENSHIFT_SERVER": "<OPENSHIFT_SERVER>",
"OPENSHIFT_TOKEN": "<OPENSHIFT_TOKEN>",
"OPENSHIFT_PASSWORD": "<OPENSHIFT_PASSWORD>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"openshift": {
"command": "npx",
"args": [
"-y",
"@dockndevai/mcp-openshift"
],
"env": {
"OPENSHIFT_SERVER": "<OPENSHIFT_SERVER>",
"OPENSHIFT_TOKEN": "<OPENSHIFT_TOKEN>",
"OPENSHIFT_PASSWORD": "<OPENSHIFT_PASSWORD>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"openshift": {
"command": "npx",
"args": [
"-y",
"@dockndevai/mcp-openshift"
],
"env": {
"OPENSHIFT_SERVER": "<OPENSHIFT_SERVER>",
"OPENSHIFT_TOKEN": "<OPENSHIFT_TOKEN>",
"OPENSHIFT_PASSWORD": "<OPENSHIFT_PASSWORD>"
}
}
}
}Environment variables
OPENSHIFT_SERVEROPENSHIFT_TOKENOPENSHIFT_PASSWORD
Replace the placeholders with your own credentials and keep them out of version control.