Connect ChatGPT with OAuth

Before you begin#

A deployed HTTPS workspace with its owner account, current database migrations and MCP_TOKEN_PEPPER configured. Your ChatGPT account or workspace must allow custom plugins and the actions you want to use; availability and admin controls vary. Complete connection setup in ChatGPT on the web.

Steps#

1. 1

   In ChatGPT on the web, open Plugins → Add → Create MCP App, or reuse an existing OwnPost MCP app. If these controls are unavailable, check the official instructions, developer-mode availability and your workspace's administrator settings.

2. 2

   Enter your private workspace's HTTPS URL followed by /api/mcp as the MCP server URL and choose OAuth. Use your deployed workspace origin, not the public OwnPost documentation website.

3. 3

   Use automatic OAuth discovery and public-client registration when offered. For manual setup, set the client ID to ownpost-chatgpt, leave the client secret empty, use token endpoint authentication none and scope mcp:full.

4. 4

   If endpoints are requested, use your workspace origin followed by /oauth/authorize for authorization and /oauth/token for tokens. The resource is the full /api/mcp URL. The predefined ownpost-chatgpt client uses exactly https://chatgpt.com/connector_platform_oauth_redirect; dynamically registered clients use their own registered redirects. Clients must support S256 PKCE.

5. 5

   Scan or connect the server. Sign in to OwnPost with your owner password and authenticator, review the access requested, and choose Connect ChatGPT. Finish creating the connection in ChatGPT.

6. 6

   Select the connection in a new chat and ask it to read today's workspace. In OwnPost, open Settings → Connections → AI writing → AI assistant. Select another client, such as Codex, to view all saved connections and find the ChatGPT OAuth entry. A successful read verifies the connection. API publishing still requires its separate publishing grant and the applicable approval.

7. 7

   For the OwnPost skills in ChatGPT Work, copy the MCP app ID or its full app page URL. Open OwnPost Settings → Plugins, choose ChatGPT and paste it into the download form. Download the ChatGPT ZIP, then use Upload plugin archive for a first installation. The generated package references your registered app and includes all 15 OwnPost skills. Use the plugin guide when updating an existing installation.

8. 8

   For mobile access, sign in to the same ChatGPT account and workspace and select the installed plugin when available. It must support mobile and not be marked Desktop only. A plugin installed only in local Codex, Claude Code or Cursor does not sync into ChatGPT.

9. 9

   To stop access, disconnect that ChatGPT OAuth entry. Each new consent creates its own entry. Connections expire after 30 days and must be reconnected; remove old entries you no longer use.

MCP server / resource: https://YOUR-WORKSPACE/api/mcp
Authentication: OAuth (automatic discovery and registration supported)
Manual fallback client ID: ownpost-chatgpt
Client secret: leave empty
Token endpoint auth method: none
Scope: mcp:full
Authorization URL: https://YOUR-WORKSPACE/oauth/authorize
Token URL: https://YOUR-WORKSPACE/oauth/token
Predefined client callback: https://chatgpt.com/connector_platform_oauth_redirect

Add the skills to ChatGPT Work and mobile#

The OAuth connection gives ChatGPT access to your OwnPost tools. Copy its MCP app ID or full app page URL into Settings → Plugins → ChatGPT in OwnPost. Download the generated ZIP and choose Upload plugin archive in ChatGPT for a first installation, then select the installed plugin in a new Work chat. Follow the plugin guide to update an existing installation while keeping its identity.

Use that account-installed plugin on supported ChatGPT mobile surfaces with the same account and workspace. Check that it is not marked Desktop only. Copying the folder into Codex, Claude Code or Cursor is a local installation and does not make it available in ChatGPT on the web or phone.

Example request#

After OAuth consent, select the connection in a new chat and request a read of your workspace. Check the matching ChatGPT OAuth entry in OwnPost so you know where to revoke that consent later. Install the hosted OwnPost plugin separately when you want its skills in Work and supported mobile chats.

Use my connected OwnPost app to read today’s workspace. Summarize the posts and routine items that need my attention.

Check the result#

ChatGPT can read your workspace, and you can identify and revoke its connection in Settings. If you also installed the hosted plugin, its OwnPost skills are available in the supported ChatGPT surfaces for that account and workspace.

Keep going#