Zed

Learn how to set up the Mixedbread MCP server with Zed.

Prerequisites

Before we configure Zed, make sure you have the following:

• Zed installed
• Node.js 22+ installed
• A Mixedbread API key from our platform

Configuration

Zed configures MCP servers via a configuration file named settings.json.

Method 1 — Edit settings.json

1. Open Zed settings:

   • Command Palette → Zed: Open settings

2. Add the Mixedbread MCP server by adding the following JSON to your settings.json:

   Copy to clipboard

   {
     "context_servers": {
       "mixedbread": {
         "source": "custom",
         "command": "npx",
         "args": [
           "-y",
           "mcp-remote@latest",
           "https://www.mcp.mixedbread.com/api/mcp",
           "--header",
           "Authorization:${MXBAI_AUTH_HEADER}"
         ],
         "env": {
           "MXBAI_AUTH_HEADER": "Bearer YOUR_MIXEDBREAD_API_KEY"
         }
       }
     }
   }

   • source specifies a custom context server.
   • command runs mcp-remote with the Mixedbread MCP endpoint.
   • env sets an environment variable with your API key.

   Replace YOUR_MIXEDBREAD_API_KEY with your actual key from the Mixedbread platform.

3. Save your settings. Zed will start the server shortly after saving. You can confirm status in the Agent Panel.

Method 2 — Add via Agent Panel UI

1. Open the Agent Panel → Settings.
2. Click Add Custom Server.
3. Fill in the fields:
   • Name: mixedbread
   • Command: npx
   • Args:
     • -y
     • mcp-remote@latest
     • https://www.mcp.mixedbread.com/api/mcp
     • --header
     • Authorization:${MXBAI_AUTH_HEADER}
   • Env:
     • MXBAI_AUTH_HEADER=Bearer YOUR_MIXEDBREAD_API_KEY
4. Save. The server should appear in the panel with a status indicator.

Verification

Now let's confirm the integration is working.

1. Open the Agent Panel → Settings.

2. Confirm the status dot next to Mixedbread is green and the tooltip says "Server is active."

3. Test the connection with a simple command:

   Copy to clipboard

   Create a new store called "my-knowledge-base"

Now you can manage your Stores and perform Search directly from Zed.

References

• Zed docs: Model Context Protocol