VS Code

Learn how to set up the Mixedbread MCP server with Visual Studio Code.

Prerequisites

Before we configure VS Code, make sure you have the following:

Visual Studio Code installed
GitHub Copilot Chat extension
Node.js 22+ installed
A Mixedbread API key from our platform

Configuration

VS Code configures MCP servers via a configuration file named mcp.json.

Open the configuration file

From the Command Palette, run:
```
MCP: Configure Servers
```
This will open mcp.json for your current scope.

Add a Mixedbread server entry

Add the following to your mcp.json:

{
  "servers": {
    "mixedbread": {
      "type": "stdio",
      "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"
      }
    }
  }
}

command runs mcp-remote via npx.
args specify the Mixedbread MCP endpoint and authentication header.
env sets an environment variable with your API key.

Replace YOUR_MIXEDBREAD_API_KEY with your actual key from the Mixedbread platform.

Enable and Use in Agent Mode

Open Copilot Chat in Agent Mode.
Select the Tools button and ensure Mixedbread is enabled.
Test the connection with a simple command:
```
Create a new store called "my-knowledge-base"
```

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

References

VS Code docs: MCP servers

Last updated: March 5, 2026

Windsurf

Set up the Mixedbread MCP server with Windsurf.

On this page

Enable and Use in Agent Mode