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.

1. Open the configuration file

   From the Command Palette, run:

   Copy to clipboard

   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 to clipboard

   {
     "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:

   Copy to clipboard

   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