Cursor

Set up the Mixedbread MCP server with Cursor IDE.

Prerequisites

Before starting, ensure you have:

Cursor IDE version 1.0.0 or higher (download here)
Node.js 20+ installed on your system (download here)
A Mixedbread API key from platform.mixedbread.com

Configuration

Configure MCP servers globally by editing the configuration file.

Configuration File Location

~/.cursor/mcp.json

Method 1: Edit Configuration File

Create the directory and file if they don't exist:

mkdir -p ~/.cursor
touch ~/.cursor/mcp.json

Edit the configuration file and add the following:

{
  "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",
        "."
      ]
    }
  }
}

Replace YOUR_MIXEDBREAD_API_KEY with your actual Mixedbread API key.

Save the file and restart Cursor for the changes to take effect.

Method 2: Through Cursor UI

Open Settings from the menu
Navigate to Tools & Integrations

Click on Add custom MCP
This will open the MCP configuration file in the editor (location depends on your OS)

Paste the configuration from Method 1.

Save the file. Cursor will automatically reload the MCP servers.

Verification

Check that both mixedbread and filesystem servers are listed in Settings → Tools & Integrations
Ensure Cursor is in Agent Mode (not Ask Mode) to use MCP tools
Test Mixedbread functionality
Create a vector store called "cursor-project"
Test filesystem access
List all files in the current project

Claude Code

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

Last updated: September 11, 2025