VS Code

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

PrerequisitesCopy Anchor Link

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

ConfigurationCopy Anchor Link

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

1. Open the configuration file

   From the Command Palette, run:

   Copy Text

   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:

   Copy Text

   {
     "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 ModeCopy Anchor Link

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:

   Copy Text

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

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

ReferencesCopy Anchor Link

• VS Code docs: MCP servers