Cursor

Learn how to set up the Mixedbread MCP server with Cursor IDE.

PrerequisitesLink to section

Before we configure Cursor, make sure you have the following:

Cursor IDE installed
Node.js 22+ installed
A Mixedbread API key from our platform

ConfigurationLink to section

Cursor supports MCP servers via a configuration file named mcp.json.

Method 1 — Edit via the terminalLink to section

Locate or create the configuration file

Cursor looks for mcp.json in the following paths:
- macOS/Linux: ~/.cursor/mcp.json
- Windows: %USERPROFILE%\.cursor\mcp.json
If the directory or file doesn't exist, create it manually:

macOS/Linux:
```
mkdir -p ~/.cursor
touch ~/.cursor/mcp.json
```
Windows:
```
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.cursor"
New-Item -ItemType File -Force -Path "$env:USERPROFILE\.cursor\mcp.json"
```

Add a Mixedbread server entry

Add the following to your mcp.json:

{
  "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.

Save and restart Cursor to apply the changes.

Method 2 — Add via the UILink to section

Open Settings → Cursor Settings → MCP → New MCP Server.
Paste the Mixedbread configuration from Method 1.
Save. Cursor will automatically reload the MCP servers.

VerificationLink to section

Now let's confirm the integration is working.

Open Settings → Cursor Settings → MCP and check that Mixedbread is listed.
Ensure Cursor is in Agent Mode so MCP tools can be used.
Test the connection with a simple command:
```
Create a new store called "my-knowledge-base"
```

Now you can manage your Stores and perform Search directly from Cursor.

ReferencesLink to section

Cursor docs: Model Context Protocol