Claude Code

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

Prerequisites

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

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

Configuration

You can configure the Mixedbread MCP server in Claude Code either by importing from Claude Desktop or running the claude mcp add command.

Method 1 — Import from Claude Desktop

1. Import your Claude Desktop MCP configuration into Claude Code:

claude mcp add-from-claude-desktop

Method 2 — CLI command

To configure the Mixedbread MCP server globally:

1. Add the Mixedbread server:

   Copy to clipboard

   claude mcp add --transport stdio mixedbread --scope user --env MXBAI_AUTH_HEADER="Bearer YOUR_MIXEDBREAD_API_KEY" -- npx -y mcp-remote@latest https://www.mcp.mixedbread.com/api/mcp --header Authorization:${MXBAI_AUTH_HEADER}

2. Notes:

   • --transport stdio connects locally via stdio to mcp-remote, which tunnels to the remote Mixedbread MCP server.
   • --scope user sets the configuration scope to your user profile.
   • --env defines the environment variable containing your API key.
   • -- separates Claude's flags from the mcp-remote command and arguments.

3. Replace YOUR_MIXEDBREAD_API_KEY with your actual key from the Mixedbread platform.

Verification

Now let's confirm the integration is working.

1. List all configured servers:

   Copy to clipboard

   claude mcp list

2. Use the /mcp command to view available tools and server status.

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

References

• Claude Code docs: Model Context Protocol