Setup guide

Use GetScreenshot in Claude Desktop

Add the GetScreenshot MCP server to claude_desktop_config.json. Claude can then capture any public page, render HTML, and compare before and after, right in a chat.

Works with any GetScreenshot API key on any plan, from $5/month.

What you get

Five tools that let the agent look at web pages

Look at any public page

The agent passes a URL to capture_screenshot. A hosted browser renders the page and the tool returns images sized for vision models, plus a link to the full-resolution file.

Render HTML it just wrote

render_html takes an HTML string and returns a screenshot of it. The agent can check a component or email template without a local browser.

Compare before and after

compare_screenshots diffs two pages or two earlier captures and reports the share of changed pixels, where the change is, and a diff image.

Limits worth knowing: captures run on our servers, so they cannot reach localhost or private networks. Each call is a single capture, not a logged-in browsing session. For multi-step browser automation see GetScreenshot vs Playwright MCP. Screenshot links are public URLs that stay available for 30 days.

Before You Start

Three things to have ready

A GetScreenshot API key

Any plan works. Plans start at $5/month for 2,500 screenshots. Get a key.

Claude Desktop

Claude Desktop installed (macOS, Windows or Linux).

Node.js 20.9 or newer

Only for the local option, which runs npx -y getscreenshot-mcp on your machine. The hosted option needs nothing installed.

How to Set Up

Hosted server at https://mcp.getscreenshotapi.com/mcp, or a local server started with npx

The dependable path for Claude Desktop is the local server, set up in its config file. A hosted option exists but is not available to every account. It is described after the steps. Both give the agent the same five tools and use the same API key and quota.

1

Get your API key

Pick a plan on the pricing page. The key arrives by email after checkout. The MCP server works with any API key on any plan, including Lincoln at $5/month for 2,500 screenshots. Code FREE5 makes the first month of the $5 plan free. If you lose the key, recover it from your account page.

View pricing plans
2

Open the config file

Open the Claude menu in your system menu bar and choose Settings.... In the Settings window, open the Developer tab and click Edit Config. This opens the file, and creates it if it does not exist yet:

  • • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • • Linux: ~/.config/Claude/claude_desktop_config.json
3

Add the local server

Add the getscreenshot entry, with your key in place of YOUR_API_KEY. Claude Desktop starts the server on your machine with npx, so it needs Node.js 20.9 or newer. Check with node --version.

claude_desktop_config.json

{
  "mcpServers": {
    "getscreenshot": {
      "command": "npx",
      "args": ["-y", "getscreenshot-mcp"],
      "env": {
        "GETSCREENSHOT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

If the file already has an mcpServers object, add the getscreenshot entry inside it.

This file holds your key in plain text. It lives in your user profile, not in a project. Do not copy it into a repository or a synced dotfiles folder with the key in it.

4

Restart Claude Desktop

Save the file, then quit Claude Desktop completely and start it again. Closing the window is not enough. The app reads the config and starts the server only at launch.

5

Confirm it is connected

In a chat, click the Add files, connectors, and more button at the bottom left of the message box. Hover over Connectors, click Manage connectors, and select getscreenshot. You should see its five tools.

6

Try a prompt

Ask for a screenshot of a public page. Claude asks for your approval before it runs a tool.

Take a screenshot of https://example.com and describe what is above the fold.

Hosted server as a custom connector (limited availability)

Claude can also reach a remote MCP server as a custom connector. Our hosted server at https://mcp.getscreenshotapi.com/mcp authenticates with your API key in a request header. It does not use OAuth sign-in. Claude's connector dialog can send a fixed request header, but Anthropic's documentation describes that feature as a beta available to a limited set of organizations. If your dialog has no Request headers section, use the local setup above.

  1. 1. Go to Customize > Connectors, select Add, then Add custom connector.
  2. 2. Enter a name and the server URL https://mcp.getscreenshotapi.com/mcp, then continue.
  3. 3. Under Authentication, choose No sign-in.
  4. 4. Under Request headers (it may sit under Advanced), choose the authorization header and enter the value Bearer YOUR_API_KEY. Include the word Bearer and the space. Claude sends the value exactly as you type it. Our server also accepts the x-api-key header with the key alone as its value.
  5. 5. Click Add. Turn the connector on for a chat from the + button, under Connectors.
  • • Authentication settings cannot be edited after you add a connector. To change the key, remove the connector and add it again.
  • • On Team and Enterprise plans an Owner adds the connector under Organization settings > Connectors. A key stored in a request header is shared by every member who uses that connector, and so is its monthly quota.
  • • Custom connectors are called from Anthropic's cloud, not from your computer. That works for our hosted server because it is on the public internet.

Prompts to Try

Replace the example URLs and file names with your own

Review a live page

Take a full-page screenshot of https://example.com/pricing and give me feedback on the layout and copy.

Check HTML

Render this HTML with render_html and tell me how it looks: <h1 style="font-family:sans-serif">Hello</h1>

Compare two pages

Compare https://staging.example.com with https://www.example.com and describe what changed.

Save a page as PDF

Save https://example.com/terms as a PDF and give me the link.

Each page captured uses one screenshot from your monthly quota. A comparison uses one per page it has to capture.

Tools the Server Adds

All five are read-only. Full inputs and outputs are in the MCP server reference

Tool What it does
capture_screenshot Capture a public web page as images the model can see. Options cover full-page capture, a single element by CSS selector, device presets and wait conditions.
render_html Render an HTML string (up to 2 MB) and screenshot it. Useful for a component or page the agent just wrote.
compare_screenshots Visual diff of two pages or two earlier screenshots. Returns the changed-pixel percentage, the bounding box of the change and a diff image.
capture_pdf Save a page as an A4 PDF and return a link that works for 30 days.
get_usage Screenshots used, monthly limit and reset date for your key. Costs 1 quota unit.

Troubleshooting

Common issues and how to resolve them

getscreenshot does not appear in the connector list

  • • Check that the config file is valid JSON. A missing comma or brace stops every server in the file from loading.
  • • Quit Claude Desktop completely and start it again.
  • • Read the logs: ~/Library/Logs/Claude on macOS, %APPDATA%\Claude\logs on Windows, ~/.config/Claude/logs on Linux. mcp.log covers connections and mcp-server-getscreenshot.log holds the server's own output.
  • • Run npx -y getscreenshot-mcp in a terminal to see whether Node.js can start the server. Stop it with Ctrl+C.

Tools say no API key is configured

  • • Check that GETSCREENSHOT_API_KEY is spelled exactly like that inside the env object and that the value has no extra spaces.
  • • Restart Claude Desktop after every change to the file.

A tool call times out on a slow page

  • • Ask the agent to retry with wait_until: "domcontentloaded". It is the fastest setting and the most reliable on heavy sites.
  • • A capture usually takes around 9 seconds. The API gives up after 90 seconds.
  • • Failed captures still count against your monthly quota, so change the settings before retrying more than once.

The agent cannot capture localhost or an internal site

  • • The capture runs on our servers, which cannot reach localhost or private networks.
  • • For markup the agent just wrote, use render_html with the HTML itself. Inline the CSS and images or set <base href>, because relative asset URLs will not resolve.
  • • For a running app, give the agent a public preview URL or a tunnel address.

The image is too large for the conversation

  • • Ask for return: "url_only" to get the screenshot_url without inline images.
  • • Capture one part of the page with element and a CSS selector instead of the full page.
  • • Lower max_slices (default 4) to limit how many images a full-page capture returns.

Still stuck? Email support@rasterwise.com.

Other AI Clients

The same server works in other MCP clients. See all options on the AI Agents page

Prefer instructions the agent loads on demand? See the GetScreenshot agent skill.

GetScreenshot is an independent product. It is not affiliated with or endorsed by the makers of Claude Desktop. Product names belong to their owners.

Get an API Key and Connect Claude Desktop

Plans start at $5/month for 2,500 screenshots. The MCP server works with any API key on any plan.