Skip to content

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 hello@meetfluent.app 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.

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 hello@meetfluent.app 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:

bash
curl http://127.0.0.1:8788/health

Then regenerate the client configuration and reconnect the client:

bash
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.

I am not sure a change saved ​

Ask your assistant to reopen the item or list before repeating the change. A failed refresh does not necessarily mean the save failed. Check the Fluent account and, for meals or groceries, the week you selected.

If you asked to save a meal plan and grocery list, check each separately. Keep whichever result saved successfully and ask for help with the missing part.

I cannot edit a detail I can see ​

Available controls vary by AI app, and some sourced product details are not directly editable. Ask your assistant whether it can make the specific correction. If it cannot, keep the original record and describe the problem when contacting support.

My grocery list looks wrong ​

Ask for the saved list for a specific week and confirm you are using the right Fluent account. If the latest list cannot be loaded, avoid replacing it from memory. Try opening it again before making changes.

Still stuck ​

Email hello@meetfluent.app with:

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

Use Fluent online, or run it yourself with the open-source runtime. Fluent is free.