Skip to content

Commit 87ca682

Browse files
authored
Fix K8s guides (#57)
- New VS Code process - GoFetch uses streamable-http now - Fix supported K8s versions
1 parent 4a06b8e commit 87ca682

11 files changed

+30
-25
lines changed

docs/toolhive/guides-k8s/deploy-operator-helm.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Kubernetes cluster.
1010

1111
## Prerequisites
1212

13-
- A Kubernetes cluster (v1.19+)
13+
- A Kubernetes cluster (current and two previous minor versions are supported)
1414
- Permissions to create resources in the cluster
1515
- [`kubectl`](https://kubernetes.io/docs/tasks/tools/) configured to communicate
1616
with your cluster
@@ -62,7 +62,7 @@ and set a specific ToolHive version, create a `values.yaml` file:
6262
```yaml title="values.yaml"
6363
operator:
6464
replicaCount: 2
65-
toolhiveRunnerImage: ghcr.io/stacklok/toolhive:v0.0.42 # or `latest`
65+
toolhiveRunnerImage: ghcr.io/stacklok/toolhive:v0.1.8 # or `latest`
6666
```
6767
6868
Install the operator with your custom values:

docs/toolhive/guides-k8s/run-mcp-k8s.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ sidebar_position: 20
66

77
## Prerequisites
88

9-
- A Kubernetes cluster (v1.19+)
9+
- A Kubernetes cluster (current and two previous minor versions are supported)
1010
- Permissions to create resources in the cluster
1111
- [`kubectl`](https://kubernetes.io/docs/tasks/tools/) configured to communicate
1212
with your cluster
@@ -210,7 +210,7 @@ format, so you can use any valid pod specification options.
210210

211211
This example sets resource limits.
212212

213-
```yaml {13-14} title="my-mcpserver-custom-pod.yaml"
213+
```yaml {14-15} title="my-mcpserver-custom-pod.yaml"
214214
apiVersion: toolhive.stacklok.dev/v1alpha1
215215
kind: MCPServer
216216
metadata:

docs/toolhive/tutorials/toolhive-operator.mdx

Lines changed: 26 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -226,7 +226,7 @@ Configure Visual Studio Code to connect to your MCP server. Open VS Code and
226226
access your user settings:
227227

228228
1. Open the command palette (Cmd/Ctrl+Shift+P)
229-
2. Type "Preferences: Open User Settings (JSON)" and select it
229+
2. Type "MCP: Add Server..." and select it
230230

231231
<ThemedImage
232232
alt='VS Code user settings in command palette'
@@ -239,26 +239,31 @@ access your user settings:
239239
className='screenshot'
240240
/>
241241

242-
Add the MCP server configuration to your `settings.json` file. If you have
243-
existing settings, merge the following configuration into it:
244-
245-
```json
246-
{
247-
// Other existing settings...
248-
249-
"mcp": {
250-
"servers": {
251-
"fetch": {
252-
"url": "http://localhost:8080/sse#fetch",
253-
"type": "sse"
254-
}
255-
}
256-
}
257-
}
258-
```
242+
3. Select "HTTP" as the server type
243+
244+
4. Enter the server URL: `http://localhost:8080/mcp` and press Enter
245+
246+
5. Enter a name for the server (e.g., "fetch") and press Enter
247+
248+
6. Choose "Global" to add the server to your global settings
249+
250+
7. VS Code adds the server and opens the MCP settings file. It should look like
251+
this:
252+
253+
```json
254+
{
255+
"servers": {
256+
"fetch": {
257+
"url": "http://localhost:8080/mcp",
258+
"type": "http"
259+
}
260+
},
261+
"inputs": []
262+
}
263+
```
259264

260-
Save the file and click **Start** to initiate the connection. The indicator
261-
should change to "Running" and show "1 tools".
265+
To verify the connection, click **Start**. The indicator should change to
266+
"Running" and show "1 tools".
262267

263268
<ThemedImage
264269
alt='VS Code MCP settings'
@@ -315,7 +320,7 @@ retrieve the content and provide a summary.
315320
You're manually configuring VS Code to connect to your MCP server running in
316321
Kubernetes. The port-forward creates a tunnel from your local machine
317322
(port 8080) to the Kubernetes service, allowing GitHub Copilot to communicate
318-
with the server using the SSE (server-sent events) protocol.
323+
with the server using the Streamable HTTP protocol.
319324

320325
:::
321326

Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.

0 commit comments

Comments
 (0)