Agents Index

Claude Custom Connector: Add a Remote MCP Server to Claude

Updated 2026-11-18

To add a custom connector to Claude, open Customize, go to Connectors, click + Add, choose Add custom connector, and enter the remote MCP server's URL. Claude then asks you to sign in if the server needs it. Team and Enterprise owners add connectors for the organization first.

Who can use custom connectors

Anthropic's support article says custom connectors using remote MCP are available on Claude, Cowork and Claude Desktop for Free, Pro, Max, Ultra, Team and Enterprise plans. Free users are limited to one custom connector. Plan rules change, so check the current support article if the option is missing.

The server must be remote. Local MCP servers configured through claude_desktop_config.json are a separate mechanism that uses your local network. They are not available in claude.ai or in cloud-based Cowork sessions. The server must be reachable over the public internet from Anthropic's IP ranges, on the standard HTTPS port (443).

Add a connector on Pro or Max

  1. Go to Customize > Connectors.
  2. Click + Add, then Add custom connector.
  3. Enter a connector name. It appears in your connectors list.
  4. Enter the remote MCP server URL exactly as the provider documents it, including any path. For example, https://mcp.notion.com/mcp.
  5. Choose how authentication works (see below) and save.

You may see other guides call this menu Settings > Connectors. The current support article says Customize > Connectors.

Add a connector on Team or Enterprise

On Team and Enterprise, an Owner or Primary Owner adds the connector once for the organization:

  1. Go to Organization settings > Connectors.
  2. Click Add, hover over Custom, and select Web.
  3. Fill in the same fields as above.

On Enterprise, people with a custom role that includes Manage access to Libraries can also add connectors. After that, each member goes to Customize > Connectors, finds the connector and clicks Connect. Each member connects individually, unless the connector uses a shared credential.

Set up authentication

The form offers three sign-in choices: Sign in now, Sign in when needed and No sign in. The OAuth client setting is hidden for No sign in, so servers that need no authentication are supported.

For servers that use OAuth, choose one of three client options:

OptionWhat it does
Use Claude's published identity (Recommended)Claude identifies itself with its published OAuth client.
Register automaticallyClaude registers a client with the server.
Use your own OAuth clientYou enter a Client ID and, if the server issued one, a Client Secret.

If you use your own client, register this redirect URL with the provider:

https://claude.ai/api/mcp/auth_callback

If the server uses a fixed API key or bearer token instead of OAuth, add it under Request headers. Claude sends those headers on every request. On Team and Enterprise, a shared key means everyone who uses the connector reaches the service with the same credential, so give it limited permissions.

Use the connector

Once connected, ask Claude for something the server can do. Review each tool approval request before you allow it. You can disable tools you do not need in the Search and tools menu. Anthropic notes that Research can call connector tools without further approval, so disable write-capable tools before you use it.

Pick a server that works

Not every listed server is online. Agents Index probes remote MCP endpoints daily. In our probe data, Nov 2026, of the remote endpoints in the official MCP Registry, 23,704 answered without sign-in, 13,608 were online but required sign-in (OAuth or API key), and 7,189 were unreachable. The State of MCP report has the breakdown. Before you paste a URL into Claude, check the listing. The servers that work with Claude page is a good starting point, and Notion is an example of a remote server with OAuth.

Safety

Anthropic's article warns that custom connectors let Claude connect to arbitrary services that Anthropic has not verified. Only connect to servers you trust, review the OAuth permissions a server requests, watch for prompt injection from malicious servers, and monitor tool behavior changes. Read the MCP server security checklist for a longer list.

Using Claude Code instead of claude.ai? The setup is a command, covered in how to add an MCP server to Claude Code. For ChatGPT, see the ChatGPT MCP connector guide.

Sources

FAQ

What is a custom connector in Claude?

A custom connector links Claude to a remote MCP server that Anthropic has not verified. You add it by entering the server's URL, and Claude can then call its tools in your chats.

Which plans can add a custom connector?

Anthropic's support article says custom connectors are available on Free, Pro, Max, Ultra, Team and Enterprise plans. Free users are limited to one custom connector.

Can I connect a local MCP server to claude.ai?

No. Custom connectors must be remote. Local servers set up in claude_desktop_config.json are a separate mechanism and are not available in claude.ai.

What redirect URL do I register for OAuth?

If you use your own OAuth client, register https://claude.ai/api/mcp/auth_callback as the redirect URL and enter the client ID, plus the client secret if the server issued one.

More guides