Pro feature, 2 min setup

Connect ContextBolt to your AI

Paste one URL into Claude, Cursor, Cline, or any MCP client. Your saved bookmarks become searchable context for every chat, every prompt, every project.

Before you start Pick your client Troubleshooting
Before you start

Three things you'll need

Skip ahead if you've already done these. Reach out at [email protected] if you get stuck on any of them.

1

ContextBolt installed

Free from the Chrome Web Store. Works in Chrome, Brave, Arc, Edge, and any Chromium browser.

Install ContextBolt
2

Pro license activated

MCP is a Pro feature. Buy once, paste your license key into the extension. Where do I find my key?

Get Pro
3

Bookmarks synced

Visit x.com/i/bookmarks, reddit.com/saved, or click the LinkedIn save button on posts you want captured. The extension does the rest.

Already done? Continue below ↓
Step 1 of 2

Copy your MCP URL

This URL is the entire connection. It contains your auth token, so treat it like a password.

  1. 1
    Click the ContextBolt icon in your browser toolbar to open the dashboard.
  2. 2
    Open Settings in the left sidebar.
  3. 3
    Find the MCP Integration section. It only appears after Pro is active. If you see "Upgrade to Pro" instead, paste your license key into the License Key field above and click Save first.
  4. 4
    Click Copy URL. Your MCP URL looks like this: https://api.contextbolt.app/mcp/your-unique-token
Step 2 of 2

Pick your AI client

Same URL, six setups. Click the card that matches what you use.

Recommended

Claude Desktop

Anthropic's desktop app. Mac and Windows.

Setup steps →

Claude Code

Anthropic's CLI agent. Per-project or global.

Setup steps →

Cursor

AI-first code editor. macOS, Windows, Linux.

Setup steps →

Cline

Autonomous coding agent for VS Code.

Setup steps →

Continue

Open-source AI assistant. VS Code and JetBrains.

Setup steps →

Other / Custom

Any HTTP-MCP compatible client. Generic instructions.

Setup steps →
Claude Desktop

Connect to Claude Desktop

Anthropic's desktop app for macOS and Windows. Two ways: the GUI (easiest) or editing the JSON config file directly.

A Custom connector (easiest)

  1. Open Claude Desktop and click your profile icon (top right).
  2. Choose Settings → Connectors.
  3. Click Add custom connector.
  4. Name it ContextBolt and paste your MCP URL into the URL field.
  5. Click Add, then quit and reopen Claude Desktop.

Don't see "Connectors" in Settings? You're on an older version. Use method B below.

B Edit the config file

  1. Open the config file:
    • macOS ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows %APPDATA%\Claude\claude_desktop_config.json

    Or in Claude Desktop: Settings → Developer → Edit Config.

  2. Add the ContextBolt server to mcpServers: 
    {
  "mcpServers": {
    "contextbolt": {
      "type": "http",
      "url": "https://api.contextbolt.app/mcp/YOUR_TOKEN"
    }
  }
}

    Replace YOUR_TOKEN with the token at the end of your MCP URL. If mcpServers already exists with other entries, just add the "contextbolt" key inside it.

  3. Quit and reopen Claude Desktop. Look for the connector indicator (paperclip icon in the chat input).
Try it: "Search my bookmarks for posts about AI agents and summarize the patterns."
Claude Code

Connect to Claude Code

Anthropic's terminal-native coding agent. Add ContextBolt globally (every project) or per-project via .mcp.json.

A CLI command (easiest)

  1. Run this in any terminal: 
    claude mcp add --transport http contextbolt https://api.contextbolt.app/mcp/YOUR_TOKEN
  2. Restart your Claude Code session (close and reopen the terminal, or run /exit then re-launch).
  3. Verify with /mcp inside Claude Code. You should see contextbolt listed as connected.

B Per-project .mcp.json

  1. Create or edit .mcp.json in your project root: 
    {
  "mcpServers": {
    "contextbolt": {
      "type": "http",
      "url": "https://api.contextbolt.app/mcp/YOUR_TOKEN"
    }
  }
}
  2. Commit it to git if your team should also get bookmark search (or add it to .gitignore if your bookmarks are personal).
  3. Restart Claude Code in that project directory.

Project-level .mcp.json takes precedence over the global config.

Try it: "Find any bookmarks I've saved about Postgres performance and pull the relevant tips."
Cursor

Connect to Cursor

Cursor reads MCP servers from a single JSON file. Edit it once, restart, done.

  1. Open Cursor settings: ⌘, on macOS, Ctrl+, on Windows / Linux.
  2. Search for "MCP" in the settings search bar, then click Edit in settings.json (or MCP servers).
  3. Add the ContextBolt server. The file lives at ~/.cursor/mcp.json: 
    {
  "mcpServers": {
    "contextbolt": {
      "url": "https://api.contextbolt.app/mcp/YOUR_TOKEN"
    }
  }
}
  4. Restart Cursor. Open the chat panel and you should see contextbolt in the available tools.
Try it: Open the Cursor chat, ask "Have I bookmarked anything about this codebase's framework? Pull the most relevant ones."
Cline

Connect to Cline

Cline is a VS Code extension. It has a built-in MCP servers panel.

  1. Open the Cline panel in VS Code (sidebar icon).
  2. Click the MCP Servers tab at the top of the panel.
  3. Click Configure MCP Servers. This opens cline_mcp_settings.json.
  4. Add ContextBolt: 
    {
  "mcpServers": {
    "contextbolt": {
      "type": "streamableHttp",
      "url": "https://api.contextbolt.app/mcp/YOUR_TOKEN",
      "disabled": false,
      "autoApprove": []
    }
  }
}
  5. Save the file. Cline picks up the change automatically; no restart needed. The server should show up green in the MCP Servers tab.
Try it: "Pull bookmarks tagged with refactoring and use them as context for cleaning up this file."
Continue

Connect to Continue

Open-source AI assistant for VS Code and JetBrains. MCP support is built into recent versions.

  1. Open the config file at ~/.continue/config.yaml (or config.json on older versions).
  2. Add ContextBolt under mcpServers: 
    mcpServers:
  - name: contextbolt
    transport:
      type: streamable-http
      url: https://api.contextbolt.app/mcp/YOUR_TOKEN
  3. Reload the Continue panel (or restart your editor).

If you're on a JSON-based config, the equivalent is { "mcpServers": [{ "name": "contextbolt", "url": "..." }] }.

Try it: "List the LinkedIn posts I bookmarked about hiring engineers."
Other clients

Any other MCP-compatible client

ContextBolt's MCP server speaks standard JSON-RPC over HTTP per the Model Context Protocol spec. If your client supports remote MCP, it'll work.

What you need to know

  • Transport: HTTP (some clients call this "streamable HTTP" or "SSE"). We accept both.
  • URL: https://api.contextbolt.app/mcp/YOUR_TOKEN
  • Auth: The token is in the URL path. No headers, no API keys, nothing else needed.
  • Methods supported: initialize, tools/list, tools/call, ping.
  • Tools exposed: search_bookmarks, list_clusters, get_cluster_bookmarks, get_recent_bookmarks.

Generic config shape

Most MCP clients use a config file with this structure. Adapt to your client's format:

{
  "mcpServers": {
    "contextbolt": {
      "type": "http",
      "url": "https://api.contextbolt.app/mcp/YOUR_TOKEN"
    }
  }
}
Got it working with a client we don't list? Email us the steps and we'll add it to this guide.
License key help

Where to find your license key

Two places, both reliable. If you bought Pro and can't find your key, here's how to get it back.

1. Check your inbox

After purchase, Lemon Squeezy emails your license key. Look for the subject line "Your ContextBolt Pro license key". The body contains a UUID-format key that looks like XXXX-XXXX-XXXX-XXXX-XXXX.

Check spam if it's not in your inbox. Search for contextbolt or lemonsqueezy.

2. Lemon Squeezy account

Go to app.lemonsqueezy.com/my-orders, click your ContextBolt order, and your license key is shown on the order details page.

Same place lets you cancel, update payment, or download invoices.

Activating the key in the extension

  1. Open the ContextBolt extension and go to Settings.
  2. Paste your license key into the License Key field (under Account).
  3. Click Save. You should see "Pro activated" in green within a few seconds.
  4. The MCP Integration section now shows your URL. Continue with your client setup.
Troubleshooting

If something's not working

Eight quick checks that solve nine out of ten setup issues. Still stuck after these? Email [email protected] and we'll get on it.

This is the most common one. Open the ContextBolt extension, go to Settings, click Save. That triggers a one-time backfill of your local bookmarks to the cloud where the MCP server reads them. Wait around 5 seconds, then try your query again. Future bookmarks sync automatically.

Check three things: (a) the URL is the full https://api.contextbolt.app/mcp/YOUR_TOKEN with no trailing slash, (b) you've fully restarted the AI client (quit and reopen, not just close the window), (c) your firewall isn't blocking outbound HTTPS to api.contextbolt.app. Try the URL in a browser; you should see a JSON object listing the available tools.

Either your Pro license isn't active or your MCP token was regenerated. Open the extension, check that the License Key field shows "Active" in green. If it does, copy the URL again from the MCP Integration section and update your AI client's config.

Make sure you're pasting the exact key from your Lemon Squeezy email (or order page), with no extra spaces. The key is UUID format with hyphens. If you bought through the test mode link by mistake, your key won't validate against the live store; email [email protected] and we'll re-issue.

Two places: the email Lemon Squeezy sent right after purchase (search "ContextBolt" or "lemonsqueezy"), or your Lemon Squeezy orders page. Full instructions.

Regenerating invalidates the old URL immediately. Copy the new URL from the extension and update every AI client you connected. Restart each client after updating.

No. Treat it like a password. Anyone with the URL can read all your bookmarks. Don't paste it into screenshots, public Discord channels, or shared .mcp.json files committed to public repos. If it leaks, click Regenerate in the MCP Integration section.

Four MCP tools are exposed: semantic search across your full collection, listing your auto-discovered topic clusters, fetching everything in a specific cluster, and getting recent bookmarks by platform. The AI can call these to answer questions, build summaries, draft from your saved material, or pull relevant references for a coding task.

Stuck on something not covered here?

Email me directly. I'm the founder, I read every message, and I'd genuinely rather hear about a setup snag than have you give up.

Email [email protected]