Mixedbread

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:

Configuration

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

  1. Open the configuration file

    From the Command Palette, run:

    MCP: Configure Servers

    This will open mcp.json for your current scope.

  2. Add a Mixedbread server entry

    Add the following to your mcp.json:

    {
  "inputs": [
    {
      "type": "promptString",
      "id": "mixedbread-api-key",
      "description": "Mixedbread API Key",
      "password": true
    }
  ],
  "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 ${input:mixedbread-api-key}"
      }
    }
  }
}
    • inputs defines a secure prompt for entering your Mixedbread API key.
    • servers configures Mixedbread to connect over stdio using mcp-remote.
    • env passes the API key into the connection securely.

Enable and Use in Agent Mode

  1. Open Copilot Chat in Agent Mode.

  2. Select the Tools button and ensure Mixedbread is enabled.

  3. 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

Last updated: October 8, 2025

Windsurf

Set up the Mixedbread MCP server with Windsurf.

On this page

Prerequisites
Configuration
Enable and Use in Agent Mode
References