Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
AI tools

How to Integrate MCP with Claude Desktop (macOS, Windows and Linux)

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

To add MCP to Claude Desktop, either install a reviewed desktop extension from Settings > Extensions or register a local server in claude_desktop_config.json under the top-level mcpServers object. Restart Claude Desktop, then verify that the server’s tools appear. The exact file location and installation steps depend on your operating system and on whether the server is packaged as a DXT extension.

What MCP adds to Claude Desktop

Model Context Protocol (MCP) is an open standard for connecting AI applications to external systems. It is the interoperability layer; an MCP server supplies a particular data source, tool or workflow. That can be a local file system, database, search service, calculator or another specialist capability. The MCP documentation compares the protocol with a USB-C port for AI applications: one consistent connection method for many different peripherals.

Claude Desktop currently supports local MCP through desktop extensions (DXT) and through manual configuration. Anthropic describes the desktop MCP feature as beta, so labels and behavior can change between releases. A server is not automatically trusted just because it is listed online: review its source, permissions and requested secrets before installing it.

Check Claude Desktop and operating-system requirements

Install or update Claude Desktop from Anthropic before configuring a server. The currently documented platforms are:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Platform Minimum version listed by Anthropic Architecture
macOS macOS 11 or newer Not restricted in the installation article
Windows Windows 10 or newer Not restricted in the installation article
Linux (beta) Ubuntu 22.04 LTS or newer, or Debian 12 or newer x64 or arm64

You also need the dependencies required by the server you choose. For a manually configured server, that commonly means an installed runtime or executable, permission to launch it, and any API keys specified by the server’s own documentation. Do not substitute a guessed package name or command.

Choose an installation method

Desktop extension (DXT): the simplest path

Use a DXT when the server is available in Claude’s extension directory and you want Claude to manage its package and settings. Anthropic’s directory is a more visible review point than an arbitrary download, but you should still inspect what the extension can access.

  1. Open Claude Desktop.
  2. Choose Settings > Extensions.
  3. Browse the directory and select Install on the extension you trust.
  4. Enter required values, such as an API key, in the extension’s configuration panel.
  5. Restart or reload Claude Desktop and check that the extension’s tools are available.

To install a local package supplied as a .dxt file, go to Settings > Extensions > Advanced settings > Extension Developer > Install Extension…. Only use a file obtained from a source you can verify.

Manual JSON: maximum control

Manual configuration is useful for a private server, a server not present in the directory, or a setup you need to reproduce across machines. It requires more dependency and path management than a DXT.

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.
Method Installation effort Secret handling Dependency management Diagnostics
DXT directory extension Install and configure in the UI Configured in the extension; sensitive values are encrypted in the operating system’s secure storage Packaged by the extension Extension logs in Settings
Custom .dxt Download, then use the developer-install menu Configured in the extension Packaged by the file; verify its source Extension logs and debug logging
Manual JSON server Create JSON and install the server’s dependencies Environment or server-specific settings You maintain executable paths, versions and updates Claude debug logging plus the server’s own output

Find or create claude_desktop_config.json

Claude Desktop reads a different configuration path on each operating system:

Operating system Path
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Linux ~/.config/Claude/claude_desktop_config.json
Windows $env:AppDataClaudeclaude_desktop_config.json

The file may not exist on a new installation. Create the containing directory and file if necessary, using the spelling shown for your platform. Back up an existing file before editing it. Configuration is ordinary JSON: it cannot contain comments, and a missing comma or quote prevents the whole file from loading.

Add a local MCP server under mcpServers

Anthropic’s configuration structure places every server beneath a top-level mcpServers object. This is a pattern, not a working server command; replace the executable, package name, arguments and environment variable with values from the server’s official instructions.

{
  "mcpServers": {
    "example": {
      "command": "npx",
      "args": ["-y", "your-mcp-server"],
      "env": {
        "EXAMPLE_API_KEY": "use-a-secret-management-approach"
      }
    }
  }
}

Merge without deleting existing servers

If your file already has an mcpServers object, add a new sibling entry rather than replacing the object. For example, preserve the existing files entry and add search beside it. Each server name must be unique within that object. Keep the JSON value types supplied by the server documentation: a command is a string, arguments are an array, and environment values are strings unless the server explicitly says otherwise.

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

Keep credentials out of the article and source code

Use the extension’s settings panel or the environment mechanism expected by the server. Anthropic says desktop extensions encrypt sensitive values with the operating system’s secure storage, including Keychain on macOS and Credential Manager on Windows. Never commit a real key to a configuration file that is synchronized to a public repository. If a key has been exposed, revoke it at the provider and issue a replacement.

Restart and verify

  1. Save the JSON file with valid UTF-8 text and correct braces.
  2. Quit Claude Desktop completely, not just the chat window, then launch it again.
  3. Open a new conversation and look for the MCP tools or server controls.
  4. Run a harmless operation first, such as listing available resources, before allowing a tool to modify data.

The official guide notes that MCP interface elements appear only when at least one server is properly configured. A completely missing MCP control therefore points first to an absent, invalid or undiscovered configuration rather than to a problem with the prompt you typed.

Use MCP safely in daily conversations

Understand the trust boundary

A tool can send data to an external service or change local and remote state. Read the server’s documentation and source where possible, limit file and network permissions, and avoid placing personal or production credentials in a test configuration. Treat tool results as untrusted input: confirm destinations, amounts, file paths and destructive actions before approving them.

Make tool requests explicit

Tell Claude which source or operation you intend to use and what it must not change. Ask it to show a plan or a preview for operations that write, delete or publish. This does not replace the server’s authorization checks, but it makes accidental tool selection easier to spot.

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

Keep configurations portable

Paths and installed runtimes differ between macOS, Windows and Linux. If you move a configuration, re-check the executable path, working directory, permissions and environment variables on the destination machine. A JSON file copied successfully can still fail when its command is not on the new machine’s PATH.

Troubleshoot a server that is missing or not working

No MCP controls appear

  • Confirm that at least one server is installed through Settings > Extensions or listed under mcpServers.
  • Check that you edited the path for the operating system you are actually running.
  • Validate every brace, quote, comma and array bracket in the JSON. Remove comments and trailing commas.
  • Quit and relaunch Claude Desktop after saving changes.

The server fails to start

  • Run the documented executable outside Claude to confirm it is installed and launchable.
  • Check that command names an executable available to Claude, not only to an interactive shell. An absolute path can help when GUI applications receive a different PATH.
  • Compare every args value with the server’s official instructions, including capitalization and required flags.
  • Verify file permissions, working directories and runtime versions.

Authentication or permission errors

  • Re-enter the key in the extension configuration or the required environment variable; do not paste it into a chat.
  • Check that the key has the scopes needed by the requested tool and has not expired or been revoked.
  • On a shared computer, confirm that the account running Claude can read the configured secret and any local files the server needs.

The tool appears but returns blank or incorrect data

  • Ask the server for its available resources or help output to confirm that Claude is calling the intended tool.
  • Check network access, proxy settings, rate limits and service-side permissions.
  • Reduce the request to a small, read-only example. A minimal success case separates a prompt problem from a server or data-source problem.

Find useful logs

Open the extension’s logs from the Extensions settings panel when using a DXT. For deeper diagnosis, enable Claude Desktop debug logging and follow the MCP debugging guidance. Capture the exact error, operating system, Claude Desktop version and server version before changing several settings at once; that record makes a dependency or path regression much easier to identify.

Performance, reliability and maintenance

Every MCP call adds the startup, transport and upstream-service time of the server. A local process that starts for each request may feel slower than a long-running service, while a remote API can be limited by network latency and rate limits. Keep prompts and returned data focused, request only the fields you need, and avoid repeatedly fetching unchanged large resources.

Pin versions when the server supports it, update deliberately, and test a read-only tool after upgrades. Keep a known-good copy of claude_desktop_config.json so you can roll back a change. If several servers are configured, disable or remove an entry temporarily to identify conflicts. A server that times out, fails authentication or returns an empty result should not be counted as a successful workflow merely because its icon is visible.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
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 the MCP task you need is website capture, ScreenshotNeo provides an MCP server that AI agents can use, including Claude, Cursor and other MCP clients. It also has a direct HTTP API, so you do not need to install a browser, manage Playwright dependencies or maintain page-capture scripts. The API base is https://api.screenshotneo.com/v1/shot; the full parameter reference is in the ScreenshotNeo documentation.

One-call capture with cURL

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}`);

ScreenshotNeo accepts cookie and consent banners before capture and removes more than 60 known consent platforms, newsletter popups and chat widgets. You can turn each cleanup step off. Only clean shots are billed: bot checks or CAPTCHAs, blank pages, timeouts, failed loads and cache hits cost nothing, and each response reports the result through X-Page-Verdict and X-Billed headers. Its MCP server exposes screenshot tools to AI agents, including take_screenshot, get_page_info and capture_pdf.

For workflows that need more control, the service supports full-page captures with lazy images loaded, CSS-selector element capture, dark mode, device presets and custom viewports, retina scale, PDF paper size and page ranges, custom CSS and JavaScript, click-before-capture, selector waits, delays or network-idle waits, request and resource blocking, custom headers, cookies, user agents, Authorization, timezone and geolocation, transparent backgrounds, resizing, selectable cache TTLs, signed links, asynchronous jobs with signed webhooks, bulk capture of up to 100 URLs per call, a usage API and an OpenAPI specification. Parameter names used by other screenshot APIs also work, which can simplify migration.

Plan Included shots Price
Free 1,000 per month $0, no card
Starter 3,000 $5
Growth 15,000 $15
Pro 60,000 $39
Scale 250,000 $99
Business 1,000,000 $249

Every feature is included on every plan, and yearly billing provides two months free. The free tier includes 1,000 screenshots a month without a card. Create a free ScreenshotNeo account to get an access key and try the MCP or API workflow.

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

Frequently asked questions

Can one Claude Desktop installation use several MCP servers?

Yes. Add each server as a separate, uniquely named entry inside the same top-level mcpServers object. Keep each server’s command, arguments and environment settings independent.

Do I need an MCP server if a service offers an ordinary API?

No. An API can remain the better choice for deterministic application code. MCP is useful when you want Claude or another MCP client to discover and invoke the service’s tools during a conversation.

What should I do before uninstalling an extension?

Record any settings you will need later, revoke credentials that were used only by that extension, and remove its entry or package cleanly. Then restart Claude Desktop and confirm that the remaining servers still appear.

Frequently Asked Questions

Is MCP the same thing as Claude Desktop?

No. MCP is the open protocol; Claude Desktop is one client, and an MCP server provides the external capability.

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

Why does a valid-looking JSON file still fail?

A syntactically valid file can reference a missing executable, wrong argument, unavailable runtime or inaccessible secret. Check those runtime conditions and the extension or debug logs.

Can I install a DXT and configure a manual server together?

Yes. They can coexist, provided each server is valid and uniquely named. Add manual entries without replacing the existing configuration.

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.

Leave a Reply

Your email address will not be published. Required fields are marked *

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

Read next

Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.