MCP Server Setup¶

Model Context Protocol Server verbinden und konfigurieren.

Was ist MCP?¶

MCP (Model Context Protocol) ist ein offener Standard für Tool-Integrationen:

┌─────────────┐     MCP      ┌─────────────┐
│ Claude Code │◄────────────►│ MCP Server  │
└─────────────┘              └─────────────┘
                                    │
                             ┌──────┴──────┐
                             ▼             ▼
                         Database      External API

Server hinzufügen¶

Via CLI¶

# HTTP Transport (empfohlen für Cloud-Services)
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Stdio Transport (für lokale Server)
claude mcp add --transport stdio my-server -- npx -y @some/mcp-server

# SSE Transport
claude mcp add --transport sse events https://api.example.com/mcp/sse

Via settings.json¶

{
  "mcpServers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"],
      "env": {
        "ALLOWED_PATHS": "/home/user/projects"
      }
    }
  }
}

Via .mcp.json (Projekt-spezifisch)¶

Im Projekt-Root:

{
  "mcpServers": {
    "project-db": {
      "command": "npx",
      "args": ["-y", "@my/mcp-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

Authentifizierung¶

Bearer Token¶

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer ${API_TOKEN}"

OAuth 2.0¶

/mcp

Öffnet OAuth-Flow für Server die es unterstützen.

Environment Variables¶

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

${VAR} wird aus Environment aufgelöst.

Server verwalten¶

Alle Server anzeigen¶

/mcp

Server entfernen¶

claude mcp remove notion

Server-Status prüfen¶

Check MCP server status

Transport-Typen¶

Transport	Use Case	Beispiel
HTTP	Cloud-Services	Notion, Slack APIs
SSE	Event-Streaming	Real-time Updates
Stdio	Lokale Server	Filesystem, Database

Scopes¶

Local (Default)¶

Nur für aktuelles Projekt:

claude mcp add --scope local myserver ...

Gespeichert in: ./.claude/mcp.json

User¶

Für alle Projekte des Users:

claude mcp add --scope user myserver ...

Gespeichert in: ~/.claude/mcp.json

Project¶

Wird mit Git committed:

claude mcp add --scope project myserver ...

Gespeichert in: ./.mcp.json

Troubleshooting¶

Server startet nicht¶

# Timeout erhöhen
export MCP_TIMEOUT=10000
claude

Oder in settings.json:

{
  "env": {
    "MCP_TIMEOUT": "10000"
  }
}

Connection Closed (Windows)¶

Windows braucht cmd /c Wrapper:

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

Output zu groß¶

Wenn MCP-Tool mehr als 10K Tokens zurückgibt:

{
  "env": {
    "MAX_MCP_OUTPUT_TOKENS": "50000"
  }
}

Auth-Fehler¶

/mcp

Re-authenticate über den OAuth-Flow.

Beliebte MCP Server¶

Server	Zweck	Installation
Filesystem	Datei-Operationen	`@modelcontextprotocol/server-filesystem`
GitHub	Issues, PRs, Repos	`@modelcontextprotocol/server-github`
PostgreSQL	DB-Queries	`@modelcontextprotocol/server-postgres`
Slack	Messages, Channels	Via Slack MCP
Notion	Pages, Databases	`https://mcp.notion.com/mcp`

Mehr unter: github.com/modelcontextprotocol