Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Cline error

Cline: Invalid MCP settings format

Error message
Invalid MCP settings format. Please ensure your settings follow the correct JSON format.

Status: WorkaroundLast verified 3 documented fixes4 sources

What it means

Cline could not validate cline_mcp_settings.json against its MCP settings schema, so no servers load.

Causes

  • Settings file that does not match the expected schema (for example a missing top-level "mcpServers" object).
  • Reported on 3.8.3 and 3.16.3 even after marketplace installs; consolidated by maintainers into the MCP system issues tracker #4391.

How to fix it

  1. Fix 1.

    Use the documented structure: a top-level "mcpServers" object, one entry per server. Local (STDIO) example from the docs:

    JSON
    {
      "mcpServers": {
        "local-server": {
          "command": "node",
          "args": ["/path/to/server.js"],
          "env": {
            "API_KEY": "your_api_key"
          },
          "disabled": false,
          "autoApprove": []
        }
      }
    }
  2. Fix 2.

    For remote servers, the docs say the "type" field selects the transport; omitting it defaults to legacy "sse", so set "type": "streamableHttp" explicitly.

    JSON
    "type": "streamableHttp"
  3. Fix 3.

    Update Cline: 4.0.0 "Migrate legacy MCP files and formats into the shared settings file and protect MCP settings writes with safer locking/atomic updates."

More Cline errors

All 17 Cline errors

FAQ

What does "Invalid MCP settings format" mean in Cline?

Cline could not validate cline_mcp_settings.json against its MCP settings schema, so no servers load.

How do I fix "Invalid MCP settings format"?

There are 3 documented fixes. Start with the first: Use the documented structure: a top-level "mcpServers" object, one entry per server. Local (STDIO) example from the docs:

Is this Cline error fixed?

Status: Workaround. No release removes the cause. The documented fixes work around it. Affected versions: Reported on 3.8.3 and 3.16.3

Sources

Last verified against 4 sources: official docs, maintainer replies and release notes.

Newsletter

Fixes for the tools you use, weekly

One email per week. New coding agent releases, what broke, and how developers are working around it.