From d186044bef11a7c64e9e73942e50ffa0ece85606 Mon Sep 17 00:00:00 2001 From: Jiri Spilka Date: Thu, 27 Nov 2025 16:01:01 +0100 Subject: [PATCH 1/5] feat: Update MCP docs with telemetry info --- sources/platform/integrations/ai/mcp.md | 39 +++++++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/sources/platform/integrations/ai/mcp.md b/sources/platform/integrations/ai/mcp.md index c74bf5b356..60ea0efc62 100644 --- a/sources/platform/integrations/ai/mcp.md +++ b/sources/platform/integrations/ai/mcp.md @@ -314,6 +314,45 @@ For a detailed overview of client support for dynamic discovery, see the [MCP cl ::: +## Telemetry + +The MCP Server collects telemetry data about tool calls and MCP clients to help Apify understand usage patterns and improve the service. +Participation in this program is optional and you may opt out if you prefer not to share any information. + +### Data collection + +All telemetry data is collected and stored securely. +We do not collect any sensitive information such as conversation, arguments passed to tools, API tokens, or personal data. + +The server collects anonymous information about tool usage, including: + +- Usage of all tools (calls, success/failure, duration) +- MCP client attributes (client name, version, capabilities) + +By default, telemetry is **enabled** for all tool calls. + +### Remote server + +For the remote server (`mcp.apify.com`), you can opt out of telemetry by adding the `telemetry-enabled=false` query parameter to the server URL: + +```text +https://mcp.apify.com?telemetry-enabled=false +``` + +### Local stdio server + +For the local stdio server, you can opt out of telemetry by setting the `--telemetry-enabled` CLI flag to `false` or the `TELEMETRY_ENABLED` environment variable to `false`. + +CLI flags take precedence over environment variables. + +```bash +# Disable via CLI flag +npx @apify/actors-mcp-server --telemetry-enabled=false + +# Or set environment variable +export TELEMETRY_ENABLED=false +npx @apify/actors-mcp-server +``` ## Advanced usage From 2c95545a496cbe0eff1629ee72b67d890ad546d9 Mon Sep 17 00:00:00 2001 From: Jiri Spilka Date: Thu, 27 Nov 2025 16:22:27 +0100 Subject: [PATCH 2/5] fix: Table format --- sources/platform/integrations/ai/mcp.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/sources/platform/integrations/ai/mcp.md b/sources/platform/integrations/ai/mcp.md index 60ea0efc62..77f3044bea 100644 --- a/sources/platform/integrations/ai/mcp.md +++ b/sources/platform/integrations/ai/mcp.md @@ -277,17 +277,17 @@ Use the UI configurator `https://mcp.apify.com/` to select your tools visually, | [`apify/rag-web-browser`](https://apify.com/apify/rag-web-browser) | Actor | ✅ | Browse and extract web data | | `search-apify-docs` | docs | ✅ | Search the Apify documentation for relevant pages | | `fetch-apify-docs` | docs | ✅ | Fetch the full content of an Apify documentation page by its URL | -| `get-actor-run` | runs | | Get detailed information about a specific Actor run | -| `get-actor-run-list` | runs | | Get a list of an Actor's runs, filterable by status | -| `get-actor-log` | runs | | Retrieve the logs for a specific Actor run | -| `get-dataset` | storage | | Get metadata about a specific dataset | -| `get-dataset-items` | storage | | Retrieve items from a dataset with support for filtering and pagination | -| `get-dataset-schema` | storage | | Generate a JSON schema from dataset items | -| `get-key-value-store` | storage | | Get metadata about a specific key-value store | -| `get-key-value-store-keys`| storage | | List the keys within a specific key-value store | -| `get-key-value-store-record`| storage | | Get the value associated with a specific key in a key-value store | -| `get-dataset-list` | storage | | List all available datasets for the user | -| `get-key-value-store-list`| storage | | List all available key-value stores for the user | +| `get-actor-run` | runs | | Get detailed information about a specific Actor run | +| `get-actor-run-list` | runs | | Get a list of an Actor's runs, filterable by status | +| `get-actor-log` | runs | | Retrieve the logs for a specific Actor run | +| `get-dataset` | storage | | Get metadata about a specific dataset | +| `get-dataset-items` | storage | | Retrieve items from a dataset with support for filtering and pagination | +| `get-dataset-schema` | storage | | Generate a JSON schema from dataset items | +| `get-key-value-store` | storage | | Get metadata about a specific key-value store | +| `get-key-value-store-keys` | storage | | List the keys within a specific key-value store | +| `get-key-value-store-record` | storage | | Get the value associated with a specific key in a key-value store | +| `get-dataset-list` | storage | | List all available datasets for the user | +| `get-key-value-store-list` | storage | | List all available key-value stores for the user | | `add-actor`* | experimental | ❔ | Add an Actor as a new tool for the user to call | | `get-actor-output`* | - | ✅ | Retrieve the output from an Actor call which is not included in the output preview of the Actor tool. | From c7023376652bff5fd866550e458ef70f8465a95d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ji=C5=99=C3=AD=20Spilka?= Date: Thu, 4 Dec 2025 14:49:54 +0100 Subject: [PATCH 3/5] Apply suggestions from code review Co-authored-by: Marcel Rebro --- sources/platform/integrations/ai/mcp.md | 28 +++++++++++-------------- 1 file changed, 12 insertions(+), 16 deletions(-) diff --git a/sources/platform/integrations/ai/mcp.md b/sources/platform/integrations/ai/mcp.md index 77f3044bea..698e200d03 100644 --- a/sources/platform/integrations/ai/mcp.md +++ b/sources/platform/integrations/ai/mcp.md @@ -316,22 +316,24 @@ For a detailed overview of client support for dynamic discovery, see the [MCP cl ## Telemetry -The MCP Server collects telemetry data about tool calls and MCP clients to help Apify understand usage patterns and improve the service. +The MCP server collects telemetry data about tool calls and MCP clients to help Apify understand usage patterns and improve the service. Participation in this program is optional and you may opt out if you prefer not to share any information. ### Data collection All telemetry data is collected and stored securely. -We do not collect any sensitive information such as conversation, arguments passed to tools, API tokens, or personal data. +We do not collect any sensitive information such as conversations, arguments passed to tools, API tokens, or personal data. The server collects anonymous information about tool usage, including: -- Usage of all tools (calls, success/failure, duration) +- Basic information about used tools (calls, success/failure, duration) - MCP client attributes (client name, version, capabilities) -By default, telemetry is **enabled** for all tool calls. +By default, telemetry is *enabled* for all tool calls. -### Remote server +### Opt out of telemetry + +#### Remote server For the remote server (`mcp.apify.com`), you can opt out of telemetry by adding the `telemetry-enabled=false` query parameter to the server URL: @@ -339,20 +341,14 @@ For the remote server (`mcp.apify.com`), you can opt out of telemetry by adding https://mcp.apify.com?telemetry-enabled=false ``` -### Local stdio server - -For the local stdio server, you can opt out of telemetry by setting the `--telemetry-enabled` CLI flag to `false` or the `TELEMETRY_ENABLED` environment variable to `false`. +#### Local stdio server -CLI flags take precedence over environment variables. +For the local stdio server, opt out of telemetry using a CLI flag or an environment variable. When both the CLI flag and environment variable are set, the CLI flag takes precedence. -```bash -# Disable via CLI flag -npx @apify/actors-mcp-server --telemetry-enabled=false +- _CLI flag_: set the `--telemetry-enabled` CLI flag to `false`: -# Or set environment variable -export TELEMETRY_ENABLED=false -npx @apify/actors-mcp-server -``` + ```bash + npx @apify/actors-mcp-server --telemetry-enabled=false ## Advanced usage From 04d41c78cc53e49bd293f1302116d017db0f9373 Mon Sep 17 00:00:00 2001 From: Jiri Spilka Date: Thu, 4 Dec 2025 16:36:44 +0100 Subject: [PATCH 4/5] fix: lint --- 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 698e200d03..7bfe13d438 100644 --- a/sources/platform/integrations/ai/mcp.md +++ b/sources/platform/integrations/ai/mcp.md @@ -329,7 +329,7 @@ The server collects anonymous information about tool usage, including: - Basic information about used tools (calls, success/failure, duration) - MCP client attributes (client name, version, capabilities) -By default, telemetry is *enabled* for all tool calls. +By default, telemetry is _enabled_ for all tool calls. ### Opt out of telemetry From 00ed78ee00f7e8bfb303d16db4317e6d84ac0277 Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Fri, 5 Dec 2025 14:05:37 +0100 Subject: [PATCH 5/5] fix optout from local --- sources/platform/integrations/ai/mcp.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/sources/platform/integrations/ai/mcp.md b/sources/platform/integrations/ai/mcp.md index 7bfe13d438..1ec47611b3 100644 --- a/sources/platform/integrations/ai/mcp.md +++ b/sources/platform/integrations/ai/mcp.md @@ -349,6 +349,14 @@ For the local stdio server, opt out of telemetry using a CLI flag or an environm ```bash npx @apify/actors-mcp-server --telemetry-enabled=false + ``` + +- _Environment variable_: set the `TELEMETRY_ENABLED` environment variable to `false`: + + ```bash + export TELEMETRY_ENABLED=false + npx @apify/actors-mcp-server + ``` ## Advanced usage