Encited logo
PricingTalk to sales
Claude MCP: How to Add MCP Servers to Claude, Claude Desktop and Claude Code

Claude MCP: How to Add MCP Servers to Claude, Claude Desktop and Claude Code

Nov 9, 2026November 9, 2026·Updated Nov 10, 2026November 10, 2026·by Aki from Encited

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 to claude_desktop_config.json.
  • Claude Code: claude mcp add --transport http encited https://encited.com/api/mcp, then /mcp to sign in.
  • Claude Code scopes: local (the default, you in this project), project (.mcp.json, shared with your team) and user (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 appRemote serversLocal serversWhere you add them
claude.aiYes, as connectorsNoCustomize > Connectors
Claude desktop appYes, as connectorsYes, as desktop extensions or in claude_desktop_config.jsonCustomize > Connectors for remote, Settings for local
Claude mobile appsYes, the connectors on your accountNoAdd them on claude.ai or in the desktop app
Claude CodeYesYesclaude mcp add, .mcp.json, or your claude.ai connectors

Add an MCP server to Claude with a connector

From the Connectors directory

  1. Go to Customize > Connectors at claude.ai/customize/connectors. In the desktop app, select Customize in the sidebar, then Connectors.
  2. 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.
  3. 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.
  4. 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:

  1. Go to Customize > Connectors.
  2. Select Add custom connector.
  3. Enter a name and the remote MCP server URL.
  4. 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).

  1. In Claude Desktop, go to Settings > Extensions.
  2. Drag the .mcpb file onto the page, or select Advanced settings, then Install Extension… and choose the file.
  3. 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:

json
CopyDownload
{
"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)

bash
CopyDownload
claude mcp add --transport http <name> <url>

For Encited:

bash
CopyDownload
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:

  1. Start Claude Code with claude.
  2. Type /mcp, select encited, press Enter and choose Authenticate.
  3. 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:

bash
CopyDownload
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

bash
CopyDownload
claude mcp list # every server and its status
claude mcp get encited # one server's details, including its scope
claude 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.

ScopeLoads inShared with your teamSaved in
local (default)The current projectNo~/.claude.json, under the project's path
projectThe current projectYes, through version control.mcp.json in the project root
userAll your projectsNo~/.claude.json, under the top-level mcpServers key

Encited isn't tied to one codebase, so user scope fits it:

bash
CopyDownload
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:

json
CopyDownload
{
"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:

text
CopyDownload
HTTP/2 401
www-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 /mcp and Authenticate, or run claude mcp login <name>.
  • ✘ Failed to connect: run claude mcp get <name> to see the error the server returned. curl -I <url> tells you whether the server answers at all; a 401 means it's up and wants sign-in.
  • /mcp shows 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, apiKeyHelper or a third-party provider turns them off. Run /status to 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.

Google
Gemini
ChatGPT
Claude
Grok
Meta
Perplexity

Data pipeline, SEO and AI search intelligence for your agents

Give Claude, ChatGPT and Cursor your Search Console, crawl and AI visibility data.

Avatar
How can we help?
Get instant answers to your questions or leave a message for an engineer will reach out
Ask AI about Encited
See our docs
Contact support
Leave a message
We'll get back to you soon
Avatar
Ask AI about Encited
Product questions, troubleshooting and
Thinking
Preview
Drop an image to attach
Powered by ReplyMaven