Skip to content

Commit 7201d00

Browse files
authored
Update VS Code compatibility (#69)
1 parent d2083b4 commit 7201d00

File tree

2 files changed

+30
-44
lines changed

2 files changed

+30
-44
lines changed

docs/toolhive/_partials/_client-compat-table.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
1-
| Client | Supported | Auto-configuration | Notes |
2-
| -------------------------- | :-------: | :----------------: | ---------------------------------------------------- |
3-
| GitHub Copilot (VS Code) ||| v1.100+ or Insiders version (v1.102+, [see note][3]) |
4-
| Cursor ||| v0.50.0+ |
5-
| Roo Code (VS Code) ||| v3.19.2+ |
6-
| Cline (VS Code) ||| v3.8.5+ (sse only; streamable-http [issue][2]) |
7-
| Claude Code CLI ||| v1.0.27+ |
8-
| GitHub Copilot (JetBrains) ||| v1.5.47+ |
9-
| Continue (VS Code) ||| v1.0.14+ |
10-
| Continue (JetBrains) ||| v1.0.23+ |
11-
| PydanticAI ||| v0.2.18+ |
12-
| ChatGPT Desktop ||| See [workaround for STDIO-only clients][4] |
13-
| Claude Desktop ||| See [workaround for STDIO-only clients][4] |
14-
| Kiro ||| See [workaround for STDIO-only clients][4] |
1+
| Client | Supported | Auto-configuration | Notes |
2+
| -------------------------- | :-------: | :----------------: | ---------------------------------------------- |
3+
| GitHub Copilot (VS Code) ||| v1.102+ or Insiders version ([see note][3]) |
4+
| Cursor ||| v0.50.0+ |
5+
| Roo Code (VS Code) ||| v3.19.2+ |
6+
| Cline (VS Code) ||| v3.8.5+ (sse only; streamable-http [issue][2]) |
7+
| Claude Code CLI ||| v1.0.27+ |
8+
| GitHub Copilot (JetBrains) ||| v1.5.47+ |
9+
| Continue (VS Code) ||| v1.0.14+ |
10+
| Continue (JetBrains) ||| v1.0.23+ |
11+
| PydanticAI ||| v0.2.18+ |
12+
| ChatGPT Desktop ||| See [workaround for STDIO-only clients][4] |
13+
| Claude Desktop ||| See [workaround for STDIO-only clients][4] |
14+
| Kiro ||| See [workaround for STDIO-only clients][4] |
1515

1616
[2]: https://github.com/cline/cline/issues/4391
1717
[3]: /toolhive/reference/client-compatibility.mdx#vs-code-with-copilot

docs/toolhive/reference/client-compatibility.mdx

Lines changed: 16 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -54,51 +54,37 @@ in your VS Code user settings file.
5454

5555
:::note
5656

57-
VS Code version 1.102 moved the MCP settings to a new location. Servers are now
58-
configured in a dedicated `mcp.json` file in the user settings directory.
57+
VS Code versions prior to v1.102 stored MCP server settings in the main
58+
`settings.json` file. As of v1.102, this has moved to a dedicated `mcp.json`
59+
file.
5960

60-
ToolHive currently only supports the previous location (`settings.json`). When
61-
ToolHive adds a new MCP server, VS Code prompts you to move it to the new
62-
location.
61+
ToolHive v0.2.0 and works with VS Code 1.102+ and updates the `mcp.json` file
62+
when you run an MCP server.
6363

64-
<img
65-
src='/img/toolhive/vscode-config-update.webp'
66-
alt='Screenshot of the VS Code MCP move prompt'
67-
width={440}
68-
/>
69-
70-
This works, but ToolHive will not automatically update the new `mcp.json` file
71-
in the same location as the `settings.json` file referenced below. You can still
72-
use the MCP servers, but you will need to manually update the `mcp.json` file if
73-
you stop or remove the server.
74-
75-
Subscribe to [this issue](https://github.com/stacklok/toolhive/issues/1037) for
76-
updates on ToolHive's support for the new MCP configuration location.
64+
If you're using an older version of either ToolHive or VS Code, automatic client
65+
configuration will not work as expected and you will need to manually update
66+
your configurations. We recommend upgrading both for the best experience.
7767

7868
:::
7969

8070
**Standard version**:
8171

82-
- **macOS**: `~/Library/Application Support/Code/User/settings.json`
83-
- **Linux**: `~/.config/Code/User/settings.json`
72+
- **macOS**: `~/Library/Application Support/Code/User/mcp.json`
73+
- **Linux**: `~/.config/Code/User/mcp.json`
8474

8575
**Insiders edition**:
8676

87-
- **macOS**: `~/Library/Application Support/Code - Insiders/User/settings.json`
88-
- **Linux**: `~/.config/Code - Insiders/User/settings.json`
77+
- **macOS**: `~/Library/Application Support/Code - Insiders/User/mcp.json`
78+
- **Linux**: `~/.config/Code - Insiders/User/mcp.json`
8979

9080
Example configuration:
9181

9282
```json
9383
{
94-
// Other VS Code settings...
95-
96-
"mcp": {
97-
"servers": {
98-
"github": { "url": "http://localhost:19046/sse#github", "type": "sse" },
99-
"fetch": { "url": "http://localhost:43832/sse#fetch", "type": "sse" },
100-
"osv": { "url": "http://localhost:51712/mcp", "type": "http" }
101-
}
84+
"servers": {
85+
"github": { "url": "http://localhost:19046/sse#github", "type": "sse" },
86+
"fetch": { "url": "http://localhost:43832/sse#fetch", "type": "sse" },
87+
"osv": { "url": "http://localhost:51712/mcp", "type": "http" }
10288
}
10389
}
10490
```

0 commit comments

Comments
 (0)