@cloudstreamsoftware/claude-tools 1.2.6 → 1.2.7

package/bin/cloudstream-setup.js

@@ -305,23 +305,30 @@ async function storeCredentials(licenseKey, installType) {
 
 /**
  * Configure MCP server connection
- * Merges into settings.json (same pattern as mergeHooksIntoSettings)
+ *
+ * IMPORTANT: VSCode Claude Code extension reads MCP servers from ~/.claude.json (NOT ~/.claude/settings.json)
+ * This is documented in GitHub Issue #4976 - settings.json is for hooks and permissions only.
+ *
+ * MCP server config locations:
+ * - ~/.claude.json (user scope) - for all projects, what VSCode reads
+ * - .mcp.json (project scope) - for specific project only
  */
 async function configureMcpServer(licenseKey) {
-  const settingsPath = path.join(CONFIG.claudeDir, 'settings.json');
+  // VSCode reads MCP servers from ~/.claude.json (NOT ~/.claude/settings.json)
+  const claudeJsonPath = path.join(os.homedir(), '.claude.json');
 
-  // Read existing settings or create empty object
-  let settings = {};
+  // Read existing config or create empty object
+  let config = {};
   try {
-    const content = await fs.readFile(settingsPath, 'utf8');
-    settings = JSON.parse(content);
+    const content = await fs.readFile(claudeJsonPath, 'utf8');
+    config = JSON.parse(content);
   } catch {
     // File doesn't exist, start fresh
   }
 
-  // Merge MCP server into settings
-  settings.mcpServers = settings.mcpServers || {};
-  settings.mcpServers['cloudstream-knowledge'] = {
+  // Add MCP server to the config
+  config.mcpServers = config.mcpServers || {};
+  config.mcpServers['cloudstream-knowledge'] = {
     command: 'npx',
     args: ['@cloudstreamsoftware/knowledge-mcp-client'],
     env: {
@@ -330,8 +337,8 @@ async function configureMcpServer(licenseKey) {
     }
   };
 
-  await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2));
-  logSuccess('MCP server configured in settings.json');
+  await fs.writeFile(claudeJsonPath, JSON.stringify(config, null, 2));
+  logSuccess('MCP server configured in ~/.claude.json');
 
   // Clean up orphaned mcp.json if it exists (from previous installs)
   const orphanedMcpPath = path.join(CONFIG.claudeDir, 'mcp.json');
@@ -341,6 +348,20 @@ async function configureMcpServer(licenseKey) {
   } catch {
     // File doesn't exist, nothing to clean up
   }
+
+  // Also clean up MCP config from settings.json if present (from older installs)
+  const settingsPath = path.join(CONFIG.claudeDir, 'settings.json');
+  try {
+    const settingsContent = await fs.readFile(settingsPath, 'utf8');
+    const settings = JSON.parse(settingsContent);
+    if (settings.mcpServers) {
+      delete settings.mcpServers;
+      await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2));
+      logSuccess('Cleaned up MCP config from settings.json (moved to ~/.claude.json)');
+    }
+  } catch {
+    // settings.json doesn't exist or is invalid, nothing to clean up
+  }
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudstreamsoftware/claude-tools",
-  "version": "1.2.6",
+  "version": "1.2.7",
   "description": "CloudStream Claude Code productivity tools - hooks, skills, agents, and knowledge server integration",
   "main": "dist/index.js",
   "bin": {