Skip to content

docs: move Codex under the OpenAI hub and add an AI assistants index section #2803

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.

Sign up for GitHub

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
marcel-rbro wants to merge 3 commits into
base: master
Choose a base branch
from
Open

docs: move Codex under the OpenAI hub and add an AI assistants index section #2803

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
98974fc
docs: consolidate Codex docs under the OpenAI hub
marcel-rbro Jul 23, 2026
ce64237
docs: keep /integrations/codex-app slug, drop redirects
marcel-rbro Jul 23, 2026
b2f6082
docs: add AI assistants section to the AI integrations index
marcel-rbro Jul 23, 2026
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
1 change: 0 additions & 1 deletion sources/platform/integrations/ai/codex/_category_.yml
View file
Open in desktop

This file was deleted.

32 changes: 0 additions & 32 deletions sources/platform/integrations/ai/codex/index.mdx
View file
Open in desktop

This file was deleted.

77 changes: 69 additions & 8 deletions sources/platform/integrations/ai/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -88,10 +88,48 @@ Plug Apify Actors into the AI stack - chat clients like Claude and ChatGPT via t
imageUrl="/img/platform/integrations/emoji-x402.svg"
smallImage
/>
</CardGrid>

## AI assistants

Chat and coding assistants you connect to Apify through the Apify MCP server or a plugin.

<CardGrid>
<Card
title="ChatGPT"
desc="Use Apify as an MCP server in ChatGPT to run Actors and pull live web data into the conversation."
to="/integrations/chatgpt"
imageUrl="/img/platform/integrations/openai.svg"
imageUrlDarkTheme="/img/platform/integrations/openai-white.svg"
smallImage
/>
<Card
title="Claude Desktop"
desc="Connect Apify to Claude Desktop through the MCP server to run Actors from your chats."
to="/integrations/claude-desktop"
imageUrl="/img/platform/integrations/anthropic.svg"
imageUrlDarkTheme="/img/platform/integrations/anthropic-white.svg"
smallImage
/>
<Card
title="Claude Code CLI"
desc="Use Apify Actors from the Claude Code CLI through the Apify MCP server."
to="/integrations/claude-code-cli"
imageUrl="/img/platform/integrations/claude-code.svg"
smallImage
/>
<Card
title="Codex"
desc="Install the Apify plugin in Codex to discover, run, and build Actors from the Codex app."
to="/integrations/codex"
title="Codex (desktop app)"
desc="Install the Apify plugin for Codex in the ChatGPT desktop app to discover, run, and build Actors."
to="/integrations/codex-app"
imageUrl="/img/platform/integrations/codex.svg"
imageUrlDarkTheme="/img/platform/integrations/codex-white.svg"
smallImage
/>
<Card
title="Codex CLI"
desc="Install the Apify plugin for Codex in your terminal to discover, run, and build Actors."
to="/integrations/codex-cli"
imageUrl="/img/platform/integrations/codex.svg"
imageUrlDarkTheme="/img/platform/integrations/codex-white.svg"
smallImage
Expand All @@ -104,12 +142,35 @@ Plug Apify Actors into the AI stack - chat clients like Claude and ChatGPT via t
imageUrlDarkTheme="/img/platform/integrations/cursor-white.svg"
smallImage
/>
{/* Prepared for release - uncomment each card when its page merges:
GitHub Copilot (#2699), Grok Build (#2700), OpenCode (#2692).
<Card
title="GitHub Copilot"
desc="Install the Apify plugin in GitHub Copilot to discover, run, and build Actors in VS Code."
to="/integrations/github-copilot"
imageUrl="/img/platform/integrations/github-copilot.svg"
imageUrlDarkTheme="/img/platform/integrations/github-copilot-white.svg"
smallImage
/>
<Card
title="Grok Build"
desc="Install the Apify plugin in Grok Build to discover, run, and build Actors from the terminal."
to="/integrations/grok-build"
imageUrl="/img/platform/integrations/grok-light.svg"
imageUrlDarkTheme="/img/platform/integrations/grok.svg"
smallImage
/>
<Card
title="OpenCode"
desc="Install the Apify plugin in OpenCode to discover, run, and build Actors from the coding agent."
to="/integrations/opencode"
imageUrl="/img/platform/integrations/opencode.svg"
imageUrlDarkTheme="/img/platform/integrations/opencode-white.svg"
smallImage
/>
*/}
</CardGrid>

## 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, 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).
8 changes: 4 additions & 4 deletions ...atform/integrations/ai/codex/codex-app.md → ...tform/integrations/ai/openai/codex-app.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
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
---
Expand All @@ -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.

<ThirdPartyDisclaimer />

Expand Down Expand Up @@ -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.

Expand Down
4 changes: 2 additions & 2 deletions ...atform/integrations/ai/codex/codex-cli.md → ...tform/integrations/ai/openai/codex-cli.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
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.

<ThirdPartyDisclaimer />

Expand Down Expand Up @@ -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.

Expand Down
20 changes: 18 additions & 2 deletions sources/platform/integrations/ai/openai/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
---
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
---

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

Expand All @@ -20,6 +20,22 @@ Apify integrates with [OpenAI](https://openai.com) in three places: ChatGPT (via
imageUrl="/img/platform/integrations/openai.svg"
smallImage
/>
<Card
title="Codex (desktop app)"
desc="Install the Apify plugin for Codex in the ChatGPT desktop app to discover, run, and build Actors through the Apify MCP server."
to="/integrations/codex-app"
imageUrl="/img/platform/integrations/codex.svg"
imageUrlDarkTheme="/img/platform/integrations/codex-white.svg"
smallImage
/>
<Card
title="Codex CLI"
desc="Install the Apify plugin for Codex in your terminal to discover, run, and build Actors through the Apify MCP server."
to="/integrations/codex-cli"
imageUrl="/img/platform/integrations/codex.svg"
imageUrlDarkTheme="/img/platform/integrations/codex-white.svg"
smallImage
/>
<Card
title="OpenAI Agents SDK"
desc="Build agents on top of the OpenAI Agents SDK that call Apify Actors as tools - scrapers, crawlers, and integrations."
Expand Down
6 changes: 3 additions & 3 deletions sources/platform/integrations/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -124,9 +124,9 @@ Plug Apify Actors into the AI stack - chat clients like Claude and ChatGPT via t
smallImage
/>
<Card
title="Codex"
desc="Install the Apify plugin in Codex to discover, run, and build Actors from the Codex app."
to="/integrations/codex"
title="Codex CLI"
desc="Install the Apify plugin for Codex in your terminal to discover, run, and build Actors through the Apify MCP server."
to="/integrations/codex-cli"
imageUrl="/img/platform/integrations/codex.svg"
imageUrlDarkTheme="/img/platform/integrations/codex-white.svg"
smallImage
Expand Down
Loading