Docs

Connect ChatGPT

Connect the ChatGPT desktop app with one connection link, or add your site to ChatGPT on the web as a connector.

On this page

ChatGPT connects to your site in two ways. In the ChatGPT desktop app you add it as an MCP server, most easily with a connection link you paste once. On chatgpt.com you add it as a custom connector in developer mode and sign in to your site.

The ChatGPT instructions in Uncoder: the Desktop app · link method with a Create connection link button and its steps, next to the Desktop app · sign in and ChatGPT on the web tabs
Connect a client → ChatGPT

Before you start

  • You need a WordPress account that may use AI. By default only administrators can. See Server settings.
  • Your site must use HTTPS for a connection link, and be public for ChatGPT on the web, which connects from OpenAI's servers. Signing in from the desktop app also works with a site that runs on your own machine.

ChatGPT desktop app

The easiest way is a connection link: one address that already carries its own key. You paste it into ChatGPT and you are done.

  1. Go to Uncoder → AI & MCP → Connect a client, choose ChatGPT, and on Desktop app · link click Create connection link. Click Copy. The link is shown only once.

  2. Add the server in ChatGPT

    In the ChatGPT desktop app, open Settings → Plugins → MCPs and click Add → Add MCP server.

  3. Enter a short Name such as uncoder, choose Streamable HTTP as the Type and paste the link into URL. Leave every other field empty. Click Save.

  4. Try it

    In a chat, ask something like: "List my pages and write an SEO title and meta description for each one."

The link can read, create and edit pages, posts, media and the design, but not change site settings. Keep it private, like a password, and revoke it under API keys if it was shared by mistake. See Connection links.

Prefer not to keep a key in ChatGPT? Choose Desktop app · sign in: add the server with the plain Server URL (no link), leave Bearer token env var and the header fields empty, click Save, and sign in when ChatGPT asks (or run codex mcp login uncoder in a terminal). Your browser opens your site: log in, check the permissions and click Approve.

Bearer token env var takes the name of an environment variable, not a key. A key pasted there is ignored, and ChatGPT connects without credentials, so every request fails with "Authentication required". Leave it empty and use a connection link or sign in.

ChatGPT on the web

  1. Copy the Server URL

    Go to Uncoder → AI & MCP. Click Copy next to Server URL.

  2. Turn on developer mode

    On chatgpt.com, open Settings → Apps & Connectors → Advanced settings and turn on Developer mode. Your plan must include developer mode.

  3. Create the connector

    Back in Apps & Connectors, click Create. Enter your site's name, choose OAuth as the authentication and paste the MCP server URL.

  4. Approve access on your site

    Confirm that you trust the connector and click Create. Your site opens a sign-in window: log in, check the permissions and click Approve.

  5. Use it in a chat

    In a new chat, open the + menu, choose Developer mode and enable your site's connector.

The permissions screen is the same for every app that signs in. Read is always included, Content and Design are checked, and Site is unchecked unless you tick it. See The approval screen.

After you approve, ChatGPT appears under AI & MCP → Connected apps.

Confirmations in ChatGPT

Tools that change your site ask for your confirmation in ChatGPT before they run. Read what ChatGPT is about to do, then allow or deny it. Uncoder marks each tool as read-only or as making changes, so ChatGPT knows which ones need a confirmation.

This is separate from Uncoder's own safety net: every change is still logged in Activity, and changes to pages, templates and the Design System can be undone there.

If it does not connect

  • "Authentication required" in the desktop app: the server was saved with something in Bearer token env var. Edit the server, clear that field, save and sign in again.
  • "This site is not reachable from the internet" on the ChatGPT on the web tab means Uncoder detected a local address. chatgpt.com cannot reach it: use the desktop app, put the site online, or use a tunnel service for testing.
  • The sign-in window shows "Can't connect this application": read the message under it. The most common one is that your account's role is not allowed to use AI. An administrator can allow it in Server settings.
  • Dynamic client registration must be on in Server settings → Connections. It lets new connectors register themselves. It is on by default.

More fixes: Troubleshooting.