OpenCode

Learn how to set up the Mixedbread MCP server with OpenCode.

PrerequisitesCopy Anchor Link

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

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

ConfigurationCopy Anchor Link

OpenCode configures MCP servers via a configuration file named opencode.json.

1. Create the configuration file

   The recommended setup is project-level: Place an opencode.json file in the root of your repository.

2. Add a Mixedbread server entry

   Add the following to your opencode.json:

   Copy Text

   {
     "$schema": "https://opencode.ai/config.json",
     "mcp": {
       "mixedbread": {
         "type": "local",
         "command": [
           "npx",
           "-y",
           "mcp-remote@latest",
           "https://www.mcp.mixedbread.com/api/mcp",
           "--header",
           "Authorization:${MXBAI_AUTH_HEADER}"
         ],
         "enabled": true,
         "environment": {
           "MXBAI_AUTH_HEADER": "Bearer YOUR_MIXEDBREAD_API_KEY"
         }
       }
     }
   }

   • type specifies that the server runs locally.
   • command runs mcp-remote with the Mixedbread MCP endpoint and authentication header.
   • enabled controls whether the server is active.
   • environment sets your API key as an environment variable.

   Replace YOUR_MIXEDBREAD_API_KEY with your actual key from the Mixedbread platform.

VerificationCopy Anchor Link

Now let's confirm the integration is working.

1. Start OpenCode and reload the configuration.

2. Confirm the Mixedbread server is listed under tools and enabled.

3. Test the connection with a simple command, for example:

   Copy Text

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

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

ReferencesCopy Anchor Link

• OpenCode docs: MCP servers