Skip to Content
MCP GatewayConnect Claude Code

Connect Claude Code

Claude Code  is Anthropic’s CLI for agentic coding. ~30 seconds to add Scrapewise.

Prerequisites

  • Claude Code installed (npm install -g @anthropic-ai/claude-code or via Anthropic’s installer)
  • A Scrapewise API key with scope LLM_READ or LLM_FULL. See Scopes.

Add the connection

One command:

claude mcp add scrapewise --transport http https://mcp.scrapewise.ai/mcp \
  --header 'Authorization: Bearer sw_live_abc1234.your-secret-here'

Replace sw_live_abc1234.your-secret-here with your key.

A Full key (LLM_FULL) lists every tool. A Read key (LLM_READ) lists the read tools.

The single quotes around the --header value prevent the shell from expanding $ or backticks in the secret.

Verify

claude mcp list

You should see:

scrapewise   http   https://mcp.scrapewise.ai/mcp   ✓

The ✓ means Claude Code reached the gateway, authenticated, and discovered tools. If you see ✗, the connection failed — read the next section.

Use it

Start Claude Code:

claude

In any conversation, ask:

List my Scrapewise groups

Claude Code picks scrapewise_get_scraper_group_list and calls it. This tool is on both lists and costs nothing. An empty list on a new account still means the connection works. Tool calls appear in the transcript as collapsible blocks.

Remove

claude mcp remove scrapewise

Inspect what’s registered

claude mcp get scrapewise

Shows the URL, transport, and (masked) headers.

Update the key

To rotate your key, remove + re-add:

claude mcp remove scrapewise
claude mcp add scrapewise --transport http https://mcp.scrapewise.ai/mcp \
  --header 'Authorization: Bearer sw_live_new1234.new-secret'

Troubleshooting

claude mcp list shows ✗

Run with verbose:

claude --verbose mcp list 2>&1 | head -30

Common causes:

  • HTTP 401: bad key. Verify the full sw_live_<prefix>.<secret> string.
  • HTTP 403 scope_rejected: key has USER scope, MCP requires LLM_READ or higher.
  • ENOTFOUND mcp.scrapewise.ai: DNS issue. Try curl https://mcp.scrapewise.ai.
  • Connection refused: Network firewall blocking outbound HTTPS to mcp.scrapewise.ai:443. Check corporate proxy.

Only a few tools, and none that creates or runs a scraper

Tools that create or run are missing: the key is LLM_READ. Create an LLM_FULL key.

Tools don’t appear in claude REPL

  • Confirm claude mcp list shows scrapewise ✓.
  • Restart claude (Ctrl-D / exit, then claude again).
  • Some Claude Code versions require an explicit /tools command in the REPL to re-discover.

Per-project vs global config

claude mcp add adds to your user config (~/.claude.json). If you want a per-project MCP (e.g. one project uses Scrapewise, another doesn’t), you can:

# Add at project scope
claude --project mcp add scrapewise ...
 
# Or edit .claude.json in the project root

What’s next

Connect Claude DesktopConnect claude.ai