From 2e4887614541316b63634cfa5c03ca8f0b5c8235 Mon Sep 17 00:00:00 2001 From: Jeff Escalante Date: Mon, 8 Sep 2025 15:21:34 -0400 Subject: [PATCH 1/3] add instructions for connecting claude web mcp --- docs/mcp/connect-mcp-client.mdx | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/docs/mcp/connect-mcp-client.mdx b/docs/mcp/connect-mcp-client.mdx index f592e132a3..3506523981 100644 --- a/docs/mcp/connect-mcp-client.mdx +++ b/docs/mcp/connect-mcp-client.mdx @@ -94,6 +94,19 @@ To complete the integration, you'll need to connect an MCP-compatible client to ### Connecting Claude Desktop to your MCP server + Claude Desktop has two different ways to connect to MCP servers. The first is under an "Integrations" menu in the main UI, and the second is under a "Developer" menu in the settings. We will cover both methods here. + + + ### Method 1: Using the "Integrations" menu + + 1. Navigate to the "Search and Tools" menu in the main chat UI (looks like two horizontal lines with dots on them), then "Manage Connectors". + 1. Scroll to the bottom of the screen, then select **Add Custom Connector**. + 1. Add your MCP server name and URL in the input fields, and hit "Add". + 1. Once added, you should see it in the list of connectors. Click the "Connect" button to connect to it. + 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?"). + + ### Method 2: Using the Developer Settings + 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: @@ -115,9 +128,6 @@ To complete the integration, you'll need to connect an MCP-compatible client to 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 +184,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 From 67fab3411ebc5218d6d41bff9a909f8e28cd22e1 Mon Sep 17 00:00:00 2001 From: Jeff Escalante Date: Mon, 8 Sep 2025 15:22:52 -0400 Subject: [PATCH 2/3] small fixes --- docs/mcp/connect-mcp-client.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/mcp/connect-mcp-client.mdx b/docs/mcp/connect-mcp-client.mdx index 3506523981..17056b6097 100644 --- a/docs/mcp/connect-mcp-client.mdx +++ b/docs/mcp/connect-mcp-client.mdx @@ -94,10 +94,10 @@ To complete the integration, you'll need to connect an MCP-compatible client to ### Connecting Claude Desktop to your MCP server - Claude Desktop has two different ways to connect to MCP servers. The first is under an "Integrations" menu in the main UI, and the second is under a "Developer" menu in the settings. We will cover both methods here. + Claude Desktop has two different ways to connect to MCP servers. The first is under the "Search and Tools" menu in the main UI, and the second is under a "Developer" menu in the settings. We will cover both methods here. - ### Method 1: Using the "Integrations" menu + ### Method 1: Using the "Search and Tools" menu 1. Navigate to the "Search and Tools" menu in the main chat UI (looks like two horizontal lines with dots on them), then "Manage Connectors". 1. Scroll to the bottom of the screen, then select **Add Custom Connector**. @@ -123,7 +123,7 @@ To complete the integration, you'll need to connect an MCP-compatible client to > [!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. + > - [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?"). From ab5d8a10bb0758802448b3c30fbecbcd43a17a60 Mon Sep 17 00:00:00 2001 From: Sarah Soutoul Date: Tue, 9 Sep 2025 14:38:37 -0600 Subject: [PATCH 3/3] docs review --- docs/mcp/connect-mcp-client.mdx | 66 +++++++++++++++++---------------- 1 file changed, 35 insertions(+), 31 deletions(-) diff --git a/docs/mcp/connect-mcp-client.mdx b/docs/mcp/connect-mcp-client.mdx index 17056b6097..6164bd3bb1 100644 --- a/docs/mcp/connect-mcp-client.mdx +++ b/docs/mcp/connect-mcp-client.mdx @@ -94,38 +94,42 @@ To complete the integration, you'll need to connect an MCP-compatible client to ### Connecting Claude Desktop to your MCP server - Claude Desktop has two different ways to connect to MCP servers. The first is under the "Search and Tools" menu in the main UI, and the second is under a "Developer" menu in the settings. We will cover both methods here. - - - ### Method 1: Using the "Search and Tools" menu - - 1. Navigate to the "Search and Tools" menu in the main chat UI (looks like two horizontal lines with dots on them), then "Manage Connectors". - 1. Scroll to the bottom of the screen, then select **Add Custom Connector**. - 1. Add your MCP server name and URL in the input fields, and hit "Add". - 1. Once added, you should see it in the list of connectors. Click the "Connect" button to connect to it. - 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?"). - - ### Method 2: Using the Developer Settings - - 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 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?"). + ``` + > [!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.