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 \
  --header 'Authorization: Bearer sw_live_abc1234.your-secret-here'

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

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

Verify

claude mcp list

You should see:

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

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 scrapers

Claude Code picks scrapewise_list_scrapers and calls it. 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 \
  --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.

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