Skip to Content
MCP GatewayConnect claude.ai

Connect claude.ai (web)

Use Scrapewise from claude.ai in your browser. ~2 minutes via Custom Connectors.

Prerequisites

  • A claude.ai account
  • A Scrapewise API key with scope LLM_READ or LLM_FULL. See Scopes.

Walkthrough

1 — Open Custom Connectors

  1. Sign in to claude.ai 
  2. Click your initials (top-right) → Settings
  3. In the left sidebar, find Connectors
  4. Click Add Custom Connector (top-right of the Connectors panel)

2 — Fill in the connector

A dialog opens. Fill it in:

FieldValue
NameScrapewise (or anything you’ll recognize)
MCP Server URLhttps://mcp.scrapewise.ai
AuthenticationSelect Custom header (NOT OAuth)
Header nameAuthorization
Header valueBearer sw_live_abc1234.your-secret-here (replace with your key, include Bearer with space)

Click Save / Add.

3 — Verify

claude.ai pings the gateway, discovers tools, and lists them on the connector page. You should see something like:

Connected · 28 tools available

If you see “Failed to connect” or “0 tools,” see Troubleshooting below.

4 — Use it in a conversation

Start a new conversation. Above the input box you’ll see a tools icon (a wrench or plug — the exact symbol depends on claude.ai version). Click it and verify Scrapewise tools are toggled on for this conversation.

Try:

Preview a scrape of https://example.com  — look for title and main heading

Claude calls scrapewise_preview_scraper_from_url and shows the result.

Update the key

To rotate the key:

  1. Settings → Connectors
  2. Click your Scrapewise connector
  3. Edit the Header value with the new bearer string
  4. Save

Disable temporarily

In a conversation, click the tools icon → toggle Scrapewise off for this conversation. The connector remains registered but isn’t exposed to that chat.

Remove

Settings → Connectors → click your Scrapewise connector → Delete connector at the bottom of the page.

Troubleshooting

”Failed to connect” when saving

  • 401: bad bearer. Re-check the header value — must be exactly Bearer (with space) followed by the full sw_live_<prefix>.<secret>.
  • 403: key scope is USER. The MCP gateway needs LLM_READ or higher. Mint a new key.
  • Network error: claude.ai couldn’t reach mcp.scrapewise.ai. Rare — check from a different network if persistent.

Connector saves but shows “0 tools”

Click into the connector → look at the Last error field. Most often this is 403 scope_rejected (which means auth worked but the key’s scope is wrong).

Tool calls inside a conversation return errors

  • Open the tool-call expansion in the chat — the error envelope from Scrapewise has a correlationId you can paste into a support ticket.
  • For 429, wait the Retry-After seconds and ask again.
  • For 429 cost_exceeded, you’ve hit the hourly cost budget — wait until the next hour.

What’s next