Skip to content
Skills Library
AI & agents · Tool integration

claude-code-mcp-setup

/claude-code-mcp-setup

Add and configure MCP (Model Context Protocol) servers in Claude Code. Use when adding new MCP servers, configuring remote MCP, setting up OAuth MCP servers, troubleshooting MCP connections, or running /mcp diagnostics. Covers stdio, HTTP, and SSE transport types.

Licence
MIT
Last repository change
01.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
7
Deprecation

No signals detected. Repository changed on 01.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Add and configure MCP (Model Context Protocol) servers in Claude Code. Use when adding new MCP servers, configuring remote MCP, setting up OAuth MCP servers, troubleshooting MCP connections, or running /mcp diagnostics. Covers stdio, HTTP, and SSE transport types.

Original author description

Add and configure MCP (Model Context Protocol) servers in Claude Code. Use when adding new MCP servers, configuring remote MCP, setting up OAuth MCP servers, troubleshooting MCP connections, or running /mcp diagnostics. Covers stdio, HTTP, and SSE transport types.

How it works

  1. Purpose
  2. When to Use
  3. Quick Reference
  4. Common MCP Server Examples
  5. Configuration Files
  6. Troubleshooting
  7. Resources
Original SKILL.md headings · 162 lines, 494 words
SKILL.md preview
---
name: claude-code-mcp-setup
description: Add and configure MCP (Model Context Protocol) servers in Claude Code. Use when adding new MCP servers, configuring remote MCP, setting up OAuth MCP servers, troubleshooting MCP connections, or running /mcp diagnostics. Covers stdio, HTTP, and SSE transport types.
---

# Claude Code MCP Setup

## Purpose

Guide for adding and configuring MCP (Model Context Protocol) servers in Claude Code CLI.

## When to Use

- Adding a new MCP server to Claude Code
- Configuring remote MCP servers (HTTP/SSE)
- Troubleshooting MCP connection failures
- Understanding MCP transport types
- Setting up OAuth-authenticated MCP servers

## Quick Reference

### CLI Commands

```bash
# Add local stdio MCP server
claude mcp add <name> <command> [args...]

# Add remote HTTP MCP server (supports OAuth)
claude mcp add --transport http <name> <url>

# Add remote SSE MCP server
claude mcp add --transport sse <name> <url>

# Add with environment variables
claude mcp add <name> -e API_KEY=xxx -- <command> [args...]

# Add with custom headers
claude mcp add --transport http <name> <url> --header "Authorization: Bearer xxx"

# List configured servers
claude mcp list

# Remove a server
claude mcp remove <name>
```

### Transport Types

| Type | Use Case | Example |
|------|----------|---------|
| `stdio` | Local NPM packages, scripts | `claude mcp add my-server npx @org/mcp-server` |
| `http` | Remote servers with OAuth | `claude mcp add --transport http monday https://mcp.monday.com/mcp` |
| `sse` | Server-Sent Events servers | `claude mcp add --transport sse name https://example.com/sse` |

## Common MCP Server Examples

### monday.com (Remote HTTP with OAuth)

```bash
claude mcp add --transport http monday https://mcp.monday.com/mcp
```

After adding, restart Claude Code and run `/mcp`. First connection will prompt OAuth authorization in browser.

### GitHub (Local with Token)

```bash
claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxx -- npx @modelcontextprotocol/server-github
```

### Filesystem (Local)

```bash
claude mcp add filesystem npx @modelcontextprotocol/server-filesystem /path/to/directory
```

### Custom Local Server

```bash
claude mcp add my-server node /path/to/server.js
```

## Configuration Files

MCP servers are stored in:

- **User config**: `~/.claude.json` (global)
- **Project config**: `.mcp.json` (per-project, legacy)

### Manual Configuration (if needed)

```json
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["@org/mcp-package"],
      "env": {
        "API_KEY": "your-key"
      }
    }
  }
}
```

For remote servers:

```json
{
  "mcpServers": {
    "remote-server": {
      "type": "url",
      "url": "https://example.com/mcp"
    }
  }
}
```

## Troubleshooting

### Check MCP Status

```bash
# Inside Claude Code
/mcp

# Detailed diagnostics
/doctor
```

### Common Issues

**"Does not adhere to MCP server configuration schema"**
- Use `claude mcp add` CLI command instead of manual JSON editing
- Ensure correct transport type for remote servers

**"Failed to reconnect"**
- Check network connectivity
- Verify OAuth authorization completed
- Try removing and re-adding: `claude mcp remove <name> && claude mcp add ...`

**OAuth not prompting**
- Restart Claude Code after adding server
- Run `/mcp` to trigger connection
- Check browser for blocked popups

**Environment variable errors**
- Use `-e VAR=value` flag when adding
- Or set in shell before running Claude Code

### Verify Configuration

```bash
# Check what was added
cat ~/.claude.json | jq '.mcpServers'

# Validate JSON syntax
jq . ~/.claude.json
```

## Resources

- [Claude Code MCP Docs](https://code.claude.com/docs/en/mcp)
- [MCP Specification](https://modelcontextprotocol.io/)
- [MCP Server Registry](https://github.com/modelcontextprotocol/servers)

Versions

The database has no other skills named claude-code-mcp-setup.

Database snapshot: 13.11.2026 · package version 69662c2b47f7 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 1 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 95mcp-integration
    This skill should be used when the user asks to "add MCP server", "integrate MCP", "configure MCP in plugin", "use .mcp.json", "set up Model Context Protocol", "connect external service", mentions "${CLAUDE_PLUGIN_ROOT} with MCP", or discusses MCP server types (SSE, stdio, HTTP,…
  • 100mcp
    MCP (Model Context Protocol) servers and clients: tools, resources, prompts, stdio/HTTP transport, OAuth, tool poisoning. Use for writing a server or fixing a client.
  • 95mcp-integration
    This skill should be used when the user asks to "add MCP server", "integrate MCP", "configure MCP in plugin", "use .mcp.json", "set up Model Context Protocol", "connect external service", mentions "${CLAUDE_PLUGIN_ROOT} with MCP", or discusses MCP server types (SSE, stdio, HTTP,…
  • 80MCP Integration
    This skill should be used when the user asks to "add MCP server", "integrate MCP", "configure MCP in plugin", "use .mcp.json", "set up Model Context Protocol", "connect external service", mentions "${CLAUDE_PLUGIN_ROOT} with MCP", or discusses MCP server types (SSE, stdio, HTTP,…
  • 95mcp-integration
    This skill should be used when the user asks to "add MCP server", "integrate MCP", "configure MCP in plugin", "use .mcp.json", "set up Model Context Protocol", "connect external service", mentions "${CLAUDE_PLUGIN_ROOT} with MCP", or discusses MCP server types (SSE, stdio, HTTP,…
  • 100mcp-gateway
    Set up an MCP gateway that connects MCP servers over STDIO, HTTP, or SSE and serves all their tools from one /mcp endpoint to Claude Code, Cursor, Claude Desktop, and other MCP clients, using Bifrost, the open-source AI gateway by Maxim AI. Covers per-key tool filtering,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.