Troubleshooting Fluent Setup

Return to the last checkpoint you completed, then use the matching recovery below.

ChatGPT does not show New Plugin

Open Fluent's New Plugin form on a computer and sign in to the ChatGPT account you use for Codex. If your workspace has disabled personal plugin creation, ask its administrator to allow it. If the form still does not open, email [email protected] with the account and step where setup stopped.

Fluent sign-in opened, but OAuth did not return to my AI app

Open the connection from your AI app again. Complete sign-in and approval in the same browser where you started setup.

The plugin is installed but Fluent is not active

1. Open ChatGPT Plugins.
2. Open Installed → Fluent.
3. Choose Try in chat, or type @Fluent in a new conversation.
4. Ask: @Fluent Check my Fluent account and tell me which areas are ready.

Fluent works in ChatGPT but Codex looks stale

Start a new Codex task and type @Fluent. If Fluent still shows old tools, restart Codex so it reloads the shared plugin library.

Claude shows Fluent as connected but it is not available in chat

Open Claude Settings → Connectors, open Fluent, and reconnect it. Start a new conversation after approval.

My email sign-in link opened the wrong browser

Return to the browser where setup began, request a fresh sign-in link, and open that link in the same browser. Sign-in links expire after 15 minutes.

I started on mobile

Open Fluent's ChatGPT + Codex setup, then use Share setup link, Email these steps, or Copy setup link. Open that exact page on a computer and continue there.

My managed account needs attention

Open Manage account to see the current setup milestone. Email [email protected] with your account email, AI app, and the time the problem occurred if the account page cannot recover the connection.

I run Fluent myself

Confirm the runtime first:

curl http://127.0.0.1:8788/health

Then regenerate the client configuration and reconnect the client:

npm run scaffold:mcp -- --client codex --track oss --base-url http://127.0.0.1:8788

Swap codex for your client. ChatGPT connects to a public HTTPS MCP address, so expose a secured HTTPS endpoint before adding a self-hosted server there. Codex CLI and local desktop clients can use the local address directly.

Still stuck

Email [email protected] with:

• your account email
• the AI app you chose
• the setup step you reached
• the exact message on screen
• roughly when it happened