The MCP Setup skill enables developers to configure and manage Model Context Protocol (MCP) servers within Claude Code. It facilitates seamless integration between Claude and external environments, including databases, APIs, and third-party services like GitHub, Slack, and Notion, using HTTP, SSE, or stdio transports to extend the AI's functional capabilities.

When should I use mcp-setup?

mcp-setup is useful in the following scenarios: • Database Connectivity: Connect Claude Code to PostgreSQL or MySQL databases to perform schema analysis, data querying, and troubleshooting directly from the terminal. • DevOps Integration: Link issue trackers like Jira or GitHub Issues to manage tasks, create PRs, and track bugs using natural language commands. • Team-Wide Configuration: Implement project-scoped MCP settings via .mcp.json to ensure all team members have access to the same set of standardized tools and APIs. • Local File System Access: Set up stdio-based servers to allow Claude to interact with local directories and specialized CLI tools for automated file processing. • Secure API Orchestration: Configure authenticated HTTP connections to internal company services, enabling Claude to fetch real-time data from proprietary APIs.

name	mcp-setup
description	Set up and configure MCP (Model Context Protocol) servers with Claude Code. Use when the user wants to connect Claude Code to external tools, databases, APIs, or services via MCP. Handles HTTP, SSE, and stdio server configurations with proper authentication.

MCP Setup Skill

This skill helps configure Model Context Protocol (MCP) servers to connect Claude Code to external tools, databases, and APIs.

What is MCP?

MCP (Model Context Protocol) is an open-source standard for AI-tool integrations. MCP servers give Claude Code access to:

Issue trackers (Jira, GitHub Issues)
Monitoring tools (Sentry, Statsig)
Databases (PostgreSQL, MySQL)
Design tools (Figma)
Communication (Slack, Gmail)
And hundreds more

Server Types

1. HTTP Servers (Recommended for remote)

Cloud-based services, most widely supported.

claude mcp add --transport http <name> <url>

# Example: Connect to Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# With Bearer token authentication
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

2. SSE Servers (Deprecated)

Use HTTP instead where available.

claude mcp add --transport sse <name> <url>

# Example: Connect to Asana
claude mcp add --transport sse asana https://mcp.asana.com/sse

3. Stdio Servers (Local processes)

Run as local processes on your machine.

claude mcp add --transport stdio <name> <command> [args...]

# Example: Airtable server
claude mcp add --transport stdio airtable --env AIRTABLE_API_KEY=YOUR_KEY \
  -- npx -y airtable-mcp-server

# Example: PostgreSQL database
claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://user:pass@localhost:5432/mydb"

Note: The -- separates Claude's flags from the server command.

Configuration Scopes

Scope	Storage	Use Case
`local`	`~/.claude.json` (project path)	Personal, project-specific
`project`	`.mcp.json` in project root	Team-shared via git
`user`	`~/.claude.json` (global)	Personal across all projects

# Add to specific scope
claude mcp add --transport http api --scope project https://api.example.com

Management Commands

# List all configured servers
claude mcp list

# Get details for a specific server
claude mcp get <name>

# Remove a server
claude mcp remove <name>

# Check server status (in Claude Code)
/mcp

Authentication

For OAuth 2.0 authentication:

Add the server: claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
In Claude Code, run: /mcp
Select "Authenticate" and follow browser prompts

Plugin MCP Servers

Plugins can bundle MCP servers. Create .mcp.json at plugin root:

{
  "mcpServers": {
    "plugin-server": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/my-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
      "env": {
        "API_KEY": "${API_KEY}"
      }
    }
  }
}

Or inline in plugin.json:

{
  "name": "my-plugin",
  "mcpServers": {
    "plugin-api": {
      "type": "http",
      "url": "https://api.example.com/mcp"
    }
  }
}

Project Shared Configuration

For team-shared servers, create .mcp.json in project root:

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "database": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@bytebase/dbhub", "--dsn", "${DATABASE_URL}"]
    }
  }
}

Environment Variable Expansion

Supported in .mcp.json:

${VAR} - Value of environment variable
${VAR:-default} - Value or default if not set

Works in: command, args, env, url, headers

Popular MCP Servers

Server	Type	Install Command
GitHub	HTTP	`claude mcp add --transport http github https://api.githubcopilot.com/mcp/`
Sentry	HTTP	`claude mcp add --transport http sentry https://mcp.sentry.dev/mcp`
Notion	HTTP	`claude mcp add --transport http notion https://mcp.notion.com/mcp`
Postgres	stdio	`claude mcp add --transport stdio db -- npx -y @bytebase/dbhub --dsn "..."`
Filesystem	stdio	`claude mcp add --transport stdio fs -- npx -y @modelcontextprotocol/server-filesystem /path`

Using MCP in Claude Code

Reference Resources

Type @ to see available resources from MCP servers:

> Analyze @github:issue://123

Execute Prompts

MCP prompts become slash commands:

> /mcp__github__list_prs
> /mcp__jira__create_issue "Bug title" high

Troubleshooting

Windows Users

Use cmd /c wrapper for npx:

claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package

Output Limits

Set MAX_MCP_OUTPUT_TOKENS for large outputs:

export MAX_MCP_OUTPUT_TOKENS=50000
claude

Timeout Issues

Increase startup timeout:

MCP_TIMEOUT=10000 claude

Setup Checklist

When setting up a new MCP server:

Choose appropriate transport (HTTP for remote, stdio for local)
Select correct scope (local/project/user)
Configure authentication if required
Set necessary environment variables
Test with /mcp command
Verify tools are available

mcp-setup

When & Why to Use This Skill

Use Cases