Cursor

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

Prerequisites

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

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

Configuration

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

Method 1 — Edit via the terminal

1. 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:

   Copy to clipboard

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

   Windows:

   Copy to clipboard

   New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.cursor"
   New-Item -ItemType File -Force -Path "$env:USERPROFILE\.cursor\mcp.json"

2. Add a Mixedbread server entry

   Add the following to your mcp.json:

   Copy to clipboard

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

3. Save and restart Cursor to apply the changes.

Method 2 — Add via the UI

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

Verification

Now let's confirm the integration is working.

1. Open Settings → Cursor Settings → MCP and check that Mixedbread is listed.

2. Ensure Cursor is in Agent Mode so MCP tools can be used.

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

References

• Cursor docs: Model Context Protocol