From 9e412348ee3236ff7d7f8db0465c0284e1490987 Mon Sep 17 00:00:00 2001
From: Mason Williams <mason@onkernel.com>
Date: Wed, 3 Sep 2025 13:57:17 -0400
Subject: [PATCH 1/4] docs(mcp-server): update server config instructions

---
 reference/mcp-server.mdx | 41 ++++++++++++++++++++++------------------
 1 file changed, 23 insertions(+), 18 deletions(-)

diff --git a/reference/mcp-server.mdx b/reference/mcp-server.mdx
index 73a84b5..4373dd3 100644
--- a/reference/mcp-server.mdx
+++ b/reference/mcp-server.mdx
@@ -97,26 +97,23 @@ Click [here](goose://extension?cmd=npx&arg=-y&arg=mcp-remote&arg=https%3A%2F%2Fm
 {
   "mcpServers": {
     "kernel": {
-      "command": "npx",
-      "args": ["-y", "mcp-remote", "https://mcp.onkernel.com/mcp"]
+      "url": "https://mcp.onkernel.com/mcp",
+			"type": "http"
     }
   }
 }
 ```
 
-1. Press **⌘/Ctrl P** → search **MCP: Add Server**.
-2. Select **Command (stdio)**.
-3. Enter:
-   ```bash
-   npx -y mcp-remote https://mcp.onkernel.com/mcp
-   ```
+1. Press **⌘/Ctrl Shift P** → search **MCP: Add Server**.
+2. Select **HTTP (HTTP or Server-Sent Events)**.
+3. Enter: `https://mcp.onkernel.com/mcp`
 4. Name the server **Kernel** → Enter.
-5. Activate via **MCP: List Servers → Kernel → Start Server**.
+5. Click **Allow** when asked to authenticate to mcp.onkernel.com.
 
 ### Windsurf
 
 1. Press **⌘/Ctrl ,** to open settings.
-2. Go to **Cascade → MCP servers → Add custom server**.
+2. Navigate **Cascade → MCP servers → View raw config**.
 3. Paste:
 
 ```json
@@ -130,20 +127,20 @@ Click [here](goose://extension?cmd=npx&arg=-y&arg=mcp-remote&arg=https%3A%2F%2Fm
 }
 ```
 
+4. On **Manage MCPs**, click **Refresh** to load Kernel MCP.
+
 ### Zed
 
-Open `settings.json` and add:
+1. Press **⌘/Ctrl ,** to open settings.
+3. Paste:
 
 ```json
 {
   "context_servers": {
     "kernel": {
-      "command": {
-        "path": "npx",
-        "args": ["-y", "mcp-remote", "https://mcp.onkernel.com/mcp"],
-        "env": {}
-      },
-      "settings": {}
+      "source": "custom",
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://mcp.onkernel.com/mcp"]
     }
   }
 }
@@ -155,7 +152,15 @@ Many other MCP-capable tools accept:
 
 - **Command:** `npx`
 - **Arguments:** `-y mcp-remote https://mcp.onkernel.com/mcp`
-- **Environment:** _(none)_
+
+```json
+{
+  "kernel": {
+    "command": "npx",
+    "args": ["-y", "mcp-remote", "https://mcp.onkernel.com/mcp"]
+  }
+}
+```
 
 Configure these values wherever the tool expects MCP server settings.
 

From b1c488a8e79de9ab0818a60212e528ecb6b9d05a Mon Sep 17 00:00:00 2001
From: Mason Williams <mason@onkernel.com>
Date: Wed, 3 Sep 2025 13:58:46 -0400
Subject: [PATCH 2/4] docs: Remove redundant auth step in instructions

---
 reference/mcp-server.mdx | 1 -
 1 file changed, 1 deletion(-)

diff --git a/reference/mcp-server.mdx b/reference/mcp-server.mdx
index 4373dd3..5b7f395 100644
--- a/reference/mcp-server.mdx
+++ b/reference/mcp-server.mdx
@@ -108,7 +108,6 @@ Click [here](goose://extension?cmd=npx&arg=-y&arg=mcp-remote&arg=https%3A%2F%2Fm
 2. Select **HTTP (HTTP or Server-Sent Events)**.
 3. Enter: `https://mcp.onkernel.com/mcp`
 4. Name the server **Kernel** → Enter.
-5. Click **Allow** when asked to authenticate to mcp.onkernel.com.
 
 ### Windsurf
 

From 046f3078cb41404a597f90ccc891c3849f78055a Mon Sep 17 00:00:00 2001
From: Mason Williams <mason@onkernel.com>
Date: Wed, 3 Sep 2025 14:18:07 -0400
Subject: [PATCH 3/4] docs: Fix numbering and indent in examples

---
 reference/mcp-server.mdx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/mcp-server.mdx b/reference/mcp-server.mdx
index 5b7f395..9d6f05d 100644
--- a/reference/mcp-server.mdx
+++ b/reference/mcp-server.mdx
@@ -98,7 +98,7 @@ Click [here](goose://extension?cmd=npx&arg=-y&arg=mcp-remote&arg=https%3A%2F%2Fm
   "mcpServers": {
     "kernel": {
       "url": "https://mcp.onkernel.com/mcp",
-			"type": "http"
+      "type": "http"
     }
   }
 }
@@ -131,7 +131,7 @@ Click [here](goose://extension?cmd=npx&arg=-y&arg=mcp-remote&arg=https%3A%2F%2Fm
 ### Zed
 
 1. Press **⌘/Ctrl ,** to open settings.
-3. Paste:
+2. Paste:
 
 ```json
 {

From 07981208cdeadfc89f89abaed44bed1f0ce467f8 Mon Sep 17 00:00:00 2001
From: Mason Williams <mason@onkernel.com>
Date: Wed, 3 Sep 2025 14:38:09 -0400
Subject: [PATCH 4/4] docs: Update menu path for MCP server setup

---
 reference/mcp-server.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/mcp-server.mdx b/reference/mcp-server.mdx
index 9d6f05d..a033697 100644
--- a/reference/mcp-server.mdx
+++ b/reference/mcp-server.mdx
@@ -46,7 +46,7 @@ Click [here](cursor://anysphere.cursor-deeplink/mcp/install?name=kernel&config=e
 #### Manual setup
 
 1. Press **⌘/Ctrl Shift J**.
-2. Go to **Tools & Integrations → New MCP server**.
+2. Go to **MCP & Integrations → New MCP server**.
 3. Add this configuration:
 
 ```json