From 4039159854cde73eee6d0f3feba62f089d473164 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Du=C5=A1an=20Vystr=C4=8Dil?= Date: Tue, 1 Jul 2025 09:24:57 +0200 Subject: [PATCH 1/7] Update Quickstart section - Changed order of ways how to connect - Added mention for oAuth --- sources/platform/integrations/ai/mcp.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/sources/platform/integrations/ai/mcp.md b/sources/platform/integrations/ai/mcp.md index 653ab98d3b..6aae4547a0 100644 --- a/sources/platform/integrations/ai/mcp.md +++ b/sources/platform/integrations/ai/mcp.md @@ -16,12 +16,12 @@ 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 ` header in your requests. + - `https://mcp.apify.com` for streamable transport + - `https://mcp.apify.com/sse` for legacy SSE 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 -- _HTTPS Endpoint_ `mcp.apify.com`: Connect your MCP client by including `Authorization: Bearer ` header in your requests. - - `https://mcp.apify.com` for streamable transport - - `https://mcp.apify.com/sse` for legacy SSE transport You could also use legacy option by running [Apify Actors MCP Server](https://apify.com/apify/actors-mcp-server) as an Actor. From 48da3238277fab40508c4035276caa27fbd23fdf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Du=C5=A1an=20Vystr=C4=8Dil?= Date: Tue, 1 Jul 2025 10:00:25 +0200 Subject: [PATCH 2/7] Oauth section --- sources/platform/integrations/ai/mcp.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/sources/platform/integrations/ai/mcp.md b/sources/platform/integrations/ai/mcp.md index 6aae4547a0..e3e9d7a4f6 100644 --- a/sources/platform/integrations/ai/mcp.md +++ b/sources/platform/integrations/ai/mcp.md @@ -34,6 +34,20 @@ Before you start, make sure you have the following: 1. _Apify API Token:_ Get your personal API token from the **Integrations** section in [Apify Console](https://console.apify.com/account#/integrations). This token will be used to authorize the MCP server to run Actors on your behalf. 1. _MCP client:_ An AI agent or client that supports MCP. This could be Anthropic Claude for Desktop, a VS Code extension with MCP support, Apify’s web-based Tester MCP Client, or any custom client implementation. See supported MCP clients in [official documentation](https://modelcontextprotocol.io/clients). +## Example usage (Streamable HTTP with Oauth) + +The easiest way how to connect is via Oauth. You just need server URL `https://mcp.apify.com` and to confirm your authentication to Apify in the browser. Depending on your MCP client, you'll either need a simple configuration or set it up in UI: + + ```json + { + "mcpServers": { + "apify": { + "url": "https://mcp.apify.com" + } + } + } + ``` + ## Example usage (local stdio with Claude for Desktop) Let’s walk through an example of using Claude for Desktop with the Apify MCP Server: From a244690f7a18614a5ee76d7a9e37e090f56601f0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Du=C5=A1an=20Vystr=C4=8Dil?= Date: Tue, 1 Jul 2025 10:01:34 +0200 Subject: [PATCH 3/7] Fix json --- sources/platform/integrations/ai/mcp.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/sources/platform/integrations/ai/mcp.md b/sources/platform/integrations/ai/mcp.md index e3e9d7a4f6..808f3b79e6 100644 --- a/sources/platform/integrations/ai/mcp.md +++ b/sources/platform/integrations/ai/mcp.md @@ -38,15 +38,15 @@ Before you start, make sure you have the following: The easiest way how to connect is via Oauth. You just need server URL `https://mcp.apify.com` and to confirm your authentication to Apify in the browser. Depending on your MCP client, you'll either need a simple configuration or set it up in UI: - ```json - { - "mcpServers": { - "apify": { - "url": "https://mcp.apify.com" - } - } - } - ``` +```json +{ + "mcpServers": { + "apify": { + "url": "https://mcp.apify.com" + } + } +} +``` ## Example usage (local stdio with Claude for Desktop) From c1439a85be3f73d452278feda9eb59e0dd47b252 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Du=C5=A1an=20Vystr=C4=8Dil?= Date: Tue, 1 Jul 2025 10:13:25 +0200 Subject: [PATCH 4/7] Added multiple actors for Streamable/SSE --- sources/platform/integrations/ai/mcp.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/sources/platform/integrations/ai/mcp.md b/sources/platform/integrations/ai/mcp.md index 808f3b79e6..426f578f0a 100644 --- a/sources/platform/integrations/ai/mcp.md +++ b/sources/platform/integrations/ai/mcp.md @@ -110,7 +110,19 @@ By default, the main Actors MCP Server starts with a single default [RAG Web Bro _Tools for adding and removing Actors are enabled by default._ You can disable these tools by setting the parameter `?enableAddingActors=false` in the MCP Server URL, or with the CLI flag `--enable-adding-actors=false` (can also be set in Claude for Desktop config args as `--enable-adding-actors=false`). Not all MCP client frameworks allow dynamic tool addition at runtime, but Apify’s own tester client does, if adding Actors is enabled. -- _Via config file:_ When using Claude for Desktop, you can specify which Actors should be immediately available by configuring your `mcpServers` settings. Add the Actors as a comma-separated list in the `--actors` parameter, as shown in the example below. This pre-loads your selected tools without requiring discovery during conversations, ideal for workflows with predictable tool needs. +- _Via url:_ If you are using Streamable HTTP or SSE protocol, you could add `actors` query parameter with Actor names separated by comma: + +```json +{ + "mcpServers": { + "Apify": { + "url": "https://mcp.apify.com/?actors=lukaskrivka/google-maps-with-contact-details,apify/instagram-scraper" + } + } +} +``` + +- _Via config file:_ For local stdio connection, you can specify which Actors should be immediately available by configuring your json configuration. Add the Actors as a comma-separated list in the `--actors` parameter, as shown in the example below. This pre-loads your selected tools without requiring discovery during conversations, ideal for workflows with predictable tool needs. ```json { @@ -129,6 +141,7 @@ By default, the main Actors MCP Server starts with a single default [RAG Web Bro } ``` + In summary, you can start with a broad set (everything open and discoverable) or a narrow set (just what you need) and even expand tools on the fly, giving your agent a lot of flexibility without overwhelming it initially. ## Dynamic Actor tooling From d29169c44c80b351df1aa3310229a491024285d1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Du=C5=A1an=20Vystr=C4=8Dil?= Date: Tue, 1 Jul 2025 13:00:48 +0200 Subject: [PATCH 5/7] Update sources/platform/integrations/ai/mcp.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com> --- sources/platform/integrations/ai/mcp.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/sources/platform/integrations/ai/mcp.md b/sources/platform/integrations/ai/mcp.md index 426f578f0a..0ce5e19140 100644 --- a/sources/platform/integrations/ai/mcp.md +++ b/sources/platform/integrations/ai/mcp.md @@ -36,7 +36,9 @@ Before you start, make sure you have the following: ## Example usage (Streamable HTTP with Oauth) -The easiest way how to connect is via Oauth. You just need server URL `https://mcp.apify.com` and to confirm your authentication to Apify in the browser. Depending on your MCP client, you'll either need a simple configuration or set it up in UI: +We recommend connecting through OAuth for a secure and simple authentication process. + +During setup, provide the server URL `https://mcp.apify.com`. You will then be redirected to your browser to sign in to your Apify account and approve the connection. The configuration steps may vary slightly depending on your MCP client. ```json { From 74bee63b7c87f2bc5bad7ba8eb64777726899f2f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Du=C5=A1an=20Vystr=C4=8Dil?= Date: Tue, 1 Jul 2025 13:53:31 +0200 Subject: [PATCH 6/7] Update sources/platform/integrations/ai/mcp.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com> --- sources/platform/integrations/ai/mcp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/platform/integrations/ai/mcp.md b/sources/platform/integrations/ai/mcp.md index 0ce5e19140..43c2612d52 100644 --- a/sources/platform/integrations/ai/mcp.md +++ b/sources/platform/integrations/ai/mcp.md @@ -16,7 +16,7 @@ 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 ` header in your requests. +- _HTTPS Endpoint_ `mcp.apify.com`: Connect your MCP client through OAuth or by including `Authorization: Bearer ` header in your requests. - `https://mcp.apify.com` for streamable transport - `https://mcp.apify.com/sse` for legacy SSE transport - _Standard Input/Output (stdio)_: Ideal for local integrations and command-line tools such as the Claude for Desktop client. From f86e138685d9ba9436899b3e81330378d7734cf1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Du=C5=A1an=20Vystr=C4=8Dil?= Date: Tue, 1 Jul 2025 13:53:38 +0200 Subject: [PATCH 7/7] Update sources/platform/integrations/ai/mcp.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com> --- sources/platform/integrations/ai/mcp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/platform/integrations/ai/mcp.md b/sources/platform/integrations/ai/mcp.md index 43c2612d52..89ee7415cd 100644 --- a/sources/platform/integrations/ai/mcp.md +++ b/sources/platform/integrations/ai/mcp.md @@ -34,7 +34,7 @@ Before you start, make sure you have the following: 1. _Apify API Token:_ Get your personal API token from the **Integrations** section in [Apify Console](https://console.apify.com/account#/integrations). This token will be used to authorize the MCP server to run Actors on your behalf. 1. _MCP client:_ An AI agent or client that supports MCP. This could be Anthropic Claude for Desktop, a VS Code extension with MCP support, Apify’s web-based Tester MCP Client, or any custom client implementation. See supported MCP clients in [official documentation](https://modelcontextprotocol.io/clients). -## Example usage (Streamable HTTP with Oauth) +## Example usage (Streamable HTTP with OAuth) We recommend connecting through OAuth for a secure and simple authentication process.