fix: Final touches, polish

Author: jirispilka

sources/platform/integrations/ai/chatgpt.md

@@ -10,27 +10,25 @@ slug: /integrations/chatgpt
 
 ---
 
-ChatGPT provides easy conversational access to OpenAI's large language models (LLMs).
-Until recently, ChatGPT could access third-party data only through plugins or direct API calls.
-Now, OpenAI supports the [Model Context Protocol (MCP)](https://openai.com/research/model-context-protocol), which enables integration with web data using Apify Actors.
+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.
 
 In this tutorial, you'll learn how to connect ChatGPT to the **Apify MCP server** using a custom connector.
-This allows ChatGPT to use Apify tools and Actors directly in conversations.
 
 ## Prerequisites
 
-To use the Apify MCP server with ChatGPT, you need:
+Before connecting ChatGPT to Apify, you'll need:
 
-- An [Apify account and API token](https://docs.apify.com/platform/integrations/api#api-token)
-- An OpenAI account with access to ChatGPT
-- ChatGPT with **Developer Mode** enabled
+- _An Apify account_ - Sign up for an Apify account, if you don't have one.
+- _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
 
 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 a connector
+## 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.
 
@@ -44,13 +42,15 @@ When Developer Mode is active, the message input box is outlined in orange.
           (See [mcp.apify.com](https://mcp.apify.com) for details.)
     - **Authentication** – OAuth, you don’t need to provide a client ID or secret.
 
+![ChatGPT Create connect](../images/chatgpt-connector.png)
+
 :::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. 
+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.
 
 :::
@@ -63,7 +63,7 @@ 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.
 
-## Try the connector
+## Try the MCP connector in ChatGPT
 
 Once your connector is ready:
 
@@ -79,17 +79,16 @@ You should see ChatGPT calling Apify tools — such as the [RAG Web Browser](htt
 
 ![ChatGPT Apify tools](../images/chatgpt-with-rag-web-browser.png)
 
-## Use any actor with ChatGPT
+## Use any Actor with ChatGPT
 
-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.
+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”
+> "Find and run an Actor that scrapes Instagram profiles, and get the profile of @natgeo"
 
 
-# Limitations
+## 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.
@@ -100,9 +99,9 @@ By default, the Apify MCP server exposes a set of tools that lets you search and
 - [OpenAI Assistants integration](/platform/integrations/openai-assistants) — Use Apify Actors with OpenAI Assistants API via function calling
 - [OpenAI Agents SDK integration](/platform/integrations/openai-agents) — Integrate Apify MCP server with OpenAI Agents SDK
 
-## References
+## Resources
 
-- [ChatGPT Developer Mode](https://platform.openai.com/docs/guides/developer-mode)
-- [Connectors and MCP servers](https://platform.openai.com/docs/guides/tools-connectors-mcp)
-- [Apify MCP server](https://mcp.apify.com)
-- [Apify MCP documentation](https://docs.apify.com/platform/integrations/mcp)
+- [ChatGPT Developer Mode](https://platform.openai.com/docs/guides/developer-mode) - Learn how to enable Developer Mode in ChatGPT
+- [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

sources/platform/integrations/ai/openai_agents.md

@@ -1,14 +1,14 @@
 ---
 title: OpenAI Agents SDK integration
 sidebar_label: OpenAI Agents SDK
-description: Learn how to integrate Apify with OpenAI Agents SDK using Model Context Protocol to build AI agents with web data access.
+description: Learn how to integrate Apify with the OpenAI Agents SDK using the Model Context Protocol to build AI agents with web data access.
 sidebar_position: 11
 slug: /integrations/openai-agents
 ---
 
 The _OpenAI Agents Python SDK_ enables you to build AI agents powered by OpenAI's language models that can use tools, manage context, and interact with external systems through the [Model Context Protocol (MCP)](https://openai.com/research/model-context-protocol). By connecting to the Apify MCP server, your agents can access Apify's extensive library of Actors to perform web scraping, data extraction, and automation tasks in real time.
 
-For more in-depth details on OpenAI Agents SDK, check out its [official documentation](https://openai.github.io/openai-agents-python/).
+For more details about the OpenAI Agents SDK, see the [official documentation](https://openai.github.io/openai-agents-python/).
 
 ## Prerequisites
 
@@ -66,7 +66,6 @@ if __name__ == "__main__":
     asyncio.run(main())
 ```
 
-
 #### Configuration options
 
 The `MCPServerStreamableHttp` connects to the Apify MCP server using streamable HTTP. Key configuration options: