Skip to content

Commit a523ac5

Browse files
jirispilkamarcel-rbroTC-MO
authored
feat: Add chatgpt and Agents SDK integration (#2065)
feat: Add chatgpt.md and Agents SDK integration guides close: apify/ai-team#102 <!-- CURSOR_SUMMARY --> --- > [!NOTE] > <sup>[Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) is generating a summary for commit 6c0a7eb. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup> <!-- /CURSOR_SUMMARY --> --------- Co-authored-by: Marcel Rebro <marcel.rebro@apify.com> Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>
1 parent ec4aa35 commit a523ac5

19 files changed

+397
-15
lines changed

sources/platform/integrations/ai/agno.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Agno Integration
33
sidebar_label: Agno
44
description: Integrate Apify with Agno to power AI agents with web scraping, automation, and data insights.
5-
sidebar_position: 17
5+
sidebar_position: 19
66
slug: /integrations/agno
77
---
88

sources/platform/integrations/ai/aws_bedrock.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Amazon Bedrock integrations
33
sidebar_label: Amazon Bedrock
44
description: Learn how to integrate Apify with Amazon Bedrock Agents to provide web data for AI agents
5-
sidebar_position: 11
5+
sidebar_position: 15
66
slug: /integrations/aws_bedrock
77
---
88

Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
---
2+
title: ChatGPT integration
3+
sidebar_label: ChatGPT
4+
description: Learn how to integrate Apify with ChatGPT to provide web context in real-time.
5+
sidebar_position: 12
6+
slug: /integrations/chatgpt
7+
---
8+
9+
**Learn how to integrate Apify Actors with ChatGPT to provide web context in real-time.**
10+
11+
---
12+
13+
The _ChatGPT_ integration enables you to connect ChatGPT to Apify's extensive library of Actors through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro).
14+
This allows ChatGPT to use Apify tools and Actors directly in conversations, providing real-time web data access and automation capabilities.
15+
16+
You can use any [Apify Actor](https://apify.com/store) with ChatGPT.
17+
By default, the Apify MCP server exposes a set of tools that lets you search and use Actors directly.
18+
19+
**An example query:** "Find and run an Actor that scrapes Instagram profiles, and get the profile of @natgeo"
20+
21+
In this tutorial, you'll learn how to connect ChatGPT to the **Apify MCP server** using a custom connector.
22+
23+
## Prerequisites
24+
25+
Before connecting ChatGPT to Apify, you'll need:
26+
27+
- _An Apify account_ - If you don't have an Apify account already, you can [sign up](https://console.apify.com/sign-up)
28+
- _Apify API token_ - Get your API token from the **Integrations** section in [Apify Console](https://console.apify.com/account#/integrations). This token authorizes the MCP server to run Actors on your behalf. Make sure to keep it secure.
29+
- _An OpenAI account with access to ChatGPT_ - You need an OpenAI account to use ChatGPT.
30+
- _ChatGPT with Developer mode enabled_ - You must enable [Developer Mode](https://platform.openai.com/docs/guides/developer-mode) to add custom connectors (when the Developer mode is active, the message input box is outlined in orange).
31+
32+
## Create an MCP connector
33+
34+
1. In ChatGPT, go to **Settings > Apps & Connectors > Create**. If you don't see the **Create** button, enable Developer mode or reload the page.
35+
36+
2. Fill in the following fields:
37+
38+
- **Name** – a user-facing title, e.g., `apify-mcp`
39+
- **Description** – a short description of what the connector does
40+
- **MCP Server URL** – choose one of the following:
41+
- `https://mcp.apify.com` - use the default set of Apify tools
42+
- `https://mcp.apify.com?tools=actors,docs,mtrunkat/url-list-download-html` - use specific tools
43+
- Refer to [mcp.apify.com](https://mcp.apify.com) for details
44+
- **Authentication** – OAuth, you don’t need to provide a client ID or secret.
45+
46+
3. Select **Create** to proceed to the authentication page.
47+
You’ll be redirected to the Apify website to authorize ChatGPT to access your Apify account.
48+
49+
![ChatGPT Create connection](../images/chatgpt-connector.png)
50+
51+
Once authorized, you'll return to ChatGPT and see a success message with a list of tools available from the Apify MCP server.
52+
53+
:::caution Cannot modify tools after creation
54+
ChatGPT does not allow modifying the selected tools after the connector is created.
55+
If you need to add or remove tools later, you'll need to create a new connector.
56+
:::
57+
58+
## Try the MCP connector in ChatGPT
59+
60+
Once your connector is ready:
61+
62+
1. Open a **new chat** in ChatGPT.
63+
1. Click the **+** button near the message composer and select **More**.
64+
1. Choose your **Apify MCP connector** to add it to the conversation.
65+
1. Ask ChatGPT to use Apify tools, for example:
66+
67+
> “Search the web and summarize recent trends in AI agents”
68+
69+
You’ll need to grant permission for each Apify tool when it’s used for the first time.
70+
You should see ChatGPT calling Apify tools — such as the [RAG Web Browser](https://apify.com/apify/rag-web-browser) — to gather information.
71+
72+
![ChatGPT Apify tools](../images/chatgpt-with-rag-web-browser.png)
73+
74+
## Limitations
75+
76+
- MCP integration in ChatGPT is still in _beta_ and may have some limitations or bugs.
77+
- Tool selection and execution can be _slow_, especially with the latest GPT models.
78+
- _Custom connectors_ are only available in ChatGPT _Developer mode_.
79+
- When creating connectors that include social media scrapers (Instagram, TikTok), you may encounter setup errors. These Actors work correctly once included during initial connector creation, but cannot be added later.
80+
81+
## Related integrations
82+
83+
- [OpenAI Assistants integration](/platform/integrations/openai-assistants) - Use Apify Actors with OpenAI Assistants API via function calling
84+
- [OpenAI Agents SDK integration](/platform/integrations/openai-agents) - Integrate Apify MCP server with OpenAI Agents SDK
85+
86+
## Resources
87+
88+
- [ChatGPT Developer mode](https://platform.openai.com/docs/guides/developer-mode) - Learn how to enable Developer Mode in ChatGPT
89+
- [Connectors and MCP servers](https://platform.openai.com/docs/guides/tools-connectors-mcp) - Official OpenAI documentation on using MCP servers with ChatGPT
90+
- [Apify MCP server](https://mcp.apify.com) - Interactive configuration tool for the Apify MCP server
91+
- [Apify MCP documentation](/platform/integrations/mcp) - Complete guide to using the Apify MCP server

sources/platform/integrations/ai/crewai.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: 🤖🚀 CrewAI integration
33
sidebar_label: CrewAI
44
description: Learn how to build AI Agents with Apify and CrewAI 🤖🚀.
5-
sidebar_position: 2
5+
sidebar_position: 3
66
slug: /integrations/crewai
77
---
88

sources/platform/integrations/ai/flowise.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Flowise integration
33
description: Learn how to integrate Apify with Flowise.
44
sidebar_label: Flowise
5-
sidebar_position: 9
5+
sidebar_position: 10
66
slug: /integrations/flowise
77
---
88

sources/platform/integrations/ai/haystack.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Haystack integration
33
sidebar_label: Haystack
44
description: Learn how to integrate Apify with Haystack to work with web data in the Haystack ecosystem.
5-
sidebar_position: 3
5+
sidebar_position: 4
66
slug: /integrations/haystack
77
---
88

sources/platform/integrations/ai/langchain.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: 🦜🔗 LangChain integration
33
sidebar_label: LangChain
44
description: Learn how to integrate Apify with 🦜🔗 LangChain, in order to feed vector databases and LLMs with data crawled from the web.
5-
sidebar_position: 4
5+
sidebar_position: 5
66
slug: /integrations/langchain
77
---
88

sources/platform/integrations/ai/langflow.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Langflow integration
33
sidebar_label: Langflow
44
description: Learn how to integrate Apify with Langflow low-code tool to build powerful AI agents and workflows that can use any API, model, or database.
5-
sidebar_position: 5
5+
sidebar_position: 6
66
slug: /integrations/langflow
77
---
88

sources/platform/integrations/ai/langgraph.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: 🦜🔘➡️ LangGraph integration
33
sidebar_label: LangGraph
44
description: Learn how to build AI Agents with Apify and LangGraph 🦜🔘➡️.
5-
sidebar_position: 6
5+
sidebar_position: 8
66
slug: /integrations/langgraph
77
---
88

sources/platform/integrations/ai/lindy.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Lindy integration
33
description: Learn how to integrate Apify with Lindy.
44
sidebar_label: Lindy
5-
sidebar_position: 7
5+
sidebar_position: 9
66
slug: /integrations/lindy
77
---
88

0 commit comments

Comments
 (0)