Skip to content

armgit / zed

Public Imported from GitHub
0

Code at the speed of thought – Zed is a high-performance, multiplayer code editor from the creators of Atom and Tree-sitter.

docs: Improve documentation around MCP servers (#59380)

Finn Evers153f709a1850
diff --git a/docs/src/ai/mcp.md b/docs/src/ai/mcp.md
index 873044bbd0b..30317dfad96 100644
--- a/docs/src/ai/mcp.md
+++ b/docs/src/ai/mcp.md
@@ -51,7 +51,7 @@ Popular servers available as an extension include:
### As Custom Servers
Creating an extension is not the only way to use MCP servers in Zed.
-You can connect them by adding their commands directly to your settings file ([how to edit](../configuring-zed.md#settings-files)), like so:
+You can connect both local and remote MCP servers easily utilizing the MCP server modal, which you can open by invoking the {#action agent::AddContextServer} action. Your specified configuration will create entries in your settings file (which you can open with {#action zed::OpenSettingsFile}) similar to the ones below:
```json [settings]
{
@@ -72,8 +72,7 @@ You can connect them by adding their commands directly to your settings file ([h
}
```
-Alternatively, you can also add a custom server by accessing the Agent Panel's Settings view (also accessible via the {#action agent::OpenSettings} action).
-From there, you can add it through the modal that appears when you click the "Add Custom Server" button.
+Alternatively, you can also open the modal by accessing the Agent Panel's Settings view (also accessible via the {#action agent::OpenSettings} action) and clicking the "Add Custom Server" button there.
> Note: When a remote MCP server has no configured `"Authorization"` header, Zed will prompt you to authenticate yourself against the MCP server using the standard MCP OAuth flow.
diff --git a/docs/src/extensions/mcp-extensions.md b/docs/src/extensions/mcp-extensions.md
index 65771f758d8..71bc206768b 100644
--- a/docs/src/extensions/mcp-extensions.md
+++ b/docs/src/extensions/mcp-extensions.md
@@ -38,6 +38,8 @@ This method should return the command to start up an MCP server, along with any
If you need to download the MCP server from an external source (GitHub Releases, npm, etc.), you can also do that in this function.
+> Note that this is only intended currently for servers published either as binaries or via NPM. Remote context servers should be added natively via the UI, see [the relevant section in the MCP documentation](../ai/mcp.md#as-custom-servers).
+
## Available Extensions
See MCP servers published as extensions [on Zed's site](https://zed.dev/extensions?filter=context-servers).