Bunbox logoBunbox
INTEGRATION GUIDE

Integrate as MCP Server

Connect Bunbox directly to your local AI agents (Claude Desktop, Claude Code, Codex, and OpenCode) to allow them to query and install safe tools securely.

1. Claude Desktop Setup

Configure Claude Desktop to utilize the Bunbox MCP server for tool search and validation.

Add the following configuration to your Claude Desktop config file. Depending on your operating system, this file is located at:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "bunbox": {
      "command": "bunbx",
      "args": ["mcp", "serve"]
    }
  }
}
Note: Make sure you have installed the Bunbox CLI globally using bun install -g @bunboxnode/bunbx so that the bunbx command is available in your shell PATH.

2. Claude Code CLI Setup

Enforce safe tool execution when executing terminal commands inside Claude Code CLI session.

Terminal
$ claude mcp add bunbox -- bunbx mcp serveAdded MCP server 'bunbox' successfully.

3. Codex and OpenCode Setup

For custom editor environments and developer agents, initialize the client protocol with the registry endpoint configuration.

CONFIG FILE

Codex IDE

Go to IDE settings > MCP Configuration and add the local script execution endpoint matching port 4321.

DAEMON ENDPOINT

OpenCode

Connect using the WebSocket bridge or standard standard-io spawn pipeline configured in your workspace.

METADATA DISCOVERY

Discovery JSON

Inspect the local manifest profile at /.well-known/bunbox.json to resolve trust roots.

Test MCP Server in Demo