Codex CLI

Use the shared plugin

For the normal setup, use Connecting to ChatGPT + Codex. Install the official Fluent plugin once from its ChatGPT directory page, then start a new Codex task with @Fluent.

This page is for developers who specifically want Codex CLI MCP commands, generated configuration, or the repo-local Fluent bundle.

Codex CLI

Add the Fluent MCP server and authenticate:

codex mcp add fluent --url https://mcp.meetfluent.app/mcp
codex mcp login fluent

Complete Fluent sign-in in the browser, then check the connection with codex mcp list.

You still work in Codex directly. Fluent is the MCP server Codex uses to read and update your closet.

Advanced: scaffold generator

Use this path only if you have this docs repository checked out. It writes the same hosted-endpoint configuration:

npm run scaffold:mcp -- --client codex --track cloud

Write directly to the plugin directory:

npm run scaffold:mcp -- --client codex --track cloud --out plugins/fluent/.mcp.json

Repo-local plugin structure

The Fluent bundle for repo-local Codex installation lives at plugins/fluent/ and includes these key assets:

File	Purpose
.codex-plugin/plugin.json	Plugin metadata
.mcp.json	Hosted-endpoint MCP config
skills/	Fluent skill guidance for Codex

Install the plugin from the plugins/fluent/ directory, not from .codex-plugin/.

Verify the connection

Ask Codex:

What can Fluent help me with?

Then try:

Show my Fluent closet.

Troubleshooting

See Fix a problem for the shared recovery steps.

Tools not appearing

• Reconnect the MCP server in Codex
• Check that your .mcp.json points at https://mcp.meetfluent.app/mcp

Stale tools after an update

1. Reconnect the MCP server
2. Re-authorize if prompted
3. Remove stale credentials for the old registration if Codex keeps surfacing the previous tool set