docs: nest MCP client pages under mcp/ directory and refine Claude Desktop 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>

Author: marcel-rbro

…rces/platform/integrations/ai/chatgpt.md …/platform/integrations/ai/mcp/chatgpt.mdsources/platform/integrations/ai/chatgpt.md renamed to sources/platform/integrations/ai/mcp/chatgpt.md sources/platform/integrations/ai/chatgpt.md renamed to sources/platform/integrations/ai/mcp/chatgpt.md

@@ -40,7 +40,7 @@ Before connecting ChatGPT to Apify, you'll need:
 3. Select **Create** to proceed to the authentication page.
 You’ll be redirected to the Apify website to authorize ChatGPT to access your Apify account.
 
-![ChatGPT Create connection](../images/chatgpt-connector.png)
+![ChatGPT Create connection](../../images/chatgpt-connector.png)
 
 Once authorized, you'll return to ChatGPT and see a success message with a list of tools available from the Apify MCP server.
 
@@ -63,7 +63,7 @@ Once your connector is ready:
 You'll need to grant permission for each Apify tool when it's used for the first time.
 You should see ChatGPT calling Apify tools - such as the [RAG Web Browser](https://apify.com/apify/rag-web-browser) - to gather information.
 
-![ChatGPT Apify tools](../images/chatgpt-with-rag-web-browser.png)
+![ChatGPT Apify tools](../../images/chatgpt-with-rag-web-browser.png)
 
 ## Limitations
 

…atform/integrations/ai/claude-desktop.md …rm/integrations/ai/mcp/claude-desktop.mdsources/platform/integrations/ai/claude-desktop.md renamed to sources/platform/integrations/ai/mcp/claude-desktop.md sources/platform/integrations/ai/claude-desktop.md renamed to sources/platform/integrations/ai/mcp/claude-desktop.md

@@ -27,7 +27,7 @@ Download and open the [Apify MCP server `.mcpb` file](https://github.com/apify/a
 
 :::caution Connector directory
 
-If you found Apify through the Claude Desktop connector directory, the automatic install may fail silently or show an "Unable to connect to extension server" error. Use the `.mcpb` file above or the [manual configuration](#remote-server-manual-configuration) below instead.
+If you found Apify through the Claude Desktop connector directory, the automatic install may fail silently or show an "Unable to connect to extension server" error. This is a known issue across macOS, Windows, and Linux. Try uninstalling and reinstalling the extension first. If that doesn't help, use the `.mcpb` file above or the [manual configuration](#remote-server-manual-configuration) instead.
 
 :::
 
@@ -84,13 +84,19 @@ If your version of Claude Desktop does not support the `url` field, use the `mcp
   "mcpServers": {
     "apify": {
       "command": "npx",
-      "args": ["-y", "mcp-remote", "https://mcp.apify.com/sse"]
+      "args": [
+        "-y",
+        "mcp-remote",
+        "https://mcp.apify.com/sse",
+        "--header",
+        "Authorization: Bearer <APIFY_TOKEN>"
+      ]
     }
   }
 }
 ```
 
-This requires Node.js version 18 or higher.
+Replace `<APIFY_TOKEN>` with your API token from the [Integrations section](https://console.apify.com/account#/integrations) in Apify Console. This requires Node.js version 18 or higher.
 
 :::
 
@@ -142,12 +148,15 @@ The local stdio server does not support output schema inference for structured A
   - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 - **Validate JSON syntax.** Ensure there are no trailing commas, missing quotes, or mismatched brackets. Paste your config into a JSON validator if needed.
 
-### "Unable to connect" error
+### "Unable to connect to extension server" error
 
+This error commonly appears when installing from the Claude Desktop connector directory. In some cases, the MCP server starts and communicates correctly, but Claude Desktop still shows the error.
+
+- **Uninstall and reinstall the extension.** In Claude Desktop, disable the Apify extension, remove it, then add it again.
+- **Switch to manual configuration.** If reinstalling doesn't help, use the [remote server](#remote-server-manual-configuration) or [local stdio](#local-stdio-server) setup instead of the connector directory.
 - **Verify the server URL.** For remote setup, use exactly `https://mcp.apify.com` with no trailing slash.
 - **Check your network.** Ensure your firewall or VPN is not blocking the connection.
 - **For local stdio setup:** Confirm Node.js version 18 or higher is installed by running `node -v` in your terminal.
-- **Try the remote server.** If the local server fails, switch to the [remote server configuration](#remote-server-manual-configuration) to rule out local environment issues.
 
 ### Corrupted npx cache
 

sources/platform/integrations/ai/mcp.md …es/platform/integrations/ai/mcp/index.mdsources/platform/integrations/ai/mcp.md renamed to sources/platform/integrations/ai/mcp/index.md sources/platform/integrations/ai/mcp.md renamed to sources/platform/integrations/ai/mcp/index.md

@@ -17,7 +17,7 @@ using [Model Context Protocol](https://modelcontextprotocol.io/docs/getting-star
 discover and run Actors from [Apify Store](https://apify.com/store), access storages and results,
 and enables AI coding assistants to access Apify documentation and tutorials.
 
-![Apify MCP server](../../images/apify_mcp_server.png)
+![Apify MCP server](../../../images/apify_mcp_server.png)
 
 ## Prerequisites