From 98974fc76235b945e0f48971f26b77473bbc2f67 Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Thu, 23 Jul 2026 15:33:48 +0200 Subject: [PATCH 1/3] docs: consolidate Codex docs under the OpenAI hub Move the Codex pages under the OpenAI integrations hub (Codex is an OpenAI product) and rename the desktop page to OpenAI's current naming ("Codex in the ChatGPT desktop app"). Updates the OpenAI hub, both integration card grids, and adds redirects for the old Codex slugs. Co-Authored-By: Claude Opus 4.8 (1M context) --- nginx.conf | 4 +++ .../integrations/ai/codex/_category_.yml | 1 - .../platform/integrations/ai/codex/index.mdx | 32 ------------------- sources/platform/integrations/ai/index.mdx | 8 ++--- .../ai/{codex => openai}/codex-cli.md | 4 +-- .../codex-app.md => openai/codex-desktop.md} | 10 +++--- .../platform/integrations/ai/openai/index.mdx | 20 ++++++++++-- sources/platform/integrations/index.mdx | 6 ++-- 8 files changed, 36 insertions(+), 49 deletions(-) delete mode 100644 sources/platform/integrations/ai/codex/_category_.yml delete mode 100644 sources/platform/integrations/ai/codex/index.mdx rename sources/platform/integrations/ai/{codex => openai}/codex-cli.md (96%) rename sources/platform/integrations/ai/{codex/codex-app.md => openai/codex-desktop.md} (94%) diff --git a/nginx.conf b/nginx.conf index 08dfe741fb..2b69094bc9 100644 --- a/nginx.conf +++ b/nginx.conf @@ -788,6 +788,10 @@ server { # Misc rewrite ^/platform/integrations/llama$ /platform/integrations/llama-index permanent; + # Codex docs consolidated under the OpenAI hub (Codex is an OpenAI product) + rewrite ^/integrations/codex$ /integrations/openai permanent; + rewrite ^/integrations/codex-app$ /integrations/codex-desktop permanent; + # === IA v3 flip: drop the /platform prefix === # Structural moves first (these MUST precede the blanket catch-all, because a # naive /platform/X -> /X strip would 404 for sections that relocated). diff --git a/sources/platform/integrations/ai/codex/_category_.yml b/sources/platform/integrations/ai/codex/_category_.yml deleted file mode 100644 index 379cd5da64..0000000000 --- a/sources/platform/integrations/ai/codex/_category_.yml +++ /dev/null @@ -1 +0,0 @@ -label: 'Codex' diff --git a/sources/platform/integrations/ai/codex/index.mdx b/sources/platform/integrations/ai/codex/index.mdx deleted file mode 100644 index 10868546b4..0000000000 --- a/sources/platform/integrations/ai/codex/index.mdx +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Codex -description: Use Apify Actors with OpenAI Codex - install the Apify plugin in the Codex app or the Codex CLI to discover, run, and build Actors with the MCP server. -sidebar_label: Codex -slug: /integrations/codex ---- - -import Card from '@site/src/components/Card'; -import CardGrid from '@site/src/components/CardGrid'; - -[Codex](https://developers.openai.com/codex/) is OpenAI's agentic coding tool. The [Apify plugin for Codex](https://github.com/apify/apify-codex-plugin) connects Codex to Apify's library of [Actors](https://apify.com/store) through the [Apify MCP server](/integrations/mcp) and five bundled skills for common workflows. - -The plugin installs in two places. Pick the one that matches how you use Codex. - -## Choose your setup - - - - - diff --git a/sources/platform/integrations/ai/index.mdx b/sources/platform/integrations/ai/index.mdx index 93b2cd3726..8f6e6a8c7c 100644 --- a/sources/platform/integrations/ai/index.mdx +++ b/sources/platform/integrations/ai/index.mdx @@ -89,9 +89,9 @@ Plug Apify Actors into the AI stack - chat clients like Claude and ChatGPT via t smallImage /> @@ -55,7 +55,7 @@ The plugin bundles the Apify MCP server. Read-only tools like searching Apify St 1. The first time Codex calls a tool that requires authentication, such as running an Actor, it opens a browser tab for the Apify OAuth flow. -1. Review the permissions and click **Allow access**. +1. Review the permissions and select **Allow access**. 1. Back in the terminal, the `apify` MCP server is connected and ready to use in any new chat. diff --git a/sources/platform/integrations/ai/codex/codex-app.md b/sources/platform/integrations/ai/openai/codex-desktop.md similarity index 94% rename from sources/platform/integrations/ai/codex/codex-app.md rename to sources/platform/integrations/ai/openai/codex-desktop.md index f4198fbbab..54f40713ce 100644 --- a/sources/platform/integrations/ai/codex/codex-app.md +++ b/sources/platform/integrations/ai/openai/codex-desktop.md @@ -1,8 +1,8 @@ --- -title: Codex App integration -sidebar_label: Codex App +title: Codex in the ChatGPT desktop app +sidebar_label: Codex (desktop app) description: Learn how to install the Apify plugin for Codex to discover, run, and build Actors with the Apify MCP server and bundled skills for common workflows. -slug: /integrations/codex-app +slug: /integrations/codex-desktop --- import ThirdPartyDisclaimer from '@site/sources/_partials/_third-party-integration.mdx'; @@ -14,7 +14,7 @@ The [Apify plugin for Codex](https://github.com/apify/apify-codex-plugin) connec - The [Apify MCP server](/integrations/mcp) for searching Apify Store, running Actors, and retrieving datasets through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro). - Five built-in skills for common workflows (see [Bundled skills](#bundled-skills) below). -This guide covers installation in the Codex app. +This guide covers installation in the ChatGPT desktop app, where you select **Codex** from the top-left menu. To use Codex in your terminal instead, see the [Codex CLI](/integrations/codex-cli) guide. @@ -61,7 +61,7 @@ The plugin bundles the Apify MCP server. Read-only tools like searching Apify St 1. After you select **Install Apify**, Codex starts the Apify MCP server setup and opens a browser tab for the Apify OAuth flow. -1. Review the permissions and click **Allow access**. +1. Review the permissions and select **Allow access**. 1. Back in Codex, the `apify` MCP server connects and is ready to use. diff --git a/sources/platform/integrations/ai/openai/index.mdx b/sources/platform/integrations/ai/openai/index.mdx index 3416de42fa..d4d149ee0a 100644 --- a/sources/platform/integrations/ai/openai/index.mdx +++ b/sources/platform/integrations/ai/openai/index.mdx @@ -1,6 +1,6 @@ --- title: OpenAI -description: Use Apify Actors with OpenAI - call scrapers and crawlers from ChatGPT, the OpenAI Agents SDK, and OpenAI Assistants to feed models live web data. +description: Use Apify Actors with OpenAI - call scrapers and crawlers from ChatGPT, Codex, the OpenAI Agents SDK, and OpenAI Assistants to feed models live web data. sidebar_label: OpenAI slug: /integrations/openai --- @@ -8,7 +8,7 @@ slug: /integrations/openai import Card from '@site/src/components/Card'; import CardGrid from '@site/src/components/CardGrid'; -Apify integrates with [OpenAI](https://openai.com) in three places: ChatGPT (via the Apify MCP server), the Agents SDK, and the legacy Assistants API. Each gives OpenAI models a way to call Apify Actors as tools and read their results. +Apify integrates with [OpenAI](https://openai.com) across ChatGPT (via the Apify MCP server), Codex (in the ChatGPT desktop app and the CLI), the Agents SDK, and the legacy Assistants API. Each gives OpenAI models a way to call Apify Actors as tools and read their results. ## What you can build @@ -20,6 +20,22 @@ Apify integrates with [OpenAI](https://openai.com) in three places: ChatGPT (via imageUrl="/img/platform/integrations/openai.svg" smallImage /> + + Date: Thu, 23 Jul 2026 15:39:31 +0200 Subject: [PATCH 2/3] docs: keep /integrations/codex-app slug, drop redirects Revert the desktop page slug to /integrations/codex-app (filename back to codex-app.md) and remove the nginx redirects - the slugs are unchanged so no redirect is needed. Co-Authored-By: Claude Opus 4.8 (1M context) --- nginx.conf | 4 ---- .../integrations/ai/openai/{codex-desktop.md => codex-app.md} | 2 +- sources/platform/integrations/ai/openai/codex-cli.md | 2 +- sources/platform/integrations/ai/openai/index.mdx | 2 +- 4 files changed, 3 insertions(+), 7 deletions(-) rename sources/platform/integrations/ai/openai/{codex-desktop.md => codex-app.md} (99%) diff --git a/nginx.conf b/nginx.conf index 2b69094bc9..08dfe741fb 100644 --- a/nginx.conf +++ b/nginx.conf @@ -788,10 +788,6 @@ server { # Misc rewrite ^/platform/integrations/llama$ /platform/integrations/llama-index permanent; - # Codex docs consolidated under the OpenAI hub (Codex is an OpenAI product) - rewrite ^/integrations/codex$ /integrations/openai permanent; - rewrite ^/integrations/codex-app$ /integrations/codex-desktop permanent; - # === IA v3 flip: drop the /platform prefix === # Structural moves first (these MUST precede the blanket catch-all, because a # naive /platform/X -> /X strip would 404 for sections that relocated). diff --git a/sources/platform/integrations/ai/openai/codex-desktop.md b/sources/platform/integrations/ai/openai/codex-app.md similarity index 99% rename from sources/platform/integrations/ai/openai/codex-desktop.md rename to sources/platform/integrations/ai/openai/codex-app.md index 54f40713ce..ba6b571d03 100644 --- a/sources/platform/integrations/ai/openai/codex-desktop.md +++ b/sources/platform/integrations/ai/openai/codex-app.md @@ -2,7 +2,7 @@ title: Codex in the ChatGPT desktop app sidebar_label: Codex (desktop app) description: Learn how to install the Apify plugin for Codex to discover, run, and build Actors with the Apify MCP server and bundled skills for common workflows. -slug: /integrations/codex-desktop +slug: /integrations/codex-app --- import ThirdPartyDisclaimer from '@site/sources/_partials/_third-party-integration.mdx'; diff --git a/sources/platform/integrations/ai/openai/codex-cli.md b/sources/platform/integrations/ai/openai/codex-cli.md index b665f452c6..2a73465a47 100644 --- a/sources/platform/integrations/ai/openai/codex-cli.md +++ b/sources/platform/integrations/ai/openai/codex-cli.md @@ -14,7 +14,7 @@ The [Apify plugin for Codex](https://github.com/apify/apify-codex-plugin) connec - The [Apify MCP server](/integrations/mcp) for searching Apify Store, running Actors, and retrieving datasets through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro). - Five built-in skills for common workflows (see [Bundled skills](#bundled-skills) below). -This guide covers installation in the Codex CLI. To use Codex in the ChatGPT desktop app instead, see the [Codex in the ChatGPT desktop app](/integrations/codex-desktop) guide. +This guide covers installation in the Codex CLI. To use Codex in the ChatGPT desktop app instead, see the [Codex in the ChatGPT desktop app](/integrations/codex-app) guide. diff --git a/sources/platform/integrations/ai/openai/index.mdx b/sources/platform/integrations/ai/openai/index.mdx index d4d149ee0a..173ee885a8 100644 --- a/sources/platform/integrations/ai/openai/index.mdx +++ b/sources/platform/integrations/ai/openai/index.mdx @@ -23,7 +23,7 @@ Apify integrates with [OpenAI](https://openai.com) across ChatGPT (via the Apify Date: Thu, 23 Jul 2026 16:07:01 +0200 Subject: [PATCH 3/3] docs: add AI assistants section to the AI integrations index Group chat and coding assistants (ChatGPT, Claude Desktop, Claude Code CLI, Codex desktop + CLI, Cursor) into a dedicated section on the AI index, and stage cards for the in-review Copilot/Grok/OpenCode pages as comments so they activate when those PRs merge. Trim "By provider" to the OpenAI and Claude hub links. Co-Authored-By: Claude Opus 4.8 (1M context) --- sources/platform/integrations/ai/index.mdx | 73 ++++++++++++++++++++-- 1 file changed, 67 insertions(+), 6 deletions(-) diff --git a/sources/platform/integrations/ai/index.mdx b/sources/platform/integrations/ai/index.mdx index 8f6e6a8c7c..449b0e4415 100644 --- a/sources/platform/integrations/ai/index.mdx +++ b/sources/platform/integrations/ai/index.mdx @@ -88,9 +88,47 @@ Plug Apify Actors into the AI stack - chat clients like Claude and ChatGPT via t imageUrl="/img/platform/integrations/emoji-x402.svg" smallImage /> + + +## AI assistants + +Chat and coding assistants you connect to Apify through the Apify MCP server or a plugin. + + + + + + + {/* Prepared for release - uncomment each card when its page merges: + GitHub Copilot (#2699), Grok Build (#2700), OpenCode (#2692). + + + + */} ## By provider -The [Claude hub](/integrations/claude) covers Apify integrations across Claude Desktop and the Claude Code CLI on one page. - -The [OpenAI hub](/integrations/openai) covers Apify integrations across ChatGPT, Codex (in the ChatGPT desktop app and the CLI), the OpenAI Agents SDK, and OpenAI Assistants on one page. - -For Google ADK, see the [Google ADK](/integrations/google-adk) page. The full list of AI integrations lives in the sidebar. +See everything for a provider on one page: the [OpenAI hub](/integrations/openai) (ChatGPT, Codex, Agents SDK) and the [Claude hub](/integrations/claude) (Claude Desktop, Claude Code CLI).