Setup

Step 1 — Generate an API Key

1. Go to Org Settings → API Keys
2. Click Generate New Key
3. Give it a label (e.g. Cursor - My Machine)
4. Choose a scope:
   • Readonly — agent can search and read only
   • Readwrite — agent can search, read, and write
5. Copy the key — it will not be shown again

Step 2 — Connect your agent

After generating a key, the modal shows ready-to-use config snippets with your key already filled in. Copy the snippet for your tool and follow the steps below.

Claude Desktop

1. Open your claude_desktop_config.json file:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: C:\Users\<username>\AppData\Roaming\Claude\claude_desktop_config.json

2. Add the following inside the root object:

{
  "mcpServers": {
    "hiveboss": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-backend-url/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

3. Make sure mcp-remote is installed:

npm install -g mcp-remote

4. Fully quit and reopen Claude Desktop

5. Click the + button in the chat input → Connectors → you should see hiveboss listed and toggled on

Cursor

1. Open Cursor Settings → MCP
2. Add a new MCP server with the following config:

{
  "mcpServers": {
    "hiveboss": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-backend-url/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

3. Save and restart Cursor

Claude Code

Run this command in your terminal:

claude mcp add hiveboss https://your-backend-url/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Verify it's connected:

claude mcp list

Any Other MCP-Compatible Tool

HiveBoss MCP server works with any tool that supports MCP over HTTP — not just the three above. If your tool supports MCP, you only need three things:

Check your tool's documentation for where to add a custom MCP server and pass these values. No additional setup is needed on the HiveBoss side.