diff --git a/docs/mcp/connect-mcp-client.mdx b/docs/mcp/connect-mcp-client.mdx
index dc4879059c..9bce344045 100644
--- a/docs/mcp/connect-mcp-client.mdx
+++ b/docs/mcp/connect-mcp-client.mdx
@@ -94,30 +94,44 @@ To complete the integration, you'll need to connect an MCP-compatible client to
### Connecting Claude Desktop to your MCP server
- 1. Navigate to **Settings**. To find this, use the app menu to select **Settings** or press `Cmd/Ctrl + ,`.
- 1. In the settings sidebar, select **Developer**, then **Edit config**. Open the revealed file in your editor of choice.
- 1. Add the following configuration to the JSON file:
- ```json
- {
- "mcpServers": {
- "clerk-mcp-server": {
- "command": "npx",
- "args": ["mcp-remote", "http://localhost:3000/mcp", "--allow-http"]
+ Claude Desktop offers two ways to connect to MCP servers:
+
+ - Using the **Search and Tools** menu in the main UI.
+ - Using the **Developer Settings**.
+
+
+
+ 1. In the main chat UI, navigate to the **Search and Tools** menu (icon with two horizontal lines and dots), then select **Manage Connectors**.
+ 1. Scroll to the bottom and select **Add Custom Connector**.
+ 1. Add your MCP server name and URL, then select **Add**.
+ 1. Once added, your server will appear in the connectors list. Select the **Connect** option to establish the connection.
+ 1. Once connected, you can open a new chat and prompt it to fetch your Clerk user data (e.g., "What is my Clerk user data?").
+
+
+
+ 1. Navigate to **Settings**. To find this, use the app menu to select **Settings** or press `Cmd/Ctrl + ,`.
+ 1. In the settings sidebar, select **Developer**, then **Edit config**. Open the revealed file in your editor of choice.
+ 1. Add the following configuration to the JSON file:
+ ```json
+ {
+ "mcpServers": {
+ "clerk-mcp-server": {
+ "command": "npx",
+ "args": ["mcp-remote", "http://localhost:3000/mcp", "--allow-http"]
+ }
+ }
}
- }
- }
- ```
- > [!IMPORTANT]
- >
- > - Replace `http://localhost:3000/mcp` with your production URL and remove `--allow-http` if you've deployed your MCP server.
- > - [mcp-remote](https://github.com/geelen/mcp-remote) is required since Claude Desktop does not support remote MCP servers with authentication natively.
- 1. Restart Claude Desktop. It should now prompt you to authenticate with your Clerk account.
- 1. Once authenticated, you can open a new chat and prompt it to fetch your Clerk user data (e.g., "What is my Clerk user data?").
+ ```
+ > [!IMPORTANT]
+ >
+ > - Replace `http://localhost:3000/mcp` with your production URL and remove `--allow-http` if you've deployed your MCP server.
+ > - [mcp-remote](https://github.com/geelen/mcp-remote) is required since this connection mode does not support remote MCP servers with authentication natively.
+ 1. Restart Claude Desktop. It should now prompt you to authenticate with your Clerk account.
+ 1. Once authenticated, you can open a new chat and prompt it to fetch your Clerk user data (e.g., "What is my Clerk user data?").
+
+
You've now successfully connected **Claude Desktop** to your MCP server and authenticated it using Clerk.
-
- > [!WARNING]
- > Claude Desktop has a second way to connect to MCP servers under an "Integrations" menu, however, this is not currently supported due to an incompatible implementation of an older version of the MCP spec.
@@ -174,7 +188,6 @@ The exact response will vary based on your specific Clerk user profile and the p
The MCP protocol and spec are still in development, and as a result, implementation across clients can vary. While we are working to support all clients, there are some clients that are not currently supported:
- **Cline**: While it does have MCP support, their implementation is not compatible with the latest MCP spec.
-- **Claude Desktop via "Integrations" menu / Claude Web**: This is not currently supported due to an incompatible implementation of an older version of the MCP spec. We hope this will be resolved in the future.
## Troubleshooting