---
name: mcp-setup
description: Referenz für MCP-Server-Konfiguration in Claude Code – Einrichtung, Debugging, bekannte Server
---

# MCP-Setup Referenz

## Konfigurationsdatei
- **Global:** `~/.claude/mcp.json`
- **Projekt:** `<projekt>/.claude/mcp.json`

## Format
```json
{
  "mcpServers": {
    "<server-name>": {
      "command": "<binary>",
      "args": ["<arg1>", "<arg2>"],
      "env": {
        "API_KEY": "<value>"
      }
    }
  }
}
```

## Häufige Server-Typen

### Stdio-basiert (lokal)
```json
{
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/<server-name>"]
}
```

### SSE-basiert (remote)
```json
{
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://<url>/sse"]
}
```

## Debugging
1. `claude mcp list` – Zeigt alle konfigurierten Server
2. `claude mcp serve <name>` – Startet Server manuell zum Testen
3. Logs prüfen: `~/.claude/debug/`
4. Häufige Fehler:
   - **Server startet nicht:** Binary-Pfad prüfen, `npx` Cache leeren
   - **Auth-Fehler:** Token/API-Key in `env` prüfen
   - **Timeout:** Server braucht zu lange zum Starten → `timeout` erhöhen

## Checkliste neuer MCP-Server
- [ ] Server in `mcp.json` eintragen
- [ ] `claude mcp list` → Server erscheint
- [ ] Tool-Aufruf testen
- [ ] Bei Auth: Token sicher speichern (nicht in Git)

## Bekannte Server (Janinas Setup)
- Konfiguration in `~/.claude/mcp.json` pflegen
- Neue Server immer erst lokal testen bevor sie in Projekt-Config kommen