Claude MCP: How to Add MCP Servers to Claude, Claude Desktop and Claude Code
Add an MCP server to Claude: connectors in claude.ai and Claude Desktop, claude mcp add and scopes in Claude Code, config files, local vs remote, and OAuth.
Claude MCP support comes in three forms: connectors in claude.ai and the Claude desktop app, local servers in Claude Desktop, and the claude mcp add command in Claude Code. A remote server needs its URL and a sign-in in your browser. A local server needs a command that runs on your computer. Each section uses the Encited MCP server, https://encited.com/api/mcp, as its example; it's a remote server that signs you in with OAuth. Menu names and commands match Anthropic's docs as of November 2026. For what MCP is and how a server works, read what is an MCP server.
TL;DR
- claude.ai and Claude Desktop: go to Customize > Connectors, then connect a server from the directory, or select Add custom connector and paste its URL.
- Local servers in Claude Desktop: install a desktop extension (
.mcpb), or add the server toclaude_desktop_config.json. - Claude Code:
claude mcp add --transport http encited https://encited.com/api/mcp, then/mcpto sign in. - Claude Code scopes:
local(the default, you in this project),project(.mcp.json, shared with your team) anduser(you in every project). - Connectors you add on claude.ai show up in Claude Code when you sign in with the same Claude account.
Where Claude can use MCP servers
| Claude app | Remote servers | Local servers | Where you add them |
|---|---|---|---|
| claude.ai | Yes, as connectors | No | Customize > Connectors |
| Claude desktop app | Yes, as connectors | Yes, as desktop extensions or in claude_desktop_config.json | Customize > Connectors for remote, Settings for local |
| Claude mobile apps | Yes, the connectors on your account | No | Add them on claude.ai or in the desktop app |
| Claude Code | Yes | Yes | claude mcp add, .mcp.json, or your claude.ai connectors |
Add an MCP server to Claude with a connector
From the Connectors directory
- Go to Customize > Connectors at claude.ai/customize/connectors. In the desktop app, select Customize in the sidebar, then Connectors.
- Select Discover and search for the service. Each listing carries a label: Anthropic has tested a Verified connector's tools, and has screened a Community connector without an in-depth review.
- Select Connect to Claude, sign in to the service, and approve the access it asks for. On claude.ai the sign-in page opens in the same tab; the desktop app opens it in your browser.
- Back on the Connectors page, the server is listed under Your connectors with the status Connected.
On Team and Enterprise plans, an Owner adds the connector for the organization first, then each member connects with their own account.
Encited is in the directory at claude.ai/directory/encited. Open it, select Connect to Claude, and sign in to Encited.
By URL, as a custom connector
A server that isn't in the directory goes in as a custom connector. On Free, Pro, Max and Ultra plans:
- Go to Customize > Connectors.
- Select Add custom connector.
- Enter a name and the remote MCP server URL.
- If the dialog asks for authentication settings (the options are under sign-in and OAuth), choose them, then select Add.
The Free plan allows one custom connector. On Team and Enterprise plans, an Owner adds it under Organization settings > Connectors: Add, then Custom, then Web. Members then find it under Customize > Connectors with a Custom label and select Connect.
For Encited, name it Encited and paste https://encited.com/api/mcp. Under Authentication, choose Sign in now. Under OAuth client, pick Register automatically. Encited's OAuth metadata lists a client registration endpoint and reports client_id_metadata_document_supported: false, so Use Claude's published identity doesn't work with it.
You can't change a custom connector's authentication settings after you add it. To change them, remove the connector and add it again.
Turn the connector on in a chat
- In a chat, select + in the message box, then Connectors, and switch the connector on. The toggle applies to that conversation only.
- When Claude wants to use one of its tools, it can ask you first: Allow once or Always allow.
- To set this per tool, open the connector under Customize > Connectors and use Tool permissions: Always allow, Needs approval or Blocked.
The same Encited server connects to ChatGPT, Cursor and Lovable, and each app's steps are on the Encited MCP page. Every app you connect reads the same Search Console, audit and AI visibility data.
Add a local MCP server to Claude Desktop
Install a desktop extension
A desktop extension is a local MCP server packed into one .mcpb file (an MCP Bundle).
- In Claude Desktop, go to Settings > Extensions.
- Drag the
.mcpbfile onto the page, or select Advanced settings, then Install Extension… and choose the file. - Check the preview, select Install, then confirm.
Claude Desktop builds a settings form for anything the extension needs, such as an API key. It also includes its own Node.js, so Node-based extensions run without a separate install.
Edit claude_desktop_config.json
A server that comes as a command goes in Claude Desktop's config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
The MCP docs open it from the Claude menu in your system's menu bar: Settings…, then the Developer tab, then Edit Config. Add each server under mcpServers. This entry runs the reference Filesystem server with access to two folders:
{"mcpServers": {"filesystem": {"command": "npx","args": ["-y","@modelcontextprotocol/server-filesystem","/Users/username/Desktop","/Users/username/Downloads"]}}}
Replace username with your own and keep the paths absolute. This route runs through npx, so Node.js has to be installed on your computer. Quit Claude Desktop completely, open it again, and check the server under + and Connectors in a chat.
This file holds local servers only. Add a remote server such as Encited under Customize > Connectors.
Add an MCP server to Claude Code
Run claude mcp add in your shell, outside a claude session.
Remote server (HTTP)
claude mcp add --transport http <name> <url>
For Encited:
claude mcp add --transport http encited https://encited.com/api/mcp
The command prints a line that starts with Added. claude mcp list then shows ! Needs authentication until you sign in:
- Start Claude Code with
claude. - Type
/mcp, selectencited, press Enter and chooseAuthenticate. - Your browser opens Encited's sign-in page. Approve the connection there.
You can also sign in from your shell with claude mcp login encited. Over SSH, with no browser on the machine, it prints the sign-in URL: open it on your own computer, then paste the redirect URL back at the prompt.
A server that takes a fixed token gets it as a header when you add it, for example --header "Authorization: Bearer your-token". Servers on the older SSE transport, which is deprecated, work with the same --transport http command in Claude Code v2.1.265 and later. On older versions, pass --transport sse.
Local server (stdio)
Everything after -- is the command Claude Code runs to start the server:
claude mcp add playwright -- npx -y @playwright/mcp@latest
Playwright gives Claude a browser it can open and read, and it needs Node.js 18 or later. Pass API keys with --env KEY=value, placed before the --.
Manage your servers
claude mcp list # every server and its statusclaude mcp get encited # one server's details, including its scopeclaude mcp remove encited # delete the entry
Inside a session, /mcp shows each server's status, signs you in again and turns a server off for the project. claude mcp remove deletes the tokens Claude Code stored, but it doesn't revoke them at the server. Run claude mcp logout <name> first for that.
Claude Code MCP scopes
The --scope flag decides where Claude Code saves a server and who gets it.
| Scope | Loads in | Shared with your team | Saved in |
|---|---|---|---|
local (default) | The current project | No | ~/.claude.json, under the project's path |
project | The current project | Yes, through version control | .mcp.json in the project root |
user | All your projects | No | ~/.claude.json, under the top-level mcpServers key |
Encited isn't tied to one codebase, so user scope fits it:
claude mcp add --transport http --scope user encited https://encited.com/api/mcp
In a website's repository, project scope writes the server to .mcp.json, so every teammate who clones it gets the server. Each of them still signs in with their own Encited account. Claude Code asks each person to approve project servers the first time, and claude mcp reset-project-choices clears those answers.
When a server is defined in more than one place, Claude Code connects once and uses the first match in this order: local, project, user, plugin servers, then claude.ai connectors. To move a server to another scope, remove it and add it again with the new --scope.
Claude MCP config files
Claude Desktop reads claude_desktop_config.json. Claude Code reads ~/.claude.json for local and user scope, and .mcp.json in the project root for project scope. An .mcp.json with the Encited server and a local Playwright server:
{"mcpServers": {"encited": {"type": "http","url": "https://encited.com/api/mcp"},"playwright": {"type": "stdio","command": "npx","args": ["-y", "@playwright/mcp@latest"]}}}
A remote entry needs "type": "http". Claude Code treats an entry with no type as a stdio server, so it skips a url entry that lacks one. To keep keys out of the file, write ${VAR} or ${VAR:-default}, and Claude Code fills in the value from your environment.
claude mcp add-json <name> '<json>' adds one server from a JSON block, and claude mcp add-from-claude-desktop copies servers from Claude Desktop's config on macOS and WSL. Claude Code doesn't read files such as ~/.claude/mcp.json or ~/.claude/.mcp.json, so a server saved there never loads.
Sign-in and OAuth
With OAuth, Claude sends you to the service's own sign-in page, and the service gives Claude a token, so Claude never sees your password.
A server asks for sign-in by answering an unauthenticated request with 401 and a WWW-Authenticate header that points to its OAuth metadata. Encited's server answers like this:
HTTP/2 401www-authenticate: Bearer realm="OAuth", resource_metadata="https://encited.com/.well-known/oauth-protected-resource/api/mcp", error="invalid_token", error_description="Missing or invalid access token"
A custom connector's Authentication setting has three options:
- Sign in now: each person signs in through the server's OAuth flow before using the connector.
- Sign in when needed: Claude connects without credentials and asks you to sign in when the server requires it.
- No sign-in: anyone with the URL can use it. For a server that takes an API key, pick this and add the key under Request headers, a beta that some organizations don't have yet.
OAuth client sets how Claude identifies itself to the server: Use Claude's published identity, Register automatically or Use your own OAuth client.
In Claude Code, sign-in tokens are stored and refreshed for you. To sign out, choose Clear authentication in /mcp or run claude mcp logout <name>. For a server without automatic client registration, pass the client ID you registered with --client-id, and a fixed port with --callback-port, when you add it.
Encited's consent screen asks which account Claude acts on, your personal account or a team, and whether it gets Read or Write access. Write lets Claude start audits, workflows and re-renders, which use your plan's quota and credits, and it's offered only to editors and above. Every connection is listed in Encited under Settings > Connections, where you can revoke it.
Try it: a first prompt with the Encited MCP
With Encited connected, we asked Claude to analyze the Google results for "claude mcp" for encited.com. Claude called analyze_serp, which estimated 22 workflow credits and returned a run ID. get_workflow_run showed four steps finish in order: fetch_serps, fetch_pages, build_recipe and analyze_intent. The run took under a minute, and get_workflow_result returned the report.
The crawler reached one ranking page for "claude mcp", a directory of MCP servers, and the report said searchers want a list of servers and exact setup steps. People Also Ask held four questions: "Is Claude MCP free?", "Can the Claude app use MCP?", "What is MCP for Claude?" and "Is there a ChatGPT MCP for Claude?".
Encited's audits also run without an AI app. The Encited site audit crawls your whole site and groups every issue by type and severity.
Troubleshooting
! Needs authentication: sign in with/mcpandAuthenticate, or runclaude mcp login <name>.✘ Failed to connect: runclaude mcp get <name>to see the error the server returned.curl -I <url>tells you whether the server answers at all; a401means it's up and wants sign-in./mcpshows no servers: you added the server at local scope from a different project. Add it again from this project, or with--scope user.- A claude.ai connector is missing in Claude Code: connectors load only when Claude Code is signed in with a claude.ai subscription.
ANTHROPIC_API_KEY,apiKeyHelperor a third-party provider turns them off. Run/statusto see which sign-in is active. - A custom connector won't connect: Claude reaches it from Anthropic's infrastructure over the public internet. A server on a private network needs a public endpoint or an MCP tunnel, and a firewall in front of it has to allow Anthropic's published IP range.
- A Claude Desktop config server is missing: check the JSON syntax and that every path is absolute, then quit and reopen the app.
FAQ
Is Claude MCP free?
MCP is an open standard with no fee, connectors work on every Claude plan, and the Free plan can add one custom connector. The service behind a server may need its own account or plan. On Encited, the Free plan covers the Search Console tools, one SEO audit a month without JavaScript, AI visibility tracking, content actions, and reading your sites, page snapshots and crawl logs. The other tools need a paid plan or trial.
Can the Claude app use MCP?
Yes. The web, desktop and mobile apps use remote servers through connectors, and the desktop app also runs local servers.
What is MCP for Claude?
It's how Claude reaches tools and data outside the chat. Each connected MCP server lists its tools, and Claude calls them when your request needs them. The full explanation is in what is an MCP server.
Is there a ChatGPT MCP for Claude?
MCP servers aren't tied to one AI company. A remote server works in Claude and in ChatGPT with the same URL; Encited's ChatGPT steps are on the Encited MCP page.
Can Claude use several MCP servers at once?
Yes. Claude opens a separate connection to each server, and in claude.ai you switch each one on or off per chat. In Claude Code, by default only each server's tool names load at session start, and Claude loads a full tool definition when it needs that tool.
