The fastest reliable setup is: choose a local stdio process or a hosted HTTP endpoint, register it with claude mcp add, select the correct scope, approve the server when Claude Code asks, and verify it with claude mcp list, claude mcp get, or /mcp. This guide covers building a server, connecting existing services, converting configurations from other MCP clients, and fixing the connection failures developers see most often.
What you are setting up
The Model Context Protocol (MCP) is an open standard that lets an AI application connect to external tools, data sources, and workflows. Claude Code uses MCP servers to work with systems such as issue trackers, monitoring dashboards, databases, design tools, and messaging services.
An MCP server can run as a process on your computer or as a service reachable over a network. Claude Code starts a local process for a stdio server. For a hosted service, Claude Code connects to a remote transport such as HTTP. The right choice depends on where the code and credentials should live, who needs to share the integration, and whether the service must be reachable without your workstation running.
Choose the execution model and transport
| Model | Transport | Best fit | Operational behavior |
|---|---|---|---|
| Local | stdio |
A script or executable that Claude Code should launch on your machine | Claude Code owns the child-process startup and passes arguments to it |
| Remote | HTTP | A hosted MCP service or an internal endpoint | Claude Code connects to the URL; authentication is normally supplied with headers |
| Remote (legacy) | SSE | An existing service that has not added HTTP support | Still supported for older SSE-only services; use HTTP when the service offers it |
| Remote | WebSocket | A service that needs a persistent, bidirectional connection | Inspect its state with claude mcp get or /mcp; WebSocket servers do not appear in claude mcp list |
Use stdio when the server needs local files, local credentials, or a development loop. Use remote HTTP when the service is already hosted or must be shared without every developer installing the same runtime. SSE is a compatibility choice rather than a new deployment target when HTTP is available.
Recommended Free Tools
#1 Best Overall
- Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
- Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
- Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
- Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
- 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.
Build or obtain an MCP server
Use an existing server
Many services publish an MCP endpoint or a local launch command. Obtain the server from a source you trust, then identify its transport, required arguments, and authentication requirements before adding it to Claude Code.
Scaffold one with the official development plugin
Claude Code provides an mcp-server-dev plugin that asks about your use case and scaffolds either a remote HTTP server or a local stdio server.
- In Claude Code, install the plugin:
/plugin install mcp-server-dev@claude-plugins-official- Run the builder:
/mcp-server-dev:build-mcp-serverAnswer the prompts for the tools, data, and deployment style you need. The generated project is still your code: review its permissions, dependencies, and handling of untrusted input before connecting it to a working repository.
Add a local stdio server
Register a local server with the Claude Code CLI:
claude mcp add [options] <name> -- <command> [args...]For example, this registers a Python server named myserver:
claude mcp add --transport stdio myserver -- python server.py --port 8080The separator -- is significant. Everything after it is passed to your server. Without the separator, Claude Code can try to interpret a server flag such as --port as its own option.
Check the local launch contract
- Use the executable that is available in the environment where Claude Code runs (for example,
pythonor a project-specific runtime). - Put every server argument after
--, including ports, paths, and feature flags. - Make sure the process speaks MCP over standard input and standard output. Diagnostic logging should not corrupt the protocol stream.
- Keep machine-specific paths and secrets out of a project configuration that other developers will commit.
Add a remote HTTP server
Register a hosted endpoint by naming the transport and URL:
Rank #2
- 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
- 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
- Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
- 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
- What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.
claude mcp add --transport http <name> <url>For example:
claude mcp add --transport http notion https://mcp.notion.com/mcpIf the endpoint requires a bearer token, add an authorization header:
claude mcp add --transport http notion https://mcp.notion.com/mcp --header "Authorization: Bearer your-token"Do not commit a real token in a project file or paste one into a shared shell history. Prefer the credential mechanism documented by the service and rotate a token immediately if it is exposed.
Choose where the configuration applies
Without a scope option, claude mcp add writes to the local scope. You can explicitly choose one of three scopes:
| Scope | Use it when | Sharing implication |
|---|---|---|
| Local | The server is specific to this machine or your private development setup | Other projects and developers do not automatically receive it |
| Project | A repository team should use the same integration | It can be represented in a committed .mcp.json; review it like source code |
| User | You want the server available across your projects | It follows your user account rather than one repository |
Set a scope with --scope project or --scope user:
claude mcp add --scope project --transport http team-service https://example.invalid/mcp
claude mcp add --scope user --transport stdio personal -- python ~/tools/personal_server.pyA project-scoped server may remain unavailable until the workspace is trusted and you approve it. This is deliberate: a repository configuration can ask Claude Code to launch a process or call an external service.
Convert a configuration from another MCP client
Translate the source configuration by identifying what it actually contains:
- A URL becomes a remote entry. Preserve its transport as
http,sse, orws. - A launch command becomes a local
stdioentry. Put the executable and all its arguments after the--separator. - An
mcpServersblock contains several server objects. Extract one object at a time and pass it toclaude mcp add-json, rather than passing the entire block as one server.
A remote JSON entry must include its transport type. A URL without a type is interpreted as stdio, so Claude Code will attempt to launch it as a local command and the connection will fail. Use the server’s documented type: http where supported, sse for an older SSE-only endpoint, or ws for WebSocket.
Free tools Windows power users keep installed
One-click scans. No signup required.
Rank #3
- Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
- Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
- Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
- Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
- What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.
When moving a configuration between shells or operating systems, also check quoting, executable paths, environment variables, and header syntax. A configuration that parses successfully can still fail if the referenced binary or credential is absent on the new machine.
Approve and verify the connection
- Open the repository in a trusted Claude Code workspace if the server is project-scoped.
- Respond to the approval prompt for the project server. Until approval is granted, its status can remain Pending approval.
- List configured servers:
claude mcp list- Inspect one server in detail:
claude mcp get <name>- Inside a Claude Code session, run:
/mcpThe list and detail views expose states such as connected, authentication required, and failed. For WebSocket servers, use claude mcp get <name> or /mcp, because they do not appear in claude mcp list. Verification should include invoking a harmless read-only tool before allowing a new server to modify data.
Secure your server and its permissions
- Trust boundary: Connect only to servers whose code, operator, and requested permissions you understand.
- Prompt injection: A server that fetches external content can return hostile instructions disguised as data. Treat fetched pages, tickets, documents, and messages as untrusted input.
- Credentials: Keep tokens in environment variables or supported headers, not in committed
.mcp.jsonfiles. Use the narrowest permissions and shortest practical lifetime. - Scope: Choose local scope for experiments and project scope only after reviewing what every contributor will receive.
- Actions: Start with read-only tools, then add write operations individually. Confirm destructive operations in the tool’s own workflow.
- Logging: Ensure local diagnostic output goes somewhere other than the protocol stream, and avoid logging authorization headers or private data.
Or skip the browser setup
If the MCP server you need is for website screenshots, ScreenshotNeo is the first service to try: it removes consent banners, popups, and chat widgets before capture, bills only clean shots, and its lowest paid plan starts at $5.
One GET request returns a PNG, JPEG, WebP, or PDF. The service also provides an MCP server with take_screenshot, get_page_info, and capture_pdf tools for Claude, Cursor, and other MCP clients.
Do these 3 things before closing this tab:
1Fix the driver behind crashes, sound loss and screen glitches2Clear out junk files and repair common Windows errors3Scan for outdated or missing drivers - takes under a minuteUse the ScreenshotNeo API documentation for the complete option list. It supports full-page captures with lazy images loaded, CSS-selector element captures, dark mode, 12 device presets or custom viewports, retina scale, PDF paper and margin controls, custom CSS and JavaScript, clicks before capture, selector hiding, waits for selectors, delays or network idle, request and resource blocking, custom headers, cookies, user agents, authorization, timezone and geolocation, transparent backgrounds, resizing, configurable-TTL caching, signed image links, asynchronous jobs with signed webhooks, bulk capture for up to 100 URLs per call, usage reporting, and an OpenAPI specification. Parameter names used by other screenshot APIs are accepted to ease migration.
cURL:
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpPython:
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}`);Responses identify the result with X-Page-Verdict and whether it was billed with X-Billed. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits cost nothing. The Free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000. Create a free ScreenshotNeo account to get started.
Troubleshoot the common failures
The server is listed as pending approval
Cause: It is project-scoped and the workspace has not been trusted or the approval prompt has not been accepted.
Rank #4
- Dual Converters, Infinite Potential：Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
- Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
- Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
- Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
- Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft
Fix: Trust the workspace, approve the project server interactively, then run claude mcp get <name> and /mcp again.
A local server fails immediately
Cause: A server argument was parsed by Claude Code, the executable is missing, or the process wrote protocol-breaking output to standard output.
Fix: Re-add it with every server flag after --, verify the runtime and working paths, and send diagnostics to standard error or a file instead of standard output.
A remote URL is treated like a command
Cause: A JSON configuration omitted its transport type, so the URL defaulted to stdio.
Fix: Add type: "http", type: "sse", or type: "ws" as required by the endpoint, then register the corrected server.
The remote server says authentication is required
Cause: The endpoint expects a bearer token or another credential that was not supplied, has expired, or lacks permission.
Best Value
- 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
- Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
- Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
- HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
- What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
Fix: Confirm the endpoint’s authentication method, add the documented header with --header, replace expired credentials, and check the detailed status with claude mcp get <name>.
The server is absent from claude mcp list
Cause: It may be a WebSocket server, which is not shown in that list.
Fix: Inspect it with claude mcp get <name> or the in-session /mcp command.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
The connection is shown as failed
Cause: The URL is unreachable, the transport does not match the service, a proxy blocks the connection, or the server process exits during startup.
Fix: Recheck the exact endpoint and transport, test network access from the same environment as Claude Code, verify required headers, and inspect the server’s own logs. For local servers, run the command manually with the same arguments to expose missing dependencies or permissions.
Run multiple servers safely
You can register separate servers for separate systems; give each a descriptive name and scope them independently. Keep a team server project-scoped when everyone needs the same tools, while keeping personal utilities local or user-scoped. Document what each server can read or change, and remove an integration when its credentials or business need ends.
For production-like workflows, verify a server after upgrades, monitor authentication expiry, and test a read-only tool before enabling write actions. The CLI status commands and /mcp view give you a repeatable check of configuration, authentication, and connection health.
Crashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minuteWindows Errors? Fix Them Before They Spread
Repair common Windows errors and clear accumulated junk for a smoother, more stable PC - no reinstall needed.Free scan · no reinstallQuick Recap
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.
