OpenCode

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

Prerequisites

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

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

Configuration

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 to clipboard

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

Verification

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 to clipboard

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

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

References

• OpenCode docs: MCP servers