MCP Integration

Use ScanAtlas with Claude Desktop and Cursor IDE

The Model Context Protocol (MCP) lets AI assistants like Claude interact with external tools. With ScanAtlas MCP, you can scan websites and fix issues using natural language.

Why use MCP?

•Scan sites with natural language: "Scan my website and find all broken links"
•Get AI-powered fix suggestions directly in your IDE
•Automate pre-deploy checks in your development workflow

Prerequisites

1
Starter or Pro plan
MCP access requires a paid plan. View plans
2
API Key
Generate one in Settings → API
3
Node.js 18+
Required for running the MCP server

Claude Desktop Setup

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

json

{
  "mcpServers": {
    "scanatlas": {
      "command": "npx",
      "args": ["-y", "@scanatlas/mcp"],
      "env": {
        "SCANATLAS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Replace sa_live_your_api_key_here with your actual API key. Restart Claude Desktop after saving.

Cursor IDE Setup

Add this to your Cursor MCP config file:

Location: ~/.cursor/mcp.json

json

{
  "mcpServers": {
    "scanatlas": {
      "command": "npx",
      "args": ["-y", "@scanatlas/mcp"],
      "env": {
        "SCANATLAS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Replace the API key and restart Cursor after saving.

Available Tools

run-scan

Start a new website scan. Supports public or authenticated scans.

Parameters:

• url (required) - The URL to scan
• scanType (optional) - "public" or "authenticated"
• sessionCookie (optional) - Cookies for authenticated scan
• credentials (optional) - Login credentials for auto-authentication
• waitForCompletion (optional) - Wait for scan to finish (default: true)

Example prompt:

"Scan https://example.com for issues"

get-issues

Get issues from a scan, filtered by route or severity

Parameters:

• scanId (optional) - Uses most recent scan if not provided
• route (optional) - Filter by page
• severity (optional) - critical, high, medium, or low

Example prompt:

"Show me critical issues from my last scan"

get-fixes

Get prioritized fix suggestions sorted by severity

Parameters:

• scanId (optional)
• limit (optional) - Max issues to return (default: 10)

Example prompt:

"What should I fix first?"

get-summary

Get an LLM-optimized summary of scan results

Parameters:

• scanId (optional)

Example prompt:

"Give me a summary of my site health"

Authenticated Scans

Scan pages that require authentication using one of two methods:

1Session Cookies

If you have access to your browser cookies (from DevTools), pass them directly:

"Scan https://myapp.com/dashboard with session cookies: session=abc123; auth_token=xyz789"

Tip: Open DevTools → Application → Cookies to copy your session cookies

2Demo Credentials

Provide login credentials and ScanAtlas will authenticate automatically:

"Scan https://myapp.com/dashboard with login credentials:
- Login URL: https://myapp.com/login
- Username: demo@example.com
- Password: demo123"

Best for: Staging environments with test accounts, demo sites

Security note: Only use demo/test credentials with MCP. Never share production passwords with AI assistants.

Example Workflows

Scan and Fix

Scans your site and walks through fixing each issue

"Scan https://mysite.com and help me fix all the critical issues"

Pre-deploy Check

Quick health check before deploying changes

"Scan my staging site and tell me if it's ready for production"

SEO Audit

Targeted analysis for SEO improvements

"Scan https://mysite.com and focus on SEO issues like missing meta tags"

Accessibility Review

Find and fix a11y problems

"Scan my site and list all accessibility issues by page"

Authenticated Scan (Cookies)

Scan logged-in pages using your existing session cookies

"Run an authenticated scan on https://myapp.com/dashboard with these session cookies: session=abc123; auth_token=xyz789"

Authenticated Scan (Login)

Auto-authenticate with demo credentials to scan protected pages

"Scan https://myapp.com/dashboard with login credentials: login URL is https://myapp.com/login, username is demo@example.com, password is demo123"

Troubleshooting

MCP server not connecting?

• Verify your API key is correct and starts with sa_live_
• Make sure you have Node.js 18 or higher installed
• Restart Claude Desktop or Cursor after changing the config

Scans not working?

• Check that you have scans remaining in your plan
• Verify the URL is publicly accessible
• Check your billing settings for usage details

Ready to get started?

Generate your API key and start scanning with AI.

Get API Key