MCP-Konfigurations-JSON-Fehler: Häufige Fehler beheben

Ungültiges JSON in Ihrer MCP-Konfigurationsdatei verhindert das Laden der Server. Diese fehlerorientierte Anleitung zeigt, wie Sie häufige JSON-Syntaxfehler, Schemafehler und Formatierungsprobleme erkennen und beheben – mit Beispielen für falsche und korrekte Schreibweise.

Häufige JSON-Fehler

Das sind die häufigsten Fehler, die MCP-Konfigurationsdateien ungültig machen:

Fehler 1: Nachgestellte Kommas

Ungültig (nachgestelltes Komma)

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      },  ← Nachgestelltes Komma hier!
    }
  }
}

Gültig (kein nachgestelltes Komma)

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Fehler 2: Fehlende Anführungszeichen

Ungültig (Schlüssel ohne Anführungszeichen)

{
  mcpServers: {  ← Fehlende Anführungszeichen
    corcava: {   ← Fehlende Anführungszeichen
      url: "https://app.corcava.com/mcp",
      headers: {
        Authorization: "Bearer YOUR_API_KEY"
      }
    }
  }
}

Gültig (alle Schlüssel in Anführungszeichen)

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Fehler 3: Falsche Verschachtelung

Ungültig (nicht passende Klammern)

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }  ← Fehlende schließende Klammer
  }  ← Fehlende schließende Klammer
}

Gültig (korrekte Verschachtelung)

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Fehler 4: Kommentare in JSON

Ungültig (JSON unterstützt keine Kommentare)

{
  // Dies ist ein Kommentar – nicht erlaubt!
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",  /* Noch ein Kommentar */
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Gültig (keine Kommentare)

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Fehler 5: Einfache statt doppelte Anführungszeichen

Ungültig (einfache Anführungszeichen)

{
  'mcpServers': {  ← Einfache Anführungszeichen
    'corcava': {
      'url': 'https://app.corcava.com/mcp',
      'headers': {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    }
  }
}

Gültig (doppelte Anführungszeichen)

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Header-Formatierungsfehler

Häufige Fehler bei der Formatierung des Authorization-Headers:

Fehler: Fehlendes "Bearer "-Präfix

Ungültig (ohne Bearer-Präfix)

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"  ← Fehlendes "Bearer "
      }
    }
  }
}

Gültig (mit Bearer-Präfix)

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"  ← Korrektes Format
      }
    }
  }
}

Fehler: Zusätzliche Leerzeichen oder Zeilenumbrüche

Ungültig (zusätzliche Leerzeichen)

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer  YOUR_API_KEY"  ← Zusätzliches Leerzeichen
      }
    }
  }
}

Gültig (korrekte Abstände)

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"  ← Ein Leerzeichen nach "Bearer"
      }
    }
  }
}

Schema-Validierungsfehler

Auch gültiges JSON kann Schemafehler haben, wenn die Struktur nicht den MCP-Anforderungen entspricht:

Fehler: Fehlende Pflichtfelder

Ungültig (URL fehlt)

{
  "mcpServers": {
    "corcava": {
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
      ← Feld "url" fehlt
    }
  }
}

Fehler: Falsche Feldnamen

Ungültig (falscher Feldname)

{
  "mcpServers": {
    "corcava": {
      "endpoint": "https://app.corcava.com/mcp",  ← Sollte "url" sein
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Beispiel einer funktionierenden Corcava-Konfiguration

Hier eine vollständige, funktionierende Konfigurationsdatei für Corcava MCP:

Vollständige funktionierende Konfiguration

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Ersetzen Sie YOUR_API_KEY durch Ihren tatsächlichen Corcava-API-Schlüssel.

Mehrere MCP-Server

Bei mehreren MCP-Servern fügen Sie sie in dieselbe Konfiguration ein:

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_CORCAVA_API_KEY"
      }
    },
    "other-server": {
      "url": "https://other-server.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_OTHER_API_KEY"
      }
    }
  }
}

So validieren Sie Ihr JSON

Validieren Sie die JSON-Syntax, bevor Sie die Konfigurationsdatei speichern:

Online-Validatoren

JSONLint – JSON einfügen und validieren
JSON Formatter – Formatieren und validieren
JSON Formatter & Validator – Detaillierte Fehlermeldungen

Kommandozeile (macOS/Linux)

python3 -m json.tool config.json

Damit wird Ihr JSON validiert und formatiert oder bei Ungültigkeit ein Fehler angezeigt.

VS Code

VS Code validiert JSON-Dateien automatisch. Bei ungültigem JSON werden rote Wellenlinien und Fehlermeldungen angezeigt.

Schnell-Checkliste

Vor dem Speichern der Konfiguration

✅ Alle Schlüssel stehen in doppelten Anführungszeichen
✅ Keine nachgestellten Kommas
✅ Alle Klammern und geschweiften Klammern sind zugeordnet
✅ Keine Kommentare (// oder /* */)
✅ Authorization-Header hat "Bearer "-Präfix mit einem Leerzeichen
✅ URL-Feld ist vorhanden und korrekt
✅ JSON wird in einem Online-Validator als gültig erkannt