add-mcp 1.2.1 → 1.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 Add MCP servers to your favorite coding agents with a single command.
 
-Supports **Claude Code**, **Codex**, **Cursor**, **OpenCode**, **VSCode** and [5 more](#supported-agents).
+Supports **Claude Code**, **Codex**, **Cursor**, **OpenCode**, **VSCode** and [7 more](#supported-agents).
 
 ## Install an MCP Server
 
@@ -71,7 +71,7 @@ npx add-mcp https://mcp.example.com/mcp -a cursor -y --gitignore
 | `-n, --name <name>`      | Server name (auto-inferred if not provided)                              |
 | `-y, --yes`              | Skip all confirmation prompts                                            |
 | `--all`                  | Install to all agents                                                    |
-| `--gitignore`            | Add generated config files to `.gitignore`                                |
+| `--gitignore`            | Add generated config files to `.gitignore`                               |
 
 ### Additional Commands
 
@@ -102,12 +102,12 @@ The CLI automatically detects agents based on your environment:
 - Detects project-level config files (`.cursor/`, `.vscode/`, `.mcp.json`, etc.)
 - Selects detected agents (have project config in the current directory) by default
 - Shows detected agents plus all other supported agents for selection
-- Installs to project-level config files
 
 **With `-g` (global mode):**
 
 - Detects all globally-installed agents (including Claude Desktop, Codex, Zed)
-- All agents use global config
+- Selects detected agents by default
+- Shows detected agents plus all other supported agents for selection
 
 **No agents detected:**
 
@@ -130,29 +130,28 @@ Note that some agents like Cursor and opencode do not require the `type` informa
 ## HTTP Headers
 
 Use `--header` to pass custom headers for remote servers. The flag can be repeated.
-If you explicitly select agents that don't support headers, the install will error. Auto-detected installs skip unsupported agents with a warning.
-
-Agents that support headers: Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI, OpenCode, VS Code, Zed.
-Agents that do not support headers: Goose.
+Header support is available for remote installs across all supported agents.
 
 ## Supported Agents
 
 MCP servers can be installed to any of these agents:
 
-| Agent              | `--agent`            | Project Path            | Global Path                                                       |
-| ------------------ | -------------------- | ----------------------- | ----------------------------------------------------------------- |
-| Claude Code        | `claude-code`        | `.mcp.json`             | `~/.claude.json`                                                  |
-| Claude Desktop     | `claude-desktop`     | -                       | `~/Library/Application Support/Claude/claude_desktop_config.json` |
-| Codex              | `codex`              | `.codex/config.toml`    | `~/.codex/config.toml`                                            |
-| Cursor             | `cursor`             | `.cursor/mcp.json`      | `~/.cursor/mcp.json`                                              |
-| Gemini CLI         | `gemini-cli`         | `.gemini/settings.json` | `~/.gemini/settings.json`                                         |
-| Goose              | `goose`              | `.goose/config.yaml`    | `~/.config/goose/config.yaml`                                     |
-| GitHub Copilot CLI | `github-copilot-cli` | `.vscode/mcp.json`      | `~/.copilot/mcp-config.json`                                      |
-| OpenCode           | `opencode`           | `opencode.json`         | `~/.config/opencode/opencode.json`                                |
-| VS Code            | `vscode`             | `.vscode/mcp.json`      | `~/Library/Application Support/Code/User/mcp.json`                |
-| Zed                | `zed`                | `.zed/settings.json`    | `~/Library/Application Support/Zed/settings.json`                 |
-
-**Aliases:** `gemini` → `gemini-cli`, `github-copilot` → `vscode`
+| Agent                  | `--agent`            | Project Path            | Global Path                                                                                                     |
+| ---------------------- | -------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------- |
+| Cline VSCode Extension | `cline`              | -                       | `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` |
+| Cline CLI              | `cline-cli`          | -                       | `~/.cline/data/settings/cline_mcp_settings.json`                                                                |
+| Claude Code            | `claude-code`        | `.mcp.json`             | `~/.claude.json`                                                                                                |
+| Claude Desktop         | `claude-desktop`     | -                       | `~/Library/Application Support/Claude/claude_desktop_config.json`                                               |
+| Codex                  | `codex`              | `.codex/config.toml`    | `~/.codex/config.toml`                                                                                          |
+| Cursor                 | `cursor`             | `.cursor/mcp.json`      | `~/.cursor/mcp.json`                                                                                            |
+| Gemini CLI             | `gemini-cli`         | `.gemini/settings.json` | `~/.gemini/settings.json`                                                                                       |
+| Goose                  | `goose`              | `.goose/config.yaml`    | `~/.config/goose/config.yaml`                                                                                   |
+| GitHub Copilot CLI     | `github-copilot-cli` | `.vscode/mcp.json`      | `~/.copilot/mcp-config.json`                                                                                    |
+| OpenCode               | `opencode`           | `opencode.json`         | `~/.config/opencode/opencode.json`                                                                              |
+| VS Code                | `vscode`             | `.vscode/mcp.json`      | `~/Library/Application Support/Code/User/mcp.json`                                                              |
+| Zed                    | `zed`                | `.zed/settings.json`    | `~/Library/Application Support/Zed/settings.json`                                                               |
+
+**Aliases:** `cline-vscode` → `cline`, `gemini` → `gemini-cli`, `github-copilot` → `vscode`
 
 The CLI uses smart detection to find agents in your project directory and globally installed agents. See [Smart Detection](#smart-detection) for details.
 

package/dist/index.js

@@ -8,6 +8,7 @@ import { homedir as homedir3 } from "os";
 
 // src/types.ts
 var agentAliases = {
+  "cline-vscode": "cline",
   gemini: "gemini-cli",
   "github-copilot": "vscode"
 };
@@ -98,6 +99,19 @@ function getPlatformPaths() {
   }
 }
 var { appSupport, vscodePath, gooseConfigPath } = getPlatformPaths();
+var clineCliConfigPath = join2(
+  process.env.CLINE_DIR || join2(home, ".cline"),
+  "data",
+  "settings",
+  "cline_mcp_settings.json"
+);
+var clineExtensionConfigPath = join2(
+  vscodePath,
+  "globalStorage",
+  "saoudrizwan.claude-dev",
+  "settings",
+  "cline_mcp_settings.json"
+);
 var copilotConfigPath = join2(
   process.env.XDG_CONFIG_HOME || join2(home, ".copilot"),
   "mcp-config.json"
@@ -187,6 +201,28 @@ function transformCursorConfig(_serverName, config) {
   }
   return config;
 }
+function transformClineConfig(_serverName, config) {
+  if (config.url) {
+    const remoteConfig = {
+      url: config.url,
+      type: config.type === "sse" ? "sse" : "streamableHttp",
+      disabled: false
+    };
+    if (config.headers && Object.keys(config.headers).length > 0) {
+      remoteConfig.headers = config.headers;
+    }
+    return remoteConfig;
+  }
+  const localConfig = {
+    command: config.command,
+    args: config.args || [],
+    disabled: false
+  };
+  if (config.env && Object.keys(config.env).length > 0) {
+    localConfig.env = config.env;
+  }
+  return localConfig;
+}
 function transformGitHubCopilotCliConfig(_serverName, config, context) {
   if (context?.local) {
     return config;
@@ -214,6 +250,34 @@ function transformGitHubCopilotCliConfig(_serverName, config, context) {
   return localConfig;
 }
 var agents = {
+  cline: {
+    name: "cline",
+    displayName: "Cline VSCode Extension",
+    configPath: clineExtensionConfigPath,
+    projectDetectPaths: [],
+    // Global only - no project support
+    configKey: "mcpServers",
+    format: "json",
+    supportedTransports: ["stdio", "http", "sse"],
+    detectGlobalInstall: async () => {
+      return existsSync(dirname2(clineExtensionConfigPath));
+    },
+    transformConfig: transformClineConfig
+  },
+  "cline-cli": {
+    name: "cline-cli",
+    displayName: "Cline CLI",
+    configPath: clineCliConfigPath,
+    projectDetectPaths: [],
+    // Global only - no project support
+    configKey: "mcpServers",
+    format: "json",
+    supportedTransports: ["stdio", "http", "sse"],
+    detectGlobalInstall: async () => {
+      return existsSync(dirname2(clineCliConfigPath));
+    },
+    transformConfig: transformClineConfig
+  },
   "claude-code": {
     name: "claude-code",
     displayName: "Claude Code",
@@ -223,7 +287,6 @@ var agents = {
     configKey: "mcpServers",
     format: "json",
     supportedTransports: ["stdio", "http", "sse"],
-    supportsHeaders: true,
     detectGlobalInstall: async () => {
       return existsSync(join2(home, ".claude"));
     }
@@ -236,8 +299,8 @@ var agents = {
     // Global only - no project support
     configKey: "mcpServers",
     format: "json",
-    supportedTransports: ["stdio", "http", "sse"],
-    supportsHeaders: true,
+    supportedTransports: ["stdio"],
+    unsupportedTransportMessage: "Claude Desktop only supports local (stdio) servers via its config file. Add remote servers through Settings \u2192 Connectors in the app instead.",
     detectGlobalInstall: async () => {
       return existsSync(join2(appSupport, "Claude"));
     }
@@ -254,7 +317,6 @@ var agents = {
     configKey: "mcp_servers",
     format: "toml",
     supportedTransports: ["stdio", "http", "sse"],
-    supportsHeaders: true,
     detectGlobalInstall: async () => {
       return existsSync(join2(home, ".codex"));
     },
@@ -269,7 +331,6 @@ var agents = {
     configKey: "mcpServers",
     format: "json",
     supportedTransports: ["stdio", "http", "sse"],
-    supportsHeaders: true,
     detectGlobalInstall: async () => {
       return existsSync(join2(home, ".cursor"));
     },
@@ -284,7 +345,6 @@ var agents = {
     configKey: "mcpServers",
     format: "json",
     supportedTransports: ["stdio", "http", "sse"],
-    supportsHeaders: true,
     detectGlobalInstall: async () => {
       return existsSync(join2(home, ".gemini"));
     }
@@ -298,7 +358,6 @@ var agents = {
     configKey: "extensions",
     format: "yaml",
     supportedTransports: ["stdio", "http", "sse"],
-    supportsHeaders: true,
     detectGlobalInstall: async () => {
       return existsSync(gooseConfigPath);
     },
@@ -314,7 +373,6 @@ var agents = {
     localConfigKey: "servers",
     format: "json",
     supportedTransports: ["stdio", "http", "sse"],
-    supportsHeaders: true,
     detectGlobalInstall: async () => {
       return existsSync(dirname2(copilotConfigPath));
     },
@@ -329,7 +387,6 @@ var agents = {
     configKey: "mcp",
     format: "json",
     supportedTransports: ["stdio", "http", "sse"],
-    supportsHeaders: true,
     detectGlobalInstall: async () => {
       return existsSync(join2(home, ".config", "opencode"));
     },
@@ -344,7 +401,6 @@ var agents = {
     configKey: "servers",
     format: "json",
     supportedTransports: ["stdio", "http", "sse"],
-    supportsHeaders: true,
     detectGlobalInstall: async () => {
       return existsSync(vscodePath);
     }
@@ -358,7 +414,6 @@ var agents = {
     configKey: "context_servers",
     format: "json",
     supportedTransports: ["stdio", "http", "sse"],
-    supportsHeaders: true,
     detectGlobalInstall: async () => {
       const configDir = process.platform === "darwin" || process.platform === "win32" ? join2(appSupport, "Zed") : join2(appSupport, "zed");
       return existsSync(configDir);
@@ -943,7 +998,7 @@ function installServer(serverName, serverConfig, agentTypes, options = {}) {
 // package.json
 var package_default = {
   name: "add-mcp",
-  version: "1.2.1",
+  version: "1.3.0",
   description: "Add MCP servers to your favorite coding agents with a single command.",
   author: "Andre Landgraf <andre@neon.tech>",
   license: "Apache-2.0",
@@ -970,6 +1025,7 @@ var package_default = {
     "mcp",
     "model-context-protocol",
     "ai-agents",
+    "cline",
     "claude-code",
     "claude-desktop",
     "codex",
@@ -1077,7 +1133,7 @@ function parseHeaders(values) {
   return { headers, invalid };
 }
 program.name("add-mcp").description(
-  "Install MCP servers onto coding agents (Claude Code, Cursor, VS Code, OpenCode, Codex)"
+  "Install MCP servers for coding agents (Claude Code, Cursor, VS Code, OpenCode, Codex, and more \u2014 run list-agents for the full list)"
 ).version(version).argument("[target]", "MCP server URL (remote) or package name (local stdio)").option(
   "-g, --global",
   "Install globally (user-level) instead of project-level"
@@ -1092,10 +1148,7 @@ program.name("add-mcp").description(
   "HTTP header for remote servers (repeatable, 'Key: Value')",
   collect,
   []
-).option("-y, --yes", "Skip confirmation prompts").option("--all", "Install to all agents").option(
-  "--gitignore",
-  "Add generated project config files to .gitignore"
-).action(async (target, options) => {
+).option("-y, --yes", "Skip confirmation prompts").option("--all", "Install to all agents").option("--gitignore", "Add generated project config files to .gitignore").action(async (target, options) => {
   await main(target, options);
 });
 program.command("list-agents").description("List all supported coding agents").action(() => {
@@ -1336,10 +1389,14 @@ async function main(target, options) {
   );
   if (unsupportedAgents.length > 0) {
     const unsupportedNames = unsupportedAgents.map((a) => agents[a].displayName).join(", ");
+    const hints = unsupportedAgents.map((a) => agents[a].unsupportedTransportMessage).filter(Boolean);
     if (options.all) {
       p2.log.warn(
         `Skipping agents that don't support ${requiredTransport} transport: ${unsupportedNames}`
       );
+      for (const hint of hints) {
+        p2.log.info(hint);
+      }
       targetAgents = targetAgents.filter(
         (a) => isTransportSupported(a, requiredTransport)
       );
@@ -1351,34 +1408,10 @@ async function main(target, options) {
       p2.log.error(
         `The following agents don't support ${requiredTransport} transport: ${unsupportedNames}`
       );
-      process.exit(1);
-    }
-  }
-  const hasHeadersForRemote = isRemote && hasHeaderValues;
-  if (hasHeadersForRemote) {
-    const unsupportedHeaderAgents = targetAgents.filter(
-      (a) => !agents[a].supportsHeaders
-    );
-    if (unsupportedHeaderAgents.length > 0) {
-      const unsupportedNames = unsupportedHeaderAgents.map((a) => agents[a].displayName).join(", ");
-      const hasExplicitAgentSelection = hasExplicitAgentFlags || selectedViaPrompt;
-      if (hasExplicitAgentSelection) {
-        p2.log.error(
-          `The following agents don't support HTTP headers: ${unsupportedNames}`
-        );
-        process.exit(1);
+      for (const hint of hints) {
+        p2.log.info(hint);
       }
-      const supportedAgents = targetAgents.filter(
-        (a) => agents[a].supportsHeaders
-      );
-      if (supportedAgents.length === 0) {
-        p2.log.error("No selected agents support HTTP headers");
-        process.exit(1);
-      }
-      p2.log.warn(
-        `Skipping agents that don't support HTTP headers: ${unsupportedNames}`
-      );
-      targetAgents = supportedAgents;
+      process.exit(1);
     }
   }
   const hasSmartRouting = agentRouting.size > 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "add-mcp",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Add MCP servers to your favorite coding agents with a single command.",
   "author": "Andre Landgraf <andre@neon.tech>",
   "license": "Apache-2.0",
@@ -27,6 +27,7 @@
     "mcp",
     "model-context-protocol",
     "ai-agents",
+    "cline",
     "claude-code",
     "claude-desktop",
     "codex",