Install Archery MCP in Zed
What you need first
- Zed, installed.
- uv, which
gives the
uvxcommand the server starts with. - Your own values for
YOUR_ARCHERY_BASE_URL,YOUR_ARCHERY_USERNAME,YOUR_ARCHERY_PASSWORD,YOUR_ARCHERY_INSTANCE_NAME,YOUR_ARCHERY_DB_NAME.
Steps
- Open Zed's settings file,
~/.config/zed/settings.json(on Windows%APPDATA%\Zed\settings.json), or.zed/settings.jsonfor one project. - Add this block. If the file already has
context_servers, add only the entry inside it.
{
"context_servers": {
"archery-mcp": {
"command": "uvx",
"args": ["archery-mcp==0.1.1"],
"env": { "ARCHERY_BASE_URL": "YOUR_ARCHERY_BASE_URL", "ARCHERY_USERNAME": "YOUR_ARCHERY_USERNAME", "ARCHERY_PASSWORD": "YOUR_ARCHERY_PASSWORD", "ARCHERY_INSTANCE_NAME": "YOUR_ARCHERY_INSTANCE_NAME", "ARCHERY_DB_NAME": "YOUR_ARCHERY_DB_NAME" }
}
}
} - Replace
YOUR_ARCHERY_BASE_URL,YOUR_ARCHERY_USERNAME,YOUR_ARCHERY_PASSWORD,YOUR_ARCHERY_INSTANCE_NAME,YOUR_ARCHERY_DB_NAMEwith your own values. - Save the file. Zed starts the server, and Settings › AI › MCP Servers lists it.
Check it worked
Ask Zed: List the tools of archery-mcp.
If it does not start
- spawn uvx ENOENT
- uv is not on the PATH that Zed sees. Install it, or write the
full path of
uvxin the config. - The server starts, but its tools fail
- A
YOUR_…placeholder is still in the config, or its value is wrong. - Nothing changes after a restart
- The file is not valid JSON any more. Look for a missing comma where the block was added.