Mixedbread

Cursor

Set up the Mixedbread MCP server with Cursor IDE.

Prerequisites

Before starting, ensure you have:

Configuration

Configure MCP servers globally by editing the configuration file at ~/.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 ~/.cursor/mcp.json and add the following configuration:

{
  "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 ~/.cursor/mcp.json file in the editor

Paste the configuration from Method 1.

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

Verification

  1. Check that both mixedbread and filesystem servers are listed in Settings → Tools & Integrations

  2. Ensure Cursor is in Agent Mode (not Ask Mode) to use MCP tools

  3. Test Mixedbread functionality

    Create a vector store called "cursor-project"

  4. 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: July 31, 2025