docs: update pipedream docs

sources/platform/integrations/index.mdx

@@ -229,6 +229,13 @@ Trigger Apify Actors from workflow automation platforms (n8n, Make, and Zapier),
         imageUrl="/img/platform/integrations/gumloop.svg"
         smallImage
     />
+    <Card
+        title="Pipedream"
+        desc="Run Apify Actors and react to Actor or task run events."
+        to="/integrations/pipedream"
+        imageUrl="/img/platform/integrations/pipedream.svg"
+        smallImage
+    />
 </CardGrid>
 
 [See all Workflow and notification integrations →](/integrations/workflows-and-notifications)

sources/platform/integrations/workflows-and-notifications/index.mdx

@@ -39,6 +39,13 @@ Trigger Apify Actors from workflow automation platforms (n8n, Make, and Zapier),
         imageUrl="/img/platform/integrations/gumloop.svg"
         smallImage
     />
+    <Card
+        title="Pipedream"
+        desc="Developer-first workflow automation. Run Apify Actors and react to Actor or task run events."
+        to="/integrations/pipedream"
+        imageUrl="/img/platform/integrations/pipedream.svg"
+        smallImage
+    />
 </CardGrid>
 
 For the full list, see the **Workflows and notifications** section in the sidebar.

sources/platform/integrations/workflows-and-notifications/pipedream.md

@@ -23,7 +23,7 @@ Before you begin, make sure you have:
 1. Log into your Pipedream account and [create a new workflow](https://pipedream.com/docs/workflows).
 1. [Add an Apify step](https://pipedream.com/docs/workflows/building-workflows/steps) (trigger or action) to your workflow. Select one of two Apify apps:
 
-    ![Selecting the Apify app in Pipedream](../images/pipedream-select-app.png)
+    ![Selecting the Apify app in Pipedream](../images/pipedream/pipedream-select-app.webp)
 
     - **Apify** - Authenticate with your Apify API token. Find it in [Apify Console](https://console.apify.com/settings/integrations) under **Settings > Integrations**.
     - **Apify (OAuth)** - Authorize access to your Apify account via OAuth.
@@ -41,7 +41,7 @@ Before you begin, make sure you have:
 1. Select the trigger you want to use, e.g. **New Finished Actor Run**.
 1. Configure the trigger by selecting the Actor or task to monitor.
 
-    ![Configuring an Apify trigger in Pipedream](../images/pipedream-trigger.png)
+    ![Configuring an Apify trigger in Pipedream](../images/pipedream/pipedream-trigger.webp)
 1. Add subsequent steps to process the output.
 
 ## Use Apify as an action
@@ -53,28 +53,40 @@ Before you begin, make sure you have:
 1. Select the action you want to use, e.g. **Run Actor**.
 1. Configure the action parameters:
     - Select the Actor from Apify Store or your recently used Actors
-    - Provide the Actor input as JSON
-    - Set optional parameters such as timeout, memory, and build tag
+    - Fill in the Actor's input fields, which are generated from the Actor's input schema. Actors without an input schema accept raw JSON input.
+    - Set optional parameters such as timeout (in seconds), memory (preset values from 128 MB to 32 GB), and build (a build tag or build number)
+    - Use the **Wait for Finish** switch to wait for the run to complete and return its output, or return immediately after starting the run
 
-    ![Configuring an Apify action in Pipedream](../images/pipedream-action.png)
+    ![Configuring an Apify action in Pipedream](../images/pipedream/pipedream-action.webp)
 1. Add another Apify step with **Get Dataset Items** to retrieve the Actor's output.
 1. Add any subsequent steps to process or store the data.
 
+:::caution Building workflows with AI
+
+Pipedream's [Apify app page](https://pipedream.com/apps/apify) can generate a workflow for you with Pipedream's AI builder. Because the Apify connector is schema-driven, the AI builder can consume your Pipedream AI tokens quickly and might not configure required inputs reliably. For predictable results, add the Apify triggers and actions to your workflow directly, as described above.
+
+:::
+
 ## Triggers
 
 - **New finished Actor run (instant)** - Triggers when a selected Actor run finishes.
 - **New finished task run (instant)** - Triggers when a selected task run finishes.
 
 ## Actions
 
-- **Run Actor** - Runs a selected Actor with customizable input and configuration.
+- **Run Actor** - Runs a selected Actor with customizable input and configuration, and optionally waits for it to finish.
 - **Run task** - Runs a selected Actor task and optionally waits for it to finish.
-- **Run task synchronously** - Runs a selected task and returns its dataset items when it finishes.
 - **Scrape single URL** - Runs a scraper on a specified URL and returns its content as HTML. Use this for extracting content from a single page, e.g. in LLM workflows.
-- **Get dataset items** - Retrieves items from a [dataset](/storage/dataset).
+- **Get dataset items** - Retrieves items from a [dataset](/storage/dataset), specified by ID or name.
 - **Get key-value store record** - Retrieves a record from a [key-value store](/storage/key-value-store).
 - **Set key-value store record** - Creates or updates a record in a [key-value store](/storage/key-value-store).
 
+## Use Apify with AI agents (MCP)
+
+To use Apify Actors directly with AI agents and MCP-compatible clients, use the [Apify MCP server](/integrations/mcp).
+
+Pipedream also hosts an [MCP server for Apify](https://mcp.pipedream.com/app/apify). Because Apify provides its own MCP server, use the Pipedream one only if you want Apify available alongside your other Pipedream apps in a single MCP client.
+
 ## Resources
 
 - [Apify integration page on Pipedream](https://pipedream.com/apps/apify)