docs: add Claude Desktop setup and troubleshooting page for Apify MCP#2371
Open
marcel-rbro wants to merge 5 commits intomasterfrom
Open
docs: add Claude Desktop setup and troubleshooting page for Apify MCP#2371marcel-rbro wants to merge 5 commits intomasterfrom
marcel-rbro wants to merge 5 commits intomasterfrom
Conversation
Add a dedicated page for Claude Desktop users covering three setup methods (one-click .mcpb, remote server, local stdio), troubleshooting common issues, and known limitations. Cross-reference from the main MCP page. Closes #2368 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…sktop content Move mcp.md, chatgpt.md, and claude-desktop.md into a mcp/ subdirectory so client-specific pages appear as children of the MCP server page. Fix relative image paths after the move. Refine Claude Desktop troubleshooting based on related issues (apify/apify-mcp-server#551, #560, #592, #599): - Expand connector directory warning (affects all OSes) - Add mcp-remote config with --header auth syntax - Add "Unable to connect" section with uninstall/reinstall fix - Note that server may communicate successfully while Claude shows error Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Expand front matter description to 140-160 char range - Fix gerund heading (Tools not loading -> Tools fail to load) - Add intro text to troubleshooting subsections - Restore bold lead-ins to match codebase convention - Add anchor links to setup method list - Shorten connector directory admonition with link to troubleshooting - Remove mcp-remote section Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
jirispilka
requested changes
Mar 27, 2026
Contributor
jirispilka
left a comment
jirispilka
left a comment
There was a problem hiding this comment.
Thank you for the prompt response and this document!
I've a couple of suggestions. Definitely we need to change the preference of servers, remote server is strongly recommended whenever possible.
|
|
||
| Choose one of the following methods, from simplest to most flexible: | ||
|
|
||
| - [One-click installation](#one-click-installation-recommended) with the `.mcpb` file (recommended) |
Contributor
There was a problem hiding this comment.
You can find the Apify extension in your claude.ai -> connectors -> Browse connector
| - [Remote server configuration](#remote-server-manual-configuration) (no local dependencies) | ||
| - [Local stdio server](#local-stdio-server) (development, testing, or offline access) | ||
|
|
||
| ### One-click installation (recommended) |
Contributor
There was a problem hiding this comment.
Just to make sure, this should be changed. Users should navigate to claude -> connectors
|
|
||
| ## Known limitations | ||
|
|
||
| - The Claude Desktop connector directory may not install Apify correctly. Use the [`.mcpb` file](#one-click-installation-recommended) or [manual configuration](#remote-server-manual-configuration) instead. |
Contributor
There was a problem hiding this comment.
If it fails install fails -> use remote server at mcp.apify.com (always preffered)
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
3 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.
Summary
.mcpb, remote server with OAuth/Bearer token, local stdio)Closes #2368
Test plan
/integrations/claude-desktopnpm run buildpasses with no broken links🤖 Generated with Claude Code