-
Notifications
You must be signed in to change notification settings - Fork 139
feat: Add chatgpt and Agents SDK integration #2065
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
jirispilka
wants to merge
24
commits into
master
Choose a base branch
from
feat/chatgpt
base: master
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from 11 commits
Commits
Show all changes
24 commits
Select commit
Hold shift + click to select a range
fe30a2a
feat: Add chatgpt.md
jirispilka cf643f6
feat: Rewrite a bit
jirispilka c255787
feat: Rewrite
jirispilka 3236e86
fix: lint
jirispilka bb25659
fix: finished chatgpt.md
jirispilka 6994561
fix: updated openai_agents.md
jirispilka 5334990
fix: update openai articles
jirispilka edc69bf
fix: update openai_agents.md
jirispilka d669538
fix: Update openai_agents.md
jirispilka 6c0a7eb
fix: Final touches, polish
jirispilka d82aa79
fix: update index positions
jirispilka dfbbee1
Apply suggestions from code review
jirispilka e7e8166
Apply suggestions from code review
jirispilka d96f34d
fix: review fixes
jirispilka 9b56256
fix: review fixes
jirispilka 9353554
Merge branch 'master' into feat/chatgpt
jirispilka 5e6191c
fix: review fixes
jirispilka 04ea804
Apply suggestions from code review
jirispilka ded7834
Update sources/platform/integrations/ai/chatgpt.md
jirispilka ed752df
Update sources/platform/integrations/ai/chatgpt.md
jirispilka 00d3380
Update sources/platform/integrations/ai/openai_assistants.md
jirispilka 398bdb6
fix: remove the second admonition
jirispilka 0fb751e
Merge remote-tracking branch 'origin/feat/chatgpt' into feat/chatgpt
jirispilka c9f4e78
Apply suggestion from @TC-MO
jirispilka File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Some comments aren't visible on the classic Files Changed page.
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,107 @@ | ||
| --- | ||
| title: ChatGPT Integration | ||
| sidebar_label: ChatGPT | ||
| description: Learn how to integrate Apify with ChatGPT to provide web context in real-time. | ||
| sidebar_position: 12 | ||
| slug: /integrations/chatgpt | ||
| --- | ||
|
|
||
| **Learn how to integrate Apify Actors with ChatGPT to provide web context in real-time.** | ||
|
|
||
| --- | ||
|
|
||
| The _ChatGPT_ integration enables you to connect ChatGPT to Apify's extensive library of Actors through the [Model Context Protocol (MCP)](https://openai.com/research/model-context-protocol). This allows ChatGPT to use Apify tools and Actors directly in conversations, providing real-time web data access and automation capabilities. | ||
jirispilka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| In this tutorial, you'll learn how to connect ChatGPT to the **Apify MCP server** using a custom connector. | ||
|
|
||
| ## Prerequisites | ||
|
|
||
| Before connecting ChatGPT to Apify, you'll need: | ||
|
|
||
| - _An Apify account_ - Sign up for an Apify account, if you don't have one. | ||
jirispilka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| - _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. | ||
| - _An OpenAI account with access to ChatGPT_ - You need an OpenAI account to use ChatGPT. | ||
| - _ChatGPT with Developer Mode enabled_ - You must enable [Developer Mode](https://platform.openai.com/docs/guides/developer-mode) to add custom connectors. | ||
|
|
||
| ## Enable developer mode in ChatGPT | ||
jirispilka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| You must enable [Developer Mode](https://platform.openai.com/docs/guides/developer-mode) in ChatGPT to add custom connectors like the Apify MCP server. | ||
| When Developer Mode is active, the message input box is outlined in orange. | ||
|
|
||
| ## Create an MCP connector | ||
|
|
||
| 1. In ChatGPT, go to **Settings → Apps & Connectors → Create**. If you don't see the **Create** button, enable developer mode or reload the page. | ||
jirispilka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| 2. Fill in the following fields: | ||
|
|
||
| - **Name** – a user-facing title, e.g., `apify-mcp` | ||
| - **Description** – a short description of what the connector does | ||
| - **MCP Server URL** – choose one of the following: | ||
| - `https://mcp.apify.com` — use the default set of Apify tools | ||
| - `https://mcp.apify.com?tools=actors,docs,mtrunkat/url-list-download-html` — use specific tools | ||
| (See [mcp.apify.com](https://mcp.apify.com) for details.) | ||
jirispilka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| - **Authentication** – OAuth, you don’t need to provide a client ID or secret. | ||
|
|
||
|  | ||
jirispilka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| :::caution ChatGPT currently cannot change selected tools after connector creation | ||
| At the moment, ChatGPT does not allow modifying the selected tools after the connector is created. | ||
| If you need to add or remove tools later, you’ll need to create a new connector. | ||
|
|
||
| If you try to use a connector with social media scrapers like Instagram or TikTok, you may see the error: | ||
| "Something went wrong with setting up the connection." | ||
| This error typically occurs for social media scrapers like Instagram, TikTok, etc. | ||
| But you can still use these Actors with ChatGPT by including them when initially setting up the connector. | ||
|
|
||
| ::: | ||
jirispilka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| ## Authorize access | ||
|
|
||
| Click **Create** to proceed to the authentication page. | ||
| You’ll be redirected to the Apify website to authorize ChatGPT to access your Apify account. | ||
| Ensure you're logged into the correct Apify account before approving access. | ||
|
|
||
| Once authorized, you’ll return to ChatGPT and see a success message with a list of tools available from the Apify MCP server. | ||
jirispilka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| ## Try the MCP connector in ChatGPT | ||
|
|
||
| Once your connector is ready: | ||
|
|
||
| 1. Open a **new chat** in ChatGPT. | ||
| 2. Click the **+** button near the message composer and select **More**. | ||
jirispilka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| 3. Choose your **Apify MCP connector** to add it to the conversation. | ||
| 4. Ask ChatGPT to use Apify tools, for example: | ||
jirispilka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| > “Search the web and summarize recent trends in AI agents” | ||
|
|
||
| You’ll need to grant permission for each Apify tool when it’s used for the first time. | ||
| You should see ChatGPT calling Apify tools — such as the [RAG Web Browser](https://apify.com/apify/rag-web-browser) — to gather information. | ||
|
|
||
|  | ||
|
|
||
| ## Use any Actor with ChatGPT | ||
jirispilka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| You can use any [Apify Actor](https://apify.com/store) with ChatGPT. By default, the Apify MCP server exposes a set of tools that lets you search and use Actors directly. | ||
|
|
||
| **Example query:** | ||
|
|
||
| > "Find and run an Actor that scrapes Instagram profiles, and get the profile of @natgeo" | ||
|
|
||
|
|
||
| ## Limitations | ||
|
|
||
| - MCP integration in ChatGPT is still in **beta** and may have some limitations or bugs. | ||
| - Tool selection and execution can be **slow**, especially with the latest GPT models. | ||
| - **Custom connectors** are only available in ChatGPT **Developer Mode**. | ||
jirispilka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| ## Related integrations | ||
|
|
||
| - [OpenAI Assistants integration](/platform/integrations/openai-assistants) — Use Apify Actors with OpenAI Assistants API via function calling | ||
jirispilka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| - [OpenAI Agents SDK integration](/platform/integrations/openai-agents) — Integrate Apify MCP server with OpenAI Agents SDK | ||
jirispilka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| ## Resources | ||
|
|
||
| - [ChatGPT Developer Mode](https://platform.openai.com/docs/guides/developer-mode) - Learn how to enable Developer Mode in ChatGPT | ||
jirispilka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| - [Connectors and MCP servers](https://platform.openai.com/docs/guides/tools-connectors-mcp) - Official OpenAI documentation on using MCP servers with ChatGPT | ||
| - [Apify MCP server](https://mcp.apify.com) - Interactive configuration tool for the Apify MCP server | ||
| - [Apify MCP documentation](/platform/integrations/mcp) - Complete guide to using the Apify MCP server | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.