Setup guide

How to add an MCP server to Cline

Cline keeps its servers in `cline_mcp_settings.json`, opened from the MCP Servers panel. Remote servers need an explicit `type` of `streamableHttp` or `sse`.

Where the config lives

  • VS Code extension storage: cline_mcp_settings.json (Cline → MCP Servers → Configure)

Servers go under the mcpServers key.

What Cline can run

  • Local servers (stdio)
  • Remote servers (HTTP)
  • Remote servers (SSE)

504 of the 508 servers in the catalog run natively in Cline.

Step by step

  1. Open the Cline sidebar → MCP Servers → Configure MCP Servers.
  2. Add servers under `mcpServers`; give remote ones `type` and `url`.
  3. Save — Cline restarts the server automatically.

Reloading: Cline reloads on save; use the restart button next to a server to retry it.

Example: the Filesystem server in Cline

The official reference server for file access. Replace the directory with the folder you want the assistant to see.

Add the server

json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/directory"
      ]
    }
  }
}

Troubleshooting

`npx` is not found, or the server exits immediately on Windows
Windows launches `npx` through cmd. Use `"command": "cmd"` with `"args": ["/c", "npx", "-y", "<package>"]`, and make sure Node.js 18+ is on the PATH of the user the client runs as.
`SyntaxError` or `Unsupported engine` when the server starts
Most MCP servers need Node.js 18 or newer (`node -v`). If you use nvm, the client may not see your shell's Node: point `command` at the absolute path of `npx`.
The server starts but every tool call fails with 401 or 403
Its API key is missing or wrong. Put it in the server's `env` block (or the header for remote servers) — never in a file you commit.

Official documentation: Cline MCP docs

Setting up several servers at once?

Tick them in the catalog and the setup builder merges them into one Cline config.

Open the setup builder for Cline

Best MCP servers for Cline

The highest health scores among servers that run natively in Cline.

See every server that runs in Cline →