@mergesafe-io/connect 0.1.0 → 0.2.0

package/README.md

@@ -34,7 +34,7 @@ No dependencies, no telemetry, Node 18+.
 Not covered: Zed (its `settings.json` is JSONC with comments — a rewrite would
 destroy them; configure manually). For Claude Code CLI and Gemini CLI, use their
 built-in commands instead:
-`claude mcp add --transport sse mergesafe https://mcp.mergesafe.io/sse --header "Authorization: Bearer msk_…"`
+`claude mcp add --transport http mergesafe https://mcp.mergesafe.io/mcp --header "Authorization: Bearer msk_…"`
 
 ## Options
 

package/lib/clients.js

@@ -1,6 +1,10 @@
 /** Per-client knowledge: where the MCP config lives and what to write in it. */
 import path from "node:path";
 
+export const MCP_HTTP_URL = "https://mcp.mergesafe.io/mcp";
+// Legacy endpoint, kept for clients without solid Streamable HTTP support
+// (opencode: SSE-only "remote" type; cline: open transport bugs; continue:
+// header auth unverified on streamable-http). Revisit as they catch up.
 export const MCP_SSE_URL = "https://mcp.mergesafe.io/sse";
 export const SERVER_NAME = "mergesafe";
 
@@ -13,12 +17,13 @@ const CLIENTS = {
     label: "Claude Desktop",
     rootKey: "mcpServers",
     configPath: (ctx) => claudeDesktopConfigPath(ctx),
-    // Claude Desktop has no native SSE + Bearer support; bridge via
-    // mcp-remote. No space after "Authorization:" and env-expanded token —
-    // both required by mcp-remote arg parsing.
+    // Claude Desktop has no native remote + Bearer support; bridge via
+    // mcp-remote (http-first: tries Streamable HTTP, falls back to SSE).
+    // No space after "Authorization:" and env-expanded token — both
+    // required by mcp-remote arg parsing.
     buildEntry: (key) => ({
       command: "npx",
-      args: ["mcp-remote", MCP_SSE_URL, "--header", "Authorization:Bearer ${AUTH_TOKEN}"],
+      args: ["mcp-remote", MCP_HTTP_URL, "--header", "Authorization:Bearer ${AUTH_TOKEN}"],
       env: { AUTH_TOKEN: key },
     }),
     restartHint: "Fully quit and reopen Claude Desktop (needs Node.js 18+ for npx).",
@@ -30,21 +35,22 @@ const CLIENTS = {
       ctx.project
         ? path.join(ctx.cwd, ".cursor", "mcp.json")
         : path.join(ctx.home, ".cursor", "mcp.json"),
-    buildEntry: (key) => ({ url: MCP_SSE_URL, headers: bearer(key) }),
+    // Cursor auto-detects Streamable HTTP from the URL (SSE fallback built in).
+    buildEntry: (key) => ({ url: MCP_HTTP_URL, headers: bearer(key) }),
     restartHint: "Restart Cursor or reload the window.",
   },
   windsurf: {
     label: "Windsurf",
     rootKey: "mcpServers",
     configPath: (ctx) => path.join(ctx.home, ".codeium", "windsurf", "mcp_config.json"),
-    buildEntry: (key) => ({ serverUrl: MCP_SSE_URL, headers: bearer(key) }),
+    buildEntry: (key) => ({ serverUrl: MCP_HTTP_URL, headers: bearer(key) }),
     restartHint: "Fully quit and reopen Windsurf.",
   },
   vscode: {
     label: "VS Code (project)",
     rootKey: "servers",
     configPath: (ctx) => path.join(ctx.cwd, ".vscode", "mcp.json"),
-    buildEntry: (key) => ({ type: "sse", url: MCP_SSE_URL, headers: bearer(key) }),
+    buildEntry: (key) => ({ type: "http", url: MCP_HTTP_URL, headers: bearer(key) }),
     restartHint: "Open mcp.json in VS Code and press the “Start” CodeLens.",
   },
   opencode: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mergesafe-io/connect",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "One-command MergeSafe MCP setup for Claude Desktop, Cursor, Windsurf, VS Code and opencode.",
   "keywords": ["mergesafe", "mcp", "model-context-protocol", "installer"],
   "homepage": "https://app.mergesafe.io",