MCP Server Setup

Connect your AI coding assistant to Scrayle in under 2 minutes. This guide covers VS Code (GitHub Copilot), Cursor, and Claude Desktop.

Prerequisites

A Scrayle account with an API key (get one here)
An editor that supports MCP over HTTP

⚠️Keep your API key safe

Your API key grants full access to your Scrayle account. Never share settings files containing your key publicly.

VS Code (GitHub Copilot)

Requires VS Code 1.99+ with GitHub Copilot Chat extension.

Option 1: User Settings (all workspaces)

Open Settings (JSON) via Ctrl+Shift+P → "Preferences: Open User Settings (JSON)" and add:

{
  "mcp": {
    "servers": {
      "scrayle": {
        "type": "http",
        "url": "https://mcp.scrayle.com/mcp",
        "headers": {
          "x-api-key": "YOUR_API_KEY"
        }
      }
    }
  }
}

Option 2: Workspace Settings (per-project)

Create .vscode/mcp.json in your project root:

{
  "servers": {
    "scrayle": {
      "type": "http",
      "url": "https://mcp.scrayle.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

💡Using environment variables

You can use ${env:SCRAYLE_API_KEY} instead of hardcoding your key. Set the SCRAYLE_API_KEY environment variable on your system and reference it in the config.

Cursor

Open Cursor Settings → MCP tab → Add Server:

{
  "mcpServers": {
    "scrayle": {
      "url": "https://mcp.scrayle.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop

Edit claude_desktop_config.json (find it via Claude Desktop → Settings → Developer):

{
  "mcpServers": {
    "scrayle": {
      "type": "url",
      "url": "https://mcp.scrayle.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Verify Connection

After adding the config, verify the connection:

Open your AI assistant chat (e.g., Copilot Chat in VS Code)
Switch to Agent mode if available
You should see Scrayle tools listed (look for a tools icon or tool list)
Try a test prompt: "Use scrayle to scrape https://example.com"

Self-Hosted Option

If you prefer to run the MCP server locally:

# Clone and install
git clone https://github.com/scrayle/mcp-server.git
cd mcp-server
npm install

# Configure
export SCRAYLE_API_KEY=your_api_key
export SUPABASE_URL=your_supabase_url
export SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

# Run
npm run dev

Then point your editor to http://localhost:5000/mcp instead of the hosted URL.

Troubleshooting

Tools not appearing

Make sure you are in Agent mode (not Ask mode) in Copilot Chat
Verify the URL is exactly https://mcp.scrayle.com/mcp (including the /mcp path)
Check that your API key is valid in the dashboard

Authentication errors

Ensure the header key is x-api-key (lowercase, with hyphen)
Check your API key has not been revoked or expired

Connection timeouts

The MCP server uses SSE (Server-Sent Events) for streaming. Some corporate proxies may block SSE connections
Try the self-hosted option if you are behind a restrictive firewall