Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Web MCP is not one universal service. It means connecting Claude Code to an MCP server that provides web-related tools such as search, page retrieval, or browser control. To use one, install the server with the command and credentials documented by its provider, verify it with claude mcp list and /mcp, then ask Claude to perform a task that requires that server.

This guide shows the complete workflow using Anthropic’s official examples, explains hosted HTTP and local stdio servers, and separates MCP configuration from Anthropic’s API-only web tools.

What “Web MCP” means in Claude Code

The Model Context Protocol (MCP) gives Claude Code access to tools outside its built-in set, including issue trackers, databases, and browser-control systems. A “web MCP” is therefore a web-capable MCP server selected by you; it is not a single endpoint maintained by Claude Code.

A provider may expose search, page fetching, browser automation, or several of these. Its current documentation determines the server URL or process command, transport, authentication, tool names, limits, and supported capabilities. Do not assume that a server offering browser control also provides search, or that a search server can fetch arbitrary pages.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Choose the capability and server first

Search, page reading, or browser control?

  • Search: returns web results or provider-specific search data.
  • Page retrieval: downloads or extracts a particular URL.
  • Browser automation: opens pages and interacts with them, often through a local browser process.
  • Combined providers: expose more than one of these, but only their documentation establishes what is supported.

Before running a command, record the provider’s transport (such as HTTP, SSE, or stdio), endpoint or process command, required environment variables, authentication method, and tool names. The official Claude Code pages do not endorse one general-purpose web-search MCP provider.

Hosted and local configurations

Choice Hosted HTTP Local stdio
Where it runs Remote hosted service Local process started by Claude Code
Configuration shape --transport http plus a server URL Process command after --
Official example Claude Code documentation search Playwright browser automation
Main dependencies Network access and any service authentication Local runtime and package/browser prerequisites
Available scopes local, user, or project local, user, or project

Add a hosted HTTP MCP server

The official quickstart uses Claude Code’s documentation server as its hosted example:

claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp

This connects to documentation search, not a general web search engine. For a real web provider, replace both the name and URL with the exact values in that provider’s current instructions.

Authentication

If the provider uses OAuth, add the server and complete sign-in when Claude Code prompts you through /mcp. If it uses a static token or API key, follow the provider’s documented environment-variable, header, or command-line method. Do not place a secret in a project file that will be committed.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Add a local stdio MCP server

The official browser-automation illustration starts Playwright locally:

claude mcp add playwright -- npx -y @playwright/mcp@latest

The -- separates Claude Code options from the process command. The quickstart requires Node.js 18 or later for this example. Playwright demonstrates browser automation; it is not itself a universal web-search service. A different local server may require another runtime, executable, or environment variable.

Choose the right configuration scope

Local (the default)

The default local scope applies to the current project for your user. Claude Code stores it in ~/.claude.json under that project’s entry. Use it when the server is for one repository or when you are still evaluating it.

User scope

--scope user places the server in the top-level mcpServers entry in ~/.claude.json, making it available across your projects:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
claude mcp add --scope user --transport http claude-code-docs https://code.claude.com/docs/mcp

Project scope

--scope project writes configuration to .mcp.json in the project root so it can be shared with teammates. Claude Code asks users to approve project-scoped servers. Review the command, URL, and exposed settings before committing this file. Claude Code reads .mcp.json when a session starts, so restart Claude Code after editing it.

Verify that the server is connected

  1. In a terminal, run claude mcp list to see configured servers and their connection state.
  2. Start Claude Code and enter /mcp to inspect the server, authentication state, and discovered tools.
  3. Ask Claude for a task that clearly requires the server. For the official example, use: Use the claude-code-docs server to look up how MCP server scopes work.
  4. Check Claude’s output and confirm that the tool call is labeled with the expected server name.

For a web-search server, replace the name and question with the provider’s documented capability. Naming the server is useful when a built-in tool could answer a similar question, because it makes the intended route explicit.

How to make Claude use the web MCP server

State the server name and the operation you want. For example: Use the my-search-server MCP server to find the provider’s current API limits, then list the source URLs. If the server supports page retrieval, ask Claude to open a specific URL. If it supports browser actions, describe the page interaction precisely.

Do not promise search-engine coverage, citations, freshness, or unrestricted page access unless the selected provider documents those features. MCP only supplies the connection; the server determines the result quality and available tools.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Common problems and fixes

No MCP servers configured

Make sure you ran claude mcp add in the intended project and used a supported location: ~/.claude.json or a project-root .mcp.json. Claude Code does not read arbitrary configuration paths. Run claude mcp list again after correcting the scope or directory.

Failed connection

Run claude mcp get <name> and compare the endpoint or process command with the provider’s documentation. Check DNS and network access, OAuth completion, API keys, required environment variables, and whether a corporate proxy blocks the connection.

Connected, but no tools appear

Open /mcp and inspect discovery details. Missing API keys or other environment variables can allow a process to start without registering usable tools. Correct the variable in the documented location, restart Claude Code, and inspect the tool list again.

Changes to .mcp.json are ignored

End the current session and start a new one. Project configuration is read at session start.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Local startup times out

The official troubleshooting guide describes a 30-second default startup timeout and documents MCP_TIMEOUT in milliseconds for increasing it. Set it only as needed, and verify the current reference before relying on the value because command behavior can change.

Claude uses another tool

Ask explicitly for the MCP server by name and request an operation unique to it. Then inspect the transcript for the server label. If the task can be answered by a built-in capability, Claude may choose that instead unless your prompt requires the MCP tool.

Keep MCP separate from Anthropic’s API web tools

Anthropic’s platform documentation lists versioned web-search and web-fetch tool types for API integrations. Those tools are distinct from adding an MCP server to the Claude Code CLI. The API’s MCP connector also has separate mcp_servers and mcp_toolset configuration and requires the server to be publicly exposed over HTTP. Do not copy API connector settings into Claude Code commands, or assume that an API web tool is automatically installed in Claude Code.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or skip the browser setup

If your goal is reliable screenshots rather than interactive browsing, ScreenshotNeo provides a website screenshot API and MCP server. It accepts consent banners before capture and removes more than 60 known consent platforms, newsletter popups, and chat widgets; each cleanup step can be disabled. Bot checks, CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, and responses identify the page verdict and billing status.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Use its MCP server with Claude, Cursor, or another MCP client, or call the API directly. The API supports PNG, JPEG, WebP, and PDF output. The simplest cURL request is:

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

Python:

import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"}, timeout=90)
open("shot.webp", "wb").write(r.content)

Node.js:

const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);

See the complete options and MCP setup in the ScreenshotNeo documentation. Features include full-page and selector captures, device and viewport settings, retina scale, custom CSS and JavaScript, waits, request blocking, cookies and headers, geolocation, dark mode, PDFs, caching, signed links, asynchronous jobs, webhooks, bulk capture, and a usage API. The Free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000 shots. Create a free ScreenshotNeo account to get started.

Security and operating practices

  • Keep API keys and OAuth tokens out of prompts, committed files, and shell history where practical.
  • Use local scope for experiments and user scope only when every project should access the server.
  • Review project-scoped commands before approving them, especially when they execute packages with npx.
  • Pin a package version when reproducibility matters instead of using a moving @latest tag.
  • Confirm what URLs and page data the provider receives before sending private or authenticated content.

Frequently Asked Questions

Is Web MCP built into Claude Code?

Claude Code supports MCP connections, but “Web MCP” is a category rather than a single built-in provider. You must add a server that documents the web capability you need.

Which transport should I choose?

Use the transport required by the provider. Hosted services commonly document an HTTP-style URL, while local integrations commonly provide a stdio process command.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Can the Playwright MCP search the web?

The official example demonstrates browser automation. Its documentation does not make it a universal web-search provider, so use a server that explicitly documents search if search is your requirement.

Where can I see the tools an MCP server exposes?

Run /mcp inside Claude Code after connecting. The server entry shows its status and discovered tools.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.