Zed

Manual Configuration

Option 1: stdio (Recommended)

1. Open Zed
2. Open Settings with Cmd + , to edit your settings.json
3. Add the following to the context_servers section:

{
  "context_servers": {
    "macuse": {
      "command": {
        "path": "/Applications/Macuse.app/Contents/MacOS/macuse",
        "args": ["mcp"]
      }
    }
  }
}

4. Save and restart Zed

Option 2: HTTP with API Key

If stdio doesn't work, you can connect via HTTP using an API Key:

1. Open Macuse Settings → Connections, click +, enter "Zed" as the name, and click Create
2. Copy the API key immediately (it is only shown once)
3. Add the following to your Zed settings.json:

{
  "context_servers": {
    "macuse": {
      "url": "http://127.0.0.1:35729/mcp",
      "headers": {
        "Authorization": "Bearer <your_api_key>"
      }
    }
  }
}

4. Save and restart Zed

See the API Keys page for more details.

Verifying the Connection

1. Open Zed and start a new AI chat
2. Ask the AI to "list available Macuse tools"
3. If configured correctly, the AI will show the available toolboxes