Skip to content

fix: Always clear cache when on MCP page to help with redirect issue #1801

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Aug 22, 2025
Merged

fix: Always clear cache when on MCP page to help with redirect issue #1801

Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
1e99900
fix: Always clear cache when on MCP page to help with redirect issues
jirispilka Aug 15, 2025
7b9a414
fix: lint
jirispilka Aug 15, 2025
09b9d7a
fix: Add link to issues, start the repo
jirispilka Aug 18, 2025
82fadea
Update sources/platform/integrations/ai/mcp.md
jirispilka Aug 18, 2025
42b7d9a
fix: review comments (admonition, gh stars)
jirispilka Aug 18, 2025
e6f8945
Apply suggestions from code review
jirispilka Aug 19, 2025
29c4de3
fix: move the cache invalidation to custom.js
jirispilka Aug 19, 2025
74c77d8
Merge remote-tracking branch 'origin/fix/add-link-ui-redirect' into f…
jirispilka Aug 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 17 additions & 1 deletion apify-docs-theme/src/theme/Layout/index.jsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,29 @@ import { useLocation } from '@docusaurus/router';
import Layout from '@docusaurus/theme-classic/lib/theme/Layout/index';
import useBaseUrl from '@docusaurus/useBaseUrl';
import { usePluginData } from '@docusaurus/useGlobalData';
import React from 'react';
import React, { useEffect } from 'react';

export default function LayoutWrapper(props) {
const { options: { subNavbar } } = usePluginData('@apify/docs-theme');
const baseUrl = useBaseUrl('/');
const currentPath = useLocation().pathname.replace(new RegExp(`^${baseUrl}`), '');

// Silent cache busting for mcp.apify.com redirects
useEffect(() => {
// Only run on the MCP documentation page
if (currentPath.includes('integrations/mcp')) {
// Always clear cache when on MCP page to help with redirect issues.
// Background: Previously, mcp.apify.com had a 301 redirect to this docs page, which was wrong.
// Many users have this redirect cached in their browsers, so they can't access the new MCP UI.
// This helps with their cached redirect, allowing them to access mcp.apify.com
fetch('https://mcp.apify.com/', { method: 'get', cache: 'reload' }).then(() => {
console.log('MCP cache cleared successfully');
}).catch((error) => {
console.warn('Failed to clear MCP cache:', error);
});
}
}, [currentPath]);

return (
<>
<Head>
Expand Down
21 changes: 11 additions & 10 deletions sources/platform/integrations/ai/mcp.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ slug: /integrations/mcp

<!-- markdownlint-disable MD024 -->

The _Apify Model Context Protocol (MCP) Server_ allows AI applications to connect to Apify’s extensive library of Actors as tools to perform web scraping, data extraction, or other automation tasks in real time.
The _Apify Model Context Protocol (MCP) Server_ allows AI applications to connect to Apify's extensive library of Actors as tools to perform web scraping, data extraction, or other automation tasks in real time.

![Apify MCP Server](../../images/apify_mcp_server.png)

Expand All @@ -17,21 +17,18 @@ The _Apify Model Context Protocol (MCP) Server_ allows AI applications to connec
You can use the Apify MCP Server in two ways:

- _HTTPS Endpoint_ `mcp.apify.com`: Connect your MCP client through OAuth or by including `Authorization: Bearer <APIFY_TOKEN>` header in your requests.
- `https://mcp.apify.com` for streamable transport (recommended)
- `https://mcp.apify.com/sse` for SSE transport (legacy)
- `https://mcp.apify.com` for streamable transport
- _Standard Input/Output (stdio)_: Ideal for local integrations and command-line tools such as the Claude for Desktop client.
- Set MCP client server command to `npx @apify/actors-mcp-server` and environment variable `APIFY_TOKEN` to your Apify API token
- See `npx @apify/actors-mcp-server --help` for more options

You could also use legacy option by running [Apify Actors MCP Server](https://apify.com/apify/actors-mcp-server) as an Actor.
:::tip Quick setup options
MCP server configuration for other clients: Use https://mcp.apify.com to select Actors and tools, then copy the configuration to your client.

:::tip Run instantly ⚡

To install the Apify MCP Server in [Claude for Desktop](https://claude.ai/download) with one click, download and run the latest [Apify MCP Server DXT file](https://github.com/apify/actors-mcp-server/releases/latest/download/actors-mcp-server.dxt)
Claude Desktop: Download and run the [Apify MCP Server DXT file](https://github.com/apify/actors-mcp-server/releases/latest/download/actors-mcp-server.dxt) for one-click installation.

:::


## Prerequisites

Before you start, make sure you have the following:
Expand Down Expand Up @@ -211,7 +208,11 @@ Check your client’s documentation or settings to confirm this feature is avail

The Apify MCP server has a rate limit of _30 requests per second_ per user. If you exceed this limit, you will receive a `429 Too Many Requests` response.

## Troubleshooting
## Support and contribution

The Apify MCP Server is an open-source project.
You can report bugs, suggest new features, or ask questions in the [GitHub issues](https://github.com/apify/actors-mcp-server/issues).
If you find this project useful, please [star it on GitHub](https://github.com/apify/actors-mcp-server) to show your support!

- _Authorization (API Token):_ If the MCP server isn’t executing Actors, ensure you provided a correct Apify API token. Without a valid `APIFY_TOKEN`, the server cannot start Actor runs. Always set the `APIFY_TOKEN` environment variable when running locally.
- _Ensure latest version:_ If running via NPM, always use the latest version of `@apify/actors-mcp-server` for the newest features and fixes. You can append `@latest` when installing or in your config args to ensure this.
Expand All @@ -221,7 +222,7 @@ The Apify MCP server has a rate limit of _30 requests per second_ per user. If y
## Learn more

- [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction): Learn about the open standard on the official MCP website – understanding the protocol can help you build custom agents.
- [Apify Actors MCP Server](https://apify.com/apify/actors-mcp-server): The README for the Apify MCP Server actor (available on Apify Store as `apify/actors-mcp-server`) provides technical details on implementation and advanced usage.
- [Actors MCP Server GitHub](https://github.com/apify/actors-mcp-server): The README for the Apify MCP Server actor (available on Apify Store as `apify/actors-mcp-server`) provides technical details on implementation and advanced usage.
- [Apify Tester MCP Client](https://apify.com/jiri.spilka/tester-mcp-client): A specialized client actor (`jiri.spilka/tester-mcp-client`) that you can run to simulate an AI agent in your browser. Useful for testing your setup with a chat UI.
- [How to use MCP with Apify Actors](https://blog.apify.com/how-to-use-mcp/): Learn how to expose over 5,000 Apify Actors to AI agents with Claude and LangGraph, and configure MCP clients and servers.
- [Apify MCP Server Tutorial](https://www.youtube.com/watch?v=BKu8H91uCTg): Integrate thousands of Apify Actors and Agents with Claude.