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
- Open the Cline sidebar → MCP Servers → Configure MCP Servers.
- Add servers under `mcpServers`; give remote ones `type` and `url`.
- 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
{
"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