Skip to content

Commit 8db24dd

Browse files
authored
docs: Update wording around configuring MCP servers (#38973)
Felt like this could be clarified a bit. Release Notes: - N/A
1 parent 4aac564 commit 8db24dd

File tree

1 file changed

+10
-8
lines changed

1 file changed

+10
-8
lines changed

docs/src/ai/mcp.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -55,27 +55,29 @@ From there, you can add it through the modal that appears when you click the "Ad
5555

5656
## Using MCP Servers
5757

58-
### Installation Check
58+
### Configuration Check
5959

60-
Regardless of whether you're using MCP servers as an extension or adding them directly, most servers out there need some sort of configuration as part of the set up process.
60+
Regardless of how you've installed MCP servers, whether as an extension or adding them directly, most servers out there still require some sort of configuration as part of the set up process.
6161

62-
In the case of extensions, Zed will show a modal displaying what is required for you to properly set up a given server.
62+
In the case of server extensions, after installing it, Zed will pop up a modal displaying what is required for you to properly set it up.
6363
For example, the GitHub MCP extension requires you to add a [Personal Access Token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).
6464

6565
In the case of custom servers, make sure you check the provider documentation to determine what type of command, arguments, and environment variables need to be added to the JSON.
6666

67-
To check whether your MCP server is properly installed, go to the Agent Panel's settings view and watch the indicator dot next to its name.
67+
To check if your MCP server is properly configured, go to the Agent Panel's settings view and watch the indicator dot next to its name.
6868
If they're running correctly, the indicator will be green and its tooltip will say "Server is active".
6969
If not, other colors and tooltip messages will indicate what is happening.
7070

71-
### Using in the Agent Panel
71+
### Using it in the Agent Panel
7272

7373
Once installation is complete, you can return to the Agent Panel and start prompting.
74-
Mentioning your MCP server by name helps the agent pick it up.
7574

76-
If you want to ensure a given server will be used, you can create [a custom profile](./agent-panel.md#custom-profiles) by turning off the built-in tools (either all of them or the ones that would cause conflicts) and turning on only the tools coming from the MCP server.
75+
Some models are better than others when it comes to picking up tools from MCP servers.
76+
Mentioning your server by name always helps the model to pick it up.
7777

78-
As an example, [the Dagger team suggests](https://container-use.com/agent-integrations#add-container-use-agent-profile-optional) doing that with their [Container Use MCP server](https://zed.dev/extensions/mcp-server-container-use):
78+
However, if you want to ensure a given MCP server will be used, you can create [a custom profile](./agent-panel.md#custom-profiles) where all built-in tools (or the ones that could cause conflicts with the server's tools) are turned off and only the tools coming from the MCP server are turned on.
79+
80+
As an example, [the Dagger team suggests](https://container-use.com/agent-integrations#zed) doing that with their [Container Use MCP server](https://zed.dev/extensions/mcp-server-container-use):
7981

8082
```json
8183
"agent": {

0 commit comments

Comments
 (0)