ChatGPT Web / App Connection

Official docs confirmed

OpenAI has consolidated the older "connectors" terminology into "apps". The current user-facing flow centers on ChatGPT Settings > Apps and the app directory.

Last verified: 2026-04-17

Screenshots are replaced automatically when you update the matching files under frontend/public/docs/apps/chatgpt.

Before you start

Your Codebase workspace and the target app flow should already be ready to connect.
You must be signed in to ChatGPT, and Apps must be available for your current plan or workspace.
On workspace plans, admin settings can affect whether custom apps are available.

Connection steps

Open the Apps entry point in ChatGPT

Start from Settings > Apps or the app directory, following OpenAI’s official help docs. The exact UI labels can vary by plan and workspace settings.

Screenshot Slot

Replace this file with your screenshot

Put the final screenshot in the exact path below. The docs page will start rendering it automatically without any code changes.

frontend/public/docs/apps/chatgpt/01-entry.png

Replace this slot with a screenshot of where Apps appears inside ChatGPT.

Find the Codebase app or custom app flow

Look for Codebase directly in the app directory. If a custom app flow is available, start the connection from there instead.

Screenshot Slot

Replace this file with your screenshot

Put the final screenshot in the exact path below. The docs page will start rendering it automatically without any code changes.

frontend/public/docs/apps/chatgpt/02-open-connect.png

Replace this slot with a screenshot of the connect button or custom app add flow.

Finish sign-in and authorization

If ChatGPT or Codebase shows a sign-in or permission prompt, approve it after reviewing the requested access. On first connect, double-check any data-sharing or usage permissions.

Screenshot Slot

Replace this file with your screenshot

Put the final screenshot in the exact path below. The docs page will start rendering it automatically without any code changes.

frontend/public/docs/apps/chatgpt/03-auth.png

Replace this slot with the sign-in or authorization screen.

Confirm that the app can be invoked in chat

According to OpenAI’s docs, apps can be used via @ mention or the + menu in the composer. After connecting, call Codebase from a chat and run a quick test.

Screenshot Slot

Replace this file with your screenshot

Put the final screenshot in the exact path below. The docs page will start rendering it automatically without any code changes.

frontend/public/docs/apps/chatgpt/04-complete.png

Replace this slot with the post-connection state where Codebase is available in chat.

Test checklist

Confirm that Codebase appears as connected in Settings > Apps.
Confirm that Codebase can be selected via @ mention or the + menu.
Run a short test prompt and verify that the app responds.

Troubleshooting

If Apps does not appear, first check your plan, regional rollout status, and any workspace policy restrictions.
If custom apps are missing, confirm that the workspace admin allows Drafts or custom apps.
If the app still does not invoke after authorization, disconnect it, reconnect it, and open a fresh chat.

If you need to review connection state or permissions again, also check the Connected apps page.

Official sources

Apps in ChatGPT

User-facing app connection flow, including Settings > Apps, the app directory, and @ mention usage.

https://help.openai.com/en/articles/11487775-apps-in-chatgpt

Introducing apps in ChatGPT

Background on OpenAI’s apps terminology and the Apps SDK platform.

https://openai.com/index/introducing-apps-in-chatgpt/