Skip to content

Conversation

@patrikbraborec
Copy link
Contributor

@patrikbraborec patrikbraborec commented Nov 27, 2025

The Apify MCP Server will not require auth for documentation tools (apify/apify-mcp-server#341). This PR makes changes regarding to it - mainly improvements to the Build with AI page.

I also checked the Apify MCP Server documentation page, but I do not see a good place, where we should mention that documentation tools do not need auth (it would probably add confusion).

I plan to update mcp.apify.com page, and also will discuss whatever we will add the following option to AI Dropdown: #2079.


Note

Updates the Build with AI guide with MCP server setup for Claude, Cursor, and VS Code, and removes the unused InstallMCPButton component and styles.

  • Docs (build-with-ai):
    • Add setup instructions for Apify MCP Server in Claude, Cursor (with mcp.json snippet), and VS Code using https://mcp.apify.com/?tools=docs.
    • Streamline MCP configuration note and improve guidance for providing context via Copy for LLM and /llms.txt.
    • Remove unused InstallMCPButton import.
  • Cleanup:
    • Delete src/components/InstallMCPButton.jsx and src/components/InstallMCPButton.module.css.

Written by Cursor Bugbot for commit 5e93989. Configure here.

@github-actions github-actions bot added the t-c&c Team covering store and finance matters. label Nov 27, 2025
@apify-service-account
Copy link

Preview for this PR was built for commit 5e93989 and is ready at https://pr-2119.preview.docs.apify.com!

@apify-service-account
Copy link

Preview for this PR was built for commit 5867d5f and is ready at https://pr-2119.preview.docs.apify.com!

import { AGENTS_PROMPT } from "@site/src/utils/agents-prompt";
import PromptButton from "@site/src/components/PromptButton";
import InstallMCPButton from "@site/src/components/InstallMCPButton";
import copyForAI from "./images/copy-for-ai.png";
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
import copyForAI from "./images/copy-for-ai.png";
import copyForAI from "./images/copy-for-ai.png";
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

Comment on lines +63 to +90
### Claude

1. Go to _Settings_ > _Connectors_ in Claude.
2. Click _Add custom connector_.
3. Set the name to `Apify` and the URL to `https://mcp.apify.com/?tools=docs`.
4. When chatting, click the _+_ button and select the _Apify_ connector to add documentation context.

### Cursor

1. Open the command palette with `Cmd+Shift+P` (or `Ctrl+Shift+P` on Windows).
2. Search for and select _Open MCP settings_.
3. Add the following configuration to `mcp.json`:

```json
{
"mcpServers": {
"apify": {
"url": "https://mcp.apify.com/?tools=docs"
}
}
}
```

### VS Code

1. Install an MCP-compatible extension.
2. Add the Apify server URL: `https://mcp.apify.com/?tools=docs`

Copy link
Contributor

@TC-MO TC-MO Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Few questions here:

  1. when you are talking about Claude do you mean web app or Claude desktop?
  2. I've broken up VSC to have both github copilot vsrsion and MCP-comptabile extension
Suggested change
### Claude
1. Go to _Settings_ > _Connectors_ in Claude.
2. Click _Add custom connector_.
3. Set the name to `Apify` and the URL to `https://mcp.apify.com/?tools=docs`.
4. When chatting, click the _+_ button and select the _Apify_ connector to add documentation context.
### Cursor
1. Open the command palette with `Cmd+Shift+P` (or `Ctrl+Shift+P` on Windows).
2. Search for and select _Open MCP settings_.
3. Add the following configuration to `mcp.json`:
```json
{
"mcpServers": {
"apify": {
"url": "https://mcp.apify.com/?tools=docs"
}
}
}
```
### VS Code
1. Install an MCP-compatible extension.
2. Add the Apify server URL: `https://mcp.apify.com/?tools=docs`
<Tabs>
<TabItem value="cursor" label="Cursor">
To add Apify MCP server to Cursor manually:
1. Create or open the `.cursor/mcp.json` file.
1. Add the following to the configuration file:
```json
{
"mcpServers": {
"apify": {
"url": "https://mcp.apify.com/?tools=docs"
}
}
}
```
</TabItem>
<TabItem value="vscode" label="VS Code">
VS Code supports MCP through MCP-compatible extensions like _GitHub Copilot_, _Cline_, or _Roo Code_.
1. Install an MCP-compatible extension (e.g., GitHub Copilot, Cline).
1. Locate the extension's MCP settings or configuration file (often `mcp.json`).
- For _GitHub Copilot_: Run the **MCP: Open User Configuration** command.
- For _MCP-compatible extension_: Go to the MCP Servers tab in the extension interface.
1. Add the Apify server configuration:
```json
{
"mcpServers": {
"apify": {
"url": "https://mcp.apify.com/?tools=docs"
}
}
}
```
</TabItem>
<TabItem value="claude" label="Claude">
1. Go to **Settings** > **Connectors** in Claude.
1. Click **Add custom connector**.
1. Set the name to `Apify` and the URL to `https://mcp.apify.com/?tools=docs`.
1. When chatting, select the **+** button and choose the **Apify** connector to add documentation context.
</TabItem>
</Tabs>

@TC-MO
Copy link
Contributor

TC-MO commented Dec 5, 2025

I'm also debating whether we should remake the admoniton that is on L60 to be specific about documentation tool not needing auth, instead of about UI configurator. Seems to me we want ro push doc tool here more. Thoughts?

it would be;

instead of


:::info Use Apify MCP server configuration

We have prepared the [Apify MCP server configuration](https://mcp.apify.com/), which you can configure for your needs.

:::

it would rather say soemthing like


:::note No authentication required

The documentation tools in the Apify MCP server do not require an API token. You can use them freely without logging in.

:::

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

t-c&c Team covering store and finance matters.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants