Claude Desktop

Set up the Mixedbread MCP server with Claude Desktop.

Prerequisites

Before starting, ensure you have:

Claude Desktop installed (download here)
Node.js 20+ installed on your system (download here)
A Mixedbread API key from platform.mixedbread.com

Configuration

Configure MCP servers by editing the Claude Desktop configuration file.

Configuration File Location

~/Library/Application Support/Claude/claude_desktop_config.json

Setup Steps

Click the Claude menu and select "Settings"
Navigate to "Developer" in the left sidebar
Click "Edit Config"

Replace the file contents with:

{
  "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"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Documents"
      ]
    }
  }
}

Replace YOUR_MIXEDBREAD_API_KEY with your actual API key and username with your actual username. Adjust the filesystem paths to directories you want Claude to access.

Save the configuration file and completely restart Claude Desktop for the changes to take effect.

Verification

Check MCP connection
- Open a new conversation in Claude Desktop
- Click on "Search & Tools" in the input field
- Verify both mixedbread and filesystem are connected
Test Mixedbread functionality
Create a new vector store called "test-docs"
Test filesystem access
List files in my Desktop folder

Tools

Complete reference for all tools available in the Mixedbread MCP server, organized by category with examples and best practices.

Claude Code

Set up the Mixedbread MCP server with Claude Code CLI for AI-powered code and documentation search.

Last updated: July 31, 2025