Cursor

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

PrerequisitesCopy Anchor Link

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

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

ConfigurationCopy Anchor Link

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

Method 1 — Edit via the terminalCopy Anchor Link

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 Text

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

   Windows:

   Copy Text

   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 Text

   {
     "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 UICopy Anchor Link

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.

VerificationCopy Anchor Link

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 Text

   Create a new store called "my-knowledge-base"

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

ReferencesCopy Anchor Link

• Cursor docs: Model Context Protocol