From c89df7c3d0d783eaa6ccc5d2fc6bba4d6af5b74c Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Fri, 4 Sep 2026 14:15:26 +0200 Subject: [PATCH 1/9] docs: Add custom connector setup steps for Claude Replace the single-sentence remote server instruction on the Claude Desktop integration page with the step-by-step custom connector flow, and point users to the MCP server configurator for custom tool sets. Refs #2873 --- .../integrations/ai/claude/claude-desktop.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/sources/platform/integrations/ai/claude/claude-desktop.md b/sources/platform/integrations/ai/claude/claude-desktop.md index c13ed63f98..71e06be370 100644 --- a/sources/platform/integrations/ai/claude/claude-desktop.md +++ b/sources/platform/integrations/ai/claude/claude-desktop.md @@ -33,10 +33,22 @@ The remote server at `https://mcp.apify.com` is the recommended way to connect. - OAuth authentication - secure sign-in through your browser, no API token needed - No local dependencies - nothing to install or maintain on your machine -To set up the remote server, [add a custom connector](https://support.claude.com/en/articles/11175166) in Claude Desktop and use `https://mcp.apify.com` as the server URL. +Add the remote server as a [custom connector](https://support.claude.com/en/articles/11175166). The steps are the same in Claude Desktop and in Claude on the web: + +1. Open [Settings > Connectors](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors) and select **Add custom connector**. +1. In **Name**, enter a name for the connector, for example `Apify`. +1. In **Remote MCP server URL**, enter `https://mcp.apify.com`. +1. Select **Continue**. +1. Keep the recommended settings and select **Add**. On first connection, your browser opens to sign in to Apify and authorize the connection. +:::tip Connect only the tools you need + +`https://mcp.apify.com` exposes the default tool set. To expose specific Actors or MCP tools instead, build your setup in the [Apify MCP server configurator](https://mcp.apify.com), copy the URL it generates, and use that URL in step 3. For the full list of options, see [Apify MCP server](/integrations/mcp). + +::: + ### One-click installation Search for "Apify" in the [Claude Desktop connector directory](https://support.claude.com/en/articles/11175166) and install the connector. From 7c6b77796f4add2be621e3c921381274381f7eac Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Fri, 4 Sep 2026 14:33:45 +0200 Subject: [PATCH 2/9] docs: Clarify where to find Claude connector settings Spell out the navigation path to the connector settings in Claude Desktop and in Claude on the web, split the dialog step out, and move the tool-selection tip above the procedure so it is read before the server URL is entered. --- .../integrations/ai/claude/claude-desktop.md | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/sources/platform/integrations/ai/claude/claude-desktop.md b/sources/platform/integrations/ai/claude/claude-desktop.md index 71e06be370..bd0ebf0abe 100644 --- a/sources/platform/integrations/ai/claude/claude-desktop.md +++ b/sources/platform/integrations/ai/claude/claude-desktop.md @@ -35,7 +35,16 @@ The remote server at `https://mcp.apify.com` is the recommended way to connect. Add the remote server as a [custom connector](https://support.claude.com/en/articles/11175166). The steps are the same in Claude Desktop and in Claude on the web: -1. Open [Settings > Connectors](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors) and select **Add custom connector**. +:::tip Connect only the tools you need + +`https://mcp.apify.com` exposes the default tool set. To expose specific Actors or MCP tools instead, build your setup in the [Apify MCP server configurator](https://mcp.apify.com), copy the URL it generates, and use it as the server URL below. For the full list of options, read about [tool selection](/integrations/mcp#tool-selection). + +::: + +1. Open your Claude settings and go to **Connectors**: + - In Claude on the web, select your profile icon in the bottom-left corner, then select **Settings > Connectors**. + - In Claude Desktop, open **Settings** from the app menu, then select **Connectors**. +1. Select **Add custom connector**. You can also open the [add custom connector dialog](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors) directly. 1. In **Name**, enter a name for the connector, for example `Apify`. 1. In **Remote MCP server URL**, enter `https://mcp.apify.com`. 1. Select **Continue**. @@ -43,12 +52,6 @@ Add the remote server as a [custom connector](https://support.claude.com/en/arti On first connection, your browser opens to sign in to Apify and authorize the connection. -:::tip Connect only the tools you need - -`https://mcp.apify.com` exposes the default tool set. To expose specific Actors or MCP tools instead, build your setup in the [Apify MCP server configurator](https://mcp.apify.com), copy the URL it generates, and use that URL in step 3. For the full list of options, see [Apify MCP server](/integrations/mcp). - -::: - ### One-click installation Search for "Apify" in the [Claude Desktop connector directory](https://support.claude.com/en/articles/11175166) and install the connector. From 5aa4ec082f42df91bcc133e9655cc53207d142a0 Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Fri, 4 Sep 2026 14:34:43 +0200 Subject: [PATCH 3/9] docs: Use Anthropic's naming and plan-specific connector paths Anthropic's own docs call the web surface claude.ai, not "Claude on the web", and the connector settings path differs by plan (Customize > Connectors on Pro and Max, Organization settings > Connectors on Team and Enterprise). Drop the unverified dialog field labels. --- .../integrations/ai/claude/claude-desktop.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/sources/platform/integrations/ai/claude/claude-desktop.md b/sources/platform/integrations/ai/claude/claude-desktop.md index bd0ebf0abe..a20d6fa82f 100644 --- a/sources/platform/integrations/ai/claude/claude-desktop.md +++ b/sources/platform/integrations/ai/claude/claude-desktop.md @@ -33,7 +33,7 @@ The remote server at `https://mcp.apify.com` is the recommended way to connect. - OAuth authentication - secure sign-in through your browser, no API token needed - No local dependencies - nothing to install or maintain on your machine -Add the remote server as a [custom connector](https://support.claude.com/en/articles/11175166). The steps are the same in Claude Desktop and in Claude on the web: +Add the remote server as a [custom connector](https://support.claude.com/en/articles/11175166). Remote connectors run on Anthropic's servers, so the same connector works in Claude Desktop and in claude.ai: :::tip Connect only the tools you need @@ -41,12 +41,12 @@ Add the remote server as a [custom connector](https://support.claude.com/en/arti ::: -1. Open your Claude settings and go to **Connectors**: - - In Claude on the web, select your profile icon in the bottom-left corner, then select **Settings > Connectors**. - - In Claude Desktop, open **Settings** from the app menu, then select **Connectors**. +1. Open your Claude settings and go to **Connectors**. The path depends on your plan: + - Pro and Max - **Customize > Connectors**. + - Team and Enterprise - **Organization settings > Connectors**. Only organization owners can add connectors. 1. Select **Add custom connector**. You can also open the [add custom connector dialog](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors) directly. -1. In **Name**, enter a name for the connector, for example `Apify`. -1. In **Remote MCP server URL**, enter `https://mcp.apify.com`. +1. Enter a name for the connector, for example `Apify`. +1. Enter `https://mcp.apify.com` as the remote MCP server URL. 1. Select **Continue**. 1. Keep the recommended settings and select **Add**. From d0dd6c1ce30b468c4fb5bfd61feef03de908fb74 Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Fri, 4 Sep 2026 14:34:57 +0200 Subject: [PATCH 4/9] docs: Reference Settings > Connectors without plan-specific paths Keep the connector location generic so the steps survive UI changes. --- sources/platform/integrations/ai/claude/claude-desktop.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/sources/platform/integrations/ai/claude/claude-desktop.md b/sources/platform/integrations/ai/claude/claude-desktop.md index a20d6fa82f..fbdfb43cff 100644 --- a/sources/platform/integrations/ai/claude/claude-desktop.md +++ b/sources/platform/integrations/ai/claude/claude-desktop.md @@ -41,9 +41,7 @@ Add the remote server as a [custom connector](https://support.claude.com/en/arti ::: -1. Open your Claude settings and go to **Connectors**. The path depends on your plan: - - Pro and Max - **Customize > Connectors**. - - Team and Enterprise - **Organization settings > Connectors**. Only organization owners can add connectors. +1. In Claude, open **Settings > Connectors**. On Team and Enterprise plans, only organization owners can add connectors. 1. Select **Add custom connector**. You can also open the [add custom connector dialog](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors) directly. 1. Enter a name for the connector, for example `Apify`. 1. Enter `https://mcp.apify.com` as the remote MCP server URL. From 03e63caa96b63b4878aea7f2a4896016d9ebe6eb Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Fri, 4 Sep 2026 14:38:43 +0200 Subject: [PATCH 5/9] docs: Match connector steps to the actual dialog Restore the verified field labels (Name, Remote MCP server URL), route the dialog through the Add menu on the Connectors page, and note that Claude probes the server and pre-fills the authentication and OAuth settings it detects. --- .../integrations/ai/claude/claude-desktop.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/sources/platform/integrations/ai/claude/claude-desktop.md b/sources/platform/integrations/ai/claude/claude-desktop.md index fbdfb43cff..b31ebc1372 100644 --- a/sources/platform/integrations/ai/claude/claude-desktop.md +++ b/sources/platform/integrations/ai/claude/claude-desktop.md @@ -41,12 +41,12 @@ Add the remote server as a [custom connector](https://support.claude.com/en/arti ::: -1. In Claude, open **Settings > Connectors**. On Team and Enterprise plans, only organization owners can add connectors. -1. Select **Add custom connector**. You can also open the [add custom connector dialog](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors) directly. -1. Enter a name for the connector, for example `Apify`. -1. Enter `https://mcp.apify.com` as the remote MCP server URL. -1. Select **Continue**. -1. Keep the recommended settings and select **Add**. +1. In Claude, open **Settings**, then select **Connectors**. On Team and Enterprise plans, only organization owners can add connectors. +1. Select **Add**, then select **Add custom connector**. You can also open the [add custom connector dialog](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors) directly. +1. In **Name**, enter a name for the connector, for example `Apify`. +1. In **Remote MCP server URL**, enter `https://mcp.apify.com`. +1. Select **Continue**. Claude checks the server and pre-fills the next screen with the authentication and OAuth settings it detects. +1. Keep the detected settings and select **Add**. On first connection, your browser opens to sign in to Apify and authorize the connection. From bfc73b10de3f49e77ad3d3efad65664f5a32471f Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Fri, 4 Sep 2026 14:39:21 +0200 Subject: [PATCH 6/9] docs: Move the tool-selection tip below the steps --- .../integrations/ai/claude/claude-desktop.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/sources/platform/integrations/ai/claude/claude-desktop.md b/sources/platform/integrations/ai/claude/claude-desktop.md index b31ebc1372..ca6781d629 100644 --- a/sources/platform/integrations/ai/claude/claude-desktop.md +++ b/sources/platform/integrations/ai/claude/claude-desktop.md @@ -35,12 +35,6 @@ The remote server at `https://mcp.apify.com` is the recommended way to connect. Add the remote server as a [custom connector](https://support.claude.com/en/articles/11175166). Remote connectors run on Anthropic's servers, so the same connector works in Claude Desktop and in claude.ai: -:::tip Connect only the tools you need - -`https://mcp.apify.com` exposes the default tool set. To expose specific Actors or MCP tools instead, build your setup in the [Apify MCP server configurator](https://mcp.apify.com), copy the URL it generates, and use it as the server URL below. For the full list of options, read about [tool selection](/integrations/mcp#tool-selection). - -::: - 1. In Claude, open **Settings**, then select **Connectors**. On Team and Enterprise plans, only organization owners can add connectors. 1. Select **Add**, then select **Add custom connector**. You can also open the [add custom connector dialog](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors) directly. 1. In **Name**, enter a name for the connector, for example `Apify`. @@ -50,6 +44,12 @@ Add the remote server as a [custom connector](https://support.claude.com/en/arti On first connection, your browser opens to sign in to Apify and authorize the connection. +:::tip Connect only the tools you need + +`https://mcp.apify.com` exposes the default tool set. To expose specific Actors or MCP tools instead, build your setup in the [Apify MCP server configurator](https://mcp.apify.com), copy the URL it generates, and use it instead of `https://mcp.apify.com`. For the full list of options, read about [tool selection](/integrations/mcp#tool-selection). + +::: + ### One-click installation Search for "Apify" in the [Claude Desktop connector directory](https://support.claude.com/en/articles/11175166) and install the connector. From a75b64a047931ab6a7dff6df90447b992eb8ce2b Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Fri, 4 Sep 2026 14:40:29 +0200 Subject: [PATCH 7/9] docs: Cite the source for the Team and Enterprise connector rule Name the roles Anthropic names (Owner or Primary Owner) and link to the support article that states the requirement. --- sources/platform/integrations/ai/claude/claude-desktop.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/platform/integrations/ai/claude/claude-desktop.md b/sources/platform/integrations/ai/claude/claude-desktop.md index ca6781d629..1756b4fa7f 100644 --- a/sources/platform/integrations/ai/claude/claude-desktop.md +++ b/sources/platform/integrations/ai/claude/claude-desktop.md @@ -35,7 +35,7 @@ The remote server at `https://mcp.apify.com` is the recommended way to connect. Add the remote server as a [custom connector](https://support.claude.com/en/articles/11175166). Remote connectors run on Anthropic's servers, so the same connector works in Claude Desktop and in claude.ai: -1. In Claude, open **Settings**, then select **Connectors**. On Team and Enterprise plans, only organization owners can add connectors. +1. In Claude, open **Settings**, then select **Connectors**. On Team and Enterprise plans, an Owner or Primary Owner has to [add the connector for the whole organization](https://support.claude.com/en/articles/11175166) instead. 1. Select **Add**, then select **Add custom connector**. You can also open the [add custom connector dialog](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors) directly. 1. In **Name**, enter a name for the connector, for example `Apify`. 1. In **Remote MCP server URL**, enter `https://mcp.apify.com`. From 25bae2ba3616c1f9707bf394a89950c24d537837 Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Fri, 4 Sep 2026 14:41:20 +0200 Subject: [PATCH 8/9] docs: Fold the connector fields into one step --- sources/platform/integrations/ai/claude/claude-desktop.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/sources/platform/integrations/ai/claude/claude-desktop.md b/sources/platform/integrations/ai/claude/claude-desktop.md index 1756b4fa7f..8997b0c038 100644 --- a/sources/platform/integrations/ai/claude/claude-desktop.md +++ b/sources/platform/integrations/ai/claude/claude-desktop.md @@ -37,8 +37,9 @@ Add the remote server as a [custom connector](https://support.claude.com/en/arti 1. In Claude, open **Settings**, then select **Connectors**. On Team and Enterprise plans, an Owner or Primary Owner has to [add the connector for the whole organization](https://support.claude.com/en/articles/11175166) instead. 1. Select **Add**, then select **Add custom connector**. You can also open the [add custom connector dialog](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors) directly. -1. In **Name**, enter a name for the connector, for example `Apify`. -1. In **Remote MCP server URL**, enter `https://mcp.apify.com`. +1. Fill in the dialog: + - **Name** - A name for the connector, for example `Apify` + - **Remote MCP server URL** - `https://mcp.apify.com` 1. Select **Continue**. Claude checks the server and pre-fills the next screen with the authentication and OAuth settings it detects. 1. Keep the detected settings and select **Add**. From 9413635dadda082bd9ce27a06c3e276fce48a56e Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Fri, 4 Sep 2026 14:46:05 +0200 Subject: [PATCH 9/9] docs: Apply second-pass review findings Lift the Team and Enterprise precondition ahead of the procedure so it is read before step 1, name the alternative URL where it is entered rather than only in the tip below, scope the dialog deep link to claude.ai, and trim the repetition out of the tip. --- .../platform/integrations/ai/claude/claude-desktop.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/sources/platform/integrations/ai/claude/claude-desktop.md b/sources/platform/integrations/ai/claude/claude-desktop.md index 8997b0c038..cd8a0f58b1 100644 --- a/sources/platform/integrations/ai/claude/claude-desktop.md +++ b/sources/platform/integrations/ai/claude/claude-desktop.md @@ -33,13 +33,13 @@ The remote server at `https://mcp.apify.com` is the recommended way to connect. - OAuth authentication - secure sign-in through your browser, no API token needed - No local dependencies - nothing to install or maintain on your machine -Add the remote server as a [custom connector](https://support.claude.com/en/articles/11175166). Remote connectors run on Anthropic's servers, so the same connector works in Claude Desktop and in claude.ai: +Add the remote server as a custom connector. Remote connectors run on Anthropic's servers, so the same connector works in Claude Desktop and in claude.ai. On Team and Enterprise plans, an Owner or Primary Owner has to [add the connector for the whole organization](https://support.claude.com/en/articles/11175166) instead. -1. In Claude, open **Settings**, then select **Connectors**. On Team and Enterprise plans, an Owner or Primary Owner has to [add the connector for the whole organization](https://support.claude.com/en/articles/11175166) instead. -1. Select **Add**, then select **Add custom connector**. You can also open the [add custom connector dialog](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors) directly. +1. In Claude, open **Settings**, then select **Connectors**. +1. Select **Add**, then select **Add custom connector**. In claude.ai, you can also [open the **Add custom connector** dialog](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors) directly. 1. Fill in the dialog: - **Name** - A name for the connector, for example `Apify` - - **Remote MCP server URL** - `https://mcp.apify.com` + - **Remote MCP server URL** - The Apify MCP server address, `https://mcp.apify.com`, or a custom URL that exposes only selected tools 1. Select **Continue**. Claude checks the server and pre-fills the next screen with the authentication and OAuth settings it detects. 1. Keep the detected settings and select **Add**. @@ -47,7 +47,7 @@ On first connection, your browser opens to sign in to Apify and authorize the co :::tip Connect only the tools you need -`https://mcp.apify.com` exposes the default tool set. To expose specific Actors or MCP tools instead, build your setup in the [Apify MCP server configurator](https://mcp.apify.com), copy the URL it generates, and use it instead of `https://mcp.apify.com`. For the full list of options, read about [tool selection](/integrations/mcp#tool-selection). +`https://mcp.apify.com` exposes the default tool set. To expose specific Actors or MCP tools, build your setup in the [Apify MCP server configurator](https://mcp.apify.com) and use the URL it generates as the server URL. For the full list of options, read about [tool selection](/integrations/mcp#tool-selection). :::