setup mcp config

Generate a .mcp.json file connecting Claude Code to the DataSurface MCP server in Kubernetes.

1|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/billynewport/demo_cokub_model --skill setup-mcp-config
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup mcp config
Source: https://github.com/billynewport/demo_cokub_model/tree/main/.claude/skills/setup-mcp-config
Command: npx skills add https://github.com/billynewport/demo_cokub_model --skill setup-mcp-config

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill creates a .mcp.json file to connect Claude Code to the DataSurface MCP server running in a Kubernetes cluster, enabling seamless MCP communication from the IDE.

Core Features & Use Cases

  • MCP configuration generation: Produce a correctly structured .mcp.json that points Claude Code to the MCP server.
  • NodePort discovery guidance: Walk through locating the MCP service NodePort in the target namespace.
  • Settings verification & activation: Ensure Claude Code is configured to enable the MCP server and prompt for a restart to apply changes.

Quick Start

  1. Find the MCP Service in your target namespace to obtain the NodePort: kubectl get service -n <namespace> -l app=demo-psp-mcp-server

  2. Create the .mcp.json at your project root using the discovered NodePort: { "mcpServers": { "datasurface": { "type": "sse", "url": "http://localhost:<nodeport>/sse" } } }

  3. Verify that Claude Code settings enable the MCP server:

  • Ensure .claude/settings.local.json includes: { "enableAllProjectMcpServers": true, "enabledMcpjsonServers": ["datasurface"] }
  1. Restart Claude Code (or start a new session) for the MCP server connection to take effect.

Frequently Asked Questions about setup mcp config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Claude Code to connect to a DataSurface MCP server in Kubernetes?

To configure Claude Code for DataSurface MCP, generate a `.mcp.json` file at your project root pointing to the MCP server's NodePort, then enable the server in Claude Code's local settings and restart the session.

What is the .mcp.json file structure for an SSE MCP server connection?

The `.mcp.json` structure requires an `mcpServers` object containing the server name, the `type` set to `sse`, and the `url` pointing to the MCP server's HTTP SSE endpoint with the correct NodePort.

How do I find the NodePort for a Kubernetes MCP service using kubectl?

Find the MCP service NodePort by running `kubectl get service` with the `-n` flag for your namespace and the `-l app=demo-psp-mcp-server` label selector to locate the running service.

Do I need kubectl access to set up an MCP configuration for Claude Code?

Yes, you need kubectl access to the target Kubernetes namespace to discover the running MCP service and its NodePort before generating the `.mcp.json` file for Claude Code.

Why is my MCP server not connecting in Claude Code after adding the .mcp.json file?

If the MCP server is not connecting, verify `.claude/settings.local.json` includes `enableAllProjectMcpServers: true` and lists your server in `enabledMcpjsonServers`, then restart Claude Code to apply changes.