docs: Add custom connector setup steps for Claude - #2950
Open
marcel-rbro wants to merge 9 commits into
Open
marcel-rbro wants to merge 9 commits into
marcel-rbro wants to merge 9 commits into
Conversation
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
Contributor
|
✅ Preview for this PR (commit |
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.
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.
Keep the connector location generic so the steps survive UI changes.
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.
Name the roles Anthropic names (Owner or Primary Owner) and link to the support article that states the requirement.
marcel-rbro
marked this pull request as ready for review
September 4, 2026 12:44
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.
marcel-rbro
requested review from
TC-MO
and
a lite review from Copilot
and removed request for
Copilot
September 17, 2026 14:50
TC-MO
approved these changes
Sep 21, 2026
TC-MO
left a comment
TC-MO
left a comment
Contributor
There was a problem hiding this comment.
Approve with medium & minor nits
|
|
||
| 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: |
Contributor
There was a problem hiding this comment.
We mention custom URL but don't explain it until tip admonition. Ideally it would work without that.
I can see two outcomes:
- Remove mention of custom URL from the step and let admonition explain the possibility.
- Link the configurator in the steps and slim the admonition to just point to the tool selection.
|
|
||
| The MCP server shows as connected but Apify tools don't appear in the tools list, or Claude doesn't recognize any Apify tools in conversation. | ||
|
|
||
| - _Check tool permissions._ Individual connector tools can be blocked in your [connector settings](https://support.anthropic.com/en/articles/11175166-how-to-manage-and-remove-integrations-in-claude). Verify that Apify tools are set to **Always allow** or **Ask first**, not blocked. |
Contributor
There was a problem hiding this comment.
NIT: This is link to the same article as on LOC 36, but different, could we align?
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
The Claude Desktop integration page covered the remote server in a single sentence ("add a custom connector and use
https://mcp.apify.comas the server URL") that linked out to Anthropic's support article for the actual steps. This replaces it with the concrete step-by-step flow, which is identical in Claude Desktop and in Claude on the web:https://mcp.apify.comas the remote MCP server URL.Also adds a tip pointing to the Apify MCP server configurator for users who want to expose specific Actors or tools instead of the default tool set.
Why
Requested so the setup instructions live on the existing integration page rather than on a new separate page.
Refs #2873.