context_servers setting. Configuration is global — Zed does not currently support per-project MCP config files.
No credentials are required in the config. Calling
login opens a browser to Perfai’s own sign-in page (OAuth) and completes automatically — see Login below.Installation
- macOS
- Linux
- Windows
File:
~/.config/zed/settings.jsonAdd (or merge) the following into your existing settings:Zed’s
context_servers format uses a nested command object with path and args — this differs from the flat command / args format used by Cursor and Claude Code. If you prefer not to use the browser login, create a Perfai API key and add "env": { "PERFAI_API_KEY": "pfk_xxxxxxxxxxxx_..." } alongside path/args — keep settings.json private if you do.Open settings in Zed
You can opensettings.json directly from Zed:
- Press
Cmd+,(macOS) orCtrl+,(Linux/Windows). - Click Open settings.json in the top-right corner of the settings panel.
- Add the
context_serversblock and save.
Verify the server is connected
- Open the AI panel in Zed (click the AI icon or press
Cmd+?). - Look for perfai-cloud-mcp in the context server list.
- A green dot means it’s running. If it shows red, check that Node.js 18+ is installed and
npxis on your PATH.
Login
The prompts below run inside Zed’s AI assistant panel, not your terminal. The only terminal/file steps are editing
settings.json.PERFAI_API_KEY if you set it). Confirm with:

