Skip to main content

Cursor

Wire Cursor up to ColabHive via MCP.

Two paths: hosted (recommended) or local stdio.

Path A — Hosted endpoint​

Prerequisites​

  • Cursor 0.42+ (MCP support stable from this version)
  • A ColabHive API key

Config​

Edit ~/.cursor/mcp.json (or use Settings → Features → MCP → Add new MCP server):

{
  "mcpServers": {
    "colabhive": {
      "transport": "sse",
      "url": "https://mcp.colabhive.com/mcp",
      "headers": {
        "Authorization": "Bearer hive_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Restart Cursor fully (Cmd-Q).

Verify​

  1. Settings → Features → MCP → colabhive shows green dot.
  2. Open Chat (Cmd-L / Ctrl-L), click the 🔧 menu — ColabHive tools listed.
  3. Try: "Use the ColabHive embeddings-public tool to embed the current selection."

Path B — Local stdio​

{
  "mcpServers": {
    "colabhive": {
      "command": "uvx",
      "args": ["colabhive-mcp@latest"],
      "env": { "COLABHIVE_API_KEY": "hive_xxx" }
    }
  }
}

Restart Cursor. Same verification as above.

Recipes​

Use ColabHive as a code-search backend​

Use ColabHive embeddings-public to embed every .ts file in src/, then rerank with rerank-public to find the file most relevant to "websocket reconnect logic".

Pair Cursor + your trained classifier​

In your rules / system prompt:

When showing me a diff for review, also call ColabHive tool
`lint-quality-v2` with the diff text and surface its labels.

Reduce noise​

With many tools the picker gets long. In Path A, archive base models you don't use in console.colabhive.com. In Path B:

"args": [
  "colabhive-mcp@latest",
  "--allow-kinds", "trained_model,specialist",
  "--allow-tools", "embeddings-public,rerank-public,web-fetch-public"
]

Troubleshooting​

Red dot in Settings → MCP (Path A)​

Click → View logs. Most common: wrong / revoked API key.

Verify with curl:

curl https://mcp.colabhive.com/health
# {"status":"ok",...}

Red dot (Path B)​

  • uvx: command not found — install uv and restart Cursor from Terminal so it inherits PATH.
  • Authentication failed — recheck COLABHIVE_API_KEY.
  • Corporate proxy — set HTTPS_PROXY in env.

Tools don't appear​

  • Confirm green dot.
  • Reload (Cmd-Shift-P → Cursor: Reload Window).
  • Check that the key's account actually owns / has access to tools.

Cursor freezes on tool call​

Long-running tools (generative, batch) can exceed Cursor's UI timeout. Filter them out:

// Path A — no enforced per-tool restriction today
// Path B — exclude locally in args
"args": [
  "colabhive-mcp@latest",
  "--allow-kinds", "llm,specialist,tool,trained_model"
]

See also​