Claude Desktop

Learn how to set up the Mixedbread MCP server with Claude Desktop.

Prerequisites

Before we configure Claude Desktop, make sure you have the following:

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

Configuration

Claude Desktop configures MCP servers via a configuration file named claude_desktop_config.json.

Configuration Steps

1. Locate the configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Open and edit configuration:

   • Open Claude Desktop → Settings
   • Navigate to Developer in the sidebar
   • Click Edit Config

3. Add a Mixedbread server entry

   Add the following to your claude_desktop_config.json:

   Copy to clipboard

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

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

4. Save and restart Claude Desktop:

   • Save the file and fully restart Claude Desktop for the changes to take effect.

Verification

Now let's confirm the integration is working.

1. Open a new conversation in Claude Desktop.

2. Click Search & Tools in the input field and verify that Mixedbread is connected.

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 Claude Desktop.

References

• MCP docs: Claude Desktop