Troubleshooting Fluent Setup

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

Fluent's plugin page does not show Install plugin

Sign in to ChatGPT, then reopen Fluent's plugin page. If a workspace administrator manages your ChatGPT account, plugin installs may need to be allowed for your workspace. If the button still does not appear, 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

Continue on your phone. Fluent installs from its ChatGPT plugin page on mobile and computer alike; the guided steps stay at Fluent's ChatGPT + Codex setup.

My Fluent 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