Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
Binary file modified sources/platform/images/apify_mcp_server.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
18 changes: 6 additions & 12 deletions sources/platform/integrations/ai/mastra.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ Instantiate the Mastra MCP client:
const mcpClient = new MastraMCPClient({
name: 'apify-client',
server: {
url: new URL('https://actors-mcp-server.apify.actor/sse'),
url: new URL('https://mcp.apify.com/sse'),
requestInit: {
headers: { Authorization: `Bearer ${process.env.APIFY_TOKEN}` }
},
Expand Down Expand Up @@ -122,17 +122,10 @@ console.log(response.text);
await mcpClient.disconnect();
```

Before running the agent, we need to start the [Actors MCP Server](https://apify.com/apify/actors-mcp-server) by sending a request:

```bash
curl https://actors-mcp-server.apify.actor/?token=YOUR_APIFY_TOKEN&actors=apify/rag-web-browser,clockworks/free-tiktok-scraper
```

Replace `YOUR_APIFY_TOKEN` with your Apify API token. You can also open the URL in a browser to start the server.

:::note Use any Apify Actor

Since it uses the [Actors MCP Server](https://apify.com/apify/actors-mcp-server), swap in any Apify Actor from the [Apify Store](https://apify.com/store) by updating the startup request’s `actors` parameter. No other changes are needed in the agent code.
Since it uses the [Apify MCP Server](https://mcp.apify.com), swap in any Apify Actor from the [Apify Store](https://apify.com/store) by updating the startup request’s `actors` parameter.
No other changes are needed in the agent code.

:::

Expand Down Expand Up @@ -179,7 +172,7 @@ process.env.OPENAI_API_KEY = "your-openai-api-key";
const mcpClient = new MastraMCPClient({
name: 'apify-client',
server: {
url: new URL('https://actors-mcp-server.apify.actor/sse'),
url: new URL('https://mcp.apify.com/sse'),
requestInit: {
headers: { Authorization: `Bearer ${process.env.APIFY_TOKEN}` }
},
Expand Down Expand Up @@ -223,7 +216,8 @@ await mcpClient.disconnect();

- [Apify Actors](https://docs.apify.com/platform/actors)
- [Mastra Documentation](https://mastra.ai/docs)
- [Apify MCP Server](https://apify.com/apify/actors-mcp-server)
- [Apify MCP Server](https://mcp.apify.com)
- [How to use MCP with Apify Actors](https://blog.apify.com/how-to-use-mcp/)
- [Apify Store](https://apify.com/store)
- [What are AI Agents?](https://blog.apify.com/what-are-ai-agents/)
- [How to Build an AI Agent](https://blog.apify.com/how-to-build-an-ai-agent/)
10 changes: 5 additions & 5 deletions sources/platform/integrations/ai/mcp.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,8 @@ 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
- `https://mcp.apify.com/sse` for legacy SSE transport
- `https://mcp.apify.com` for streamable transport (recommended)
- `https://mcp.apify.com/sse` for SSE transport (legacy)
- _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
Expand Down Expand Up @@ -108,9 +108,9 @@ In the client settings, you need to provide server configuration:

By default, the main Actors MCP Server starts with a single default [RAG Web Browser Actor](https://apify.com/apify/rag-web-browser). However, you can fully customize which Actors are available:

- _Dynamic adding during a session:_ If your client supports it, the agent itself can add Actors dynamically by name (using the `add-actor` operation) at runtime. For example, after using `search-actors` to find an Actor’s name, calling `add-actor` with that name will load it.
_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`).
- _Dynamic adding during a session:_ If your client supports it, the agent itself can add Actors dynamically by name (using the `add-actor` operation) at runtime. For example, after using `search-actors` to find an Actor’s name, calling `add-actor` with that name will load it.
_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 url:_ If you are using Streamable HTTP or SSE protocol, you could add `actors` query parameter with Actor names separated by comma:

Expand Down
58 changes: 39 additions & 19 deletions sources/platform/integrations/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -146,15 +146,10 @@ The Apify platform integrates with popular ETL and data pipeline services, enabl
</CardGrid>
<br />

If you are working on an AI/LLM-related project, we recommend you look into the Langchain integration.
If you are working on AI/LLM-related applications, we recommend looking into the many integrations with popular AI/LLM ecosystems.
These integrations allow you to use Apify Actors as tools and data sources.

<CardGrid>
<Card
title="Mastra"
to="./integrations/mastra"
imageUrl="/img/platform/integrations/mastra.png"
smallImage
/>
<Card
title="CrewAI"
to="./integrations/crewai"
Expand All @@ -168,21 +163,21 @@ If you are working on an AI/LLM-related project, we recommend you look into the
smallImage
/>
<Card
title="LangChain"
to="./integrations/langchain"
imageUrl="/img/platform/integrations/langchain.png"
title="Mastra"
to="./integrations/mastra"
imageUrl="/img/platform/integrations/mastra.png"
smallImage
/>
<Card
title="LlamaIndex"
to="./integrations/llama"
imageUrl="/img/platform/integrations/llamaindex.jpeg"
title="Lindy"
to="./integrations/lindy"
imageUrl="/img/platform/integrations/lindy.png"
smallImage
/>
<Card
title="Haystack"
to="./integrations/haystack"
imageUrl="/img/platform/integrations/haystack.png"
title="Langflow"
to="./integrations/langflow"
imageUrl="/img/platform/integrations/langflow.png"
smallImage
/>
<Card
Expand All @@ -192,9 +187,21 @@ If you are working on an AI/LLM-related project, we recommend you look into the
smallImage
/>
<Card
title="AWS Bedrock"
to="./integrations/aws_bedrock"
imageUrl="/img/platform/integrations/aws-bedrock.png"
title="LangChain"
to="./integrations/langchain"
imageUrl="/img/platform/integrations/langchain.png"
smallImage
/>
<Card
title="LlamaIndex"
to="./integrations/llama"
imageUrl="/img/platform/integrations/llamaindex.jpeg"
smallImage
/>
<Card
title="Haystack"
to="./integrations/haystack"
imageUrl="/img/platform/integrations/haystack.png"
smallImage
/>
<Card
Expand All @@ -215,6 +222,19 @@ If you are working on an AI/LLM-related project, we recommend you look into the
imageUrl="/img/platform/integrations/milvus.svg"
smallImage
/>
<Card
title="MCP"
to="./integrations/mcp"
imageUrl="/img/platform/integrations/mcp-logo.png"
imageUrlDarkTheme="/img/platform/integrations/mcp-logo-white.png"
smallImage
/>
<Card
title="AWS Bedrock"
to="./integrations/aws_bedrock"
imageUrl="/img/platform/integrations/aws-bedrock.png"
smallImage
/>
<Card
title="OpenAI Assistants"
to="./integrations/openai-assistants"
Expand Down
2 changes: 1 addition & 1 deletion sources/platform/integrations/integrate_with_apify.md
Original file line number Diff line number Diff line change
Expand Up @@ -171,7 +171,7 @@ These identifiers enable better analytics and support for your integration.

### Apify API

[Apify API](https://docs.apify.com/api) provides an extensive REST API that covers all of the features of the Apify platform. You can download the complete OpenAPI schema of Apify API in the [YAML](https://docs.apify.com/api/openapi.yaml) or [JSON](https://docs.apify.com/api/openapi.json) formats. Apify provides official libraries for JavaScript and Python to access API.
[Apify API](https://docs.apify.com/api) provides an extensive REST API that covers all the features of the Apify platform. You can download the complete OpenAPI schema of Apify API in the [YAML](https://docs.apify.com/api/openapi.yaml) or [JSON](https://docs.apify.com/api/openapi.json) formats. Apify provides official libraries for JavaScript and Python to access API.

- [Apify API Reference](https://docs.apify.com/api/v2)
- Client libraries
Expand Down
Binary file added static/img/platform/integrations/langflow.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/platform/integrations/lindy.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/platform/integrations/mcp-logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.