Deploy the Glean plug-in in Codex

Prepare your Glean environment for Codex, then validate the plug-in with a pilot user before sharing the setup instructions with your organization.

The documented Codex setup is per user. Administrators configure and govern Glean access, but each user runs the Codex marketplace and MCP commands on their device.

Prerequisites

Before you begin:

• Complete the Glean plug-in prerequisites
• Confirm that pilot users have a Glean account and access to the tools and Skills they need
• Make sure the Glean MCP server is available to the intended users
• Install Codex with plug-in support on the pilot user's device

Prepare Glean for Codex

1. Enable the Glean OAuth authorization server.
2. Configure Dynamic Client Registration. If you allow only approved applications, include Glean CLI.
3. Enable the Glean MCP server and make it available to the intended users. See Enable Glean MCP servers.
4. Configure access to the tools and Skills you want users to invoke. See Manage Glean plug-in access and security.

Validate with a pilot user

Run the complete setup with a pilot user before rolling it out more broadly:

1. Open the Glean MCP configurator and copy your organization's server address and server name.

2. Add the Glean marketplace and install the plug-in:

   codex plugin marketplace add gleanwork/codex-plugins
   codex plugin add glean@glean-codex-plugins

3. Connect and authenticate the Glean MCP server. Substitute the server address and name from the configurator:

   codex mcp add glean --url <server-url>/mcp/<server-name>
   codex mcp login glean

4. Complete the browser-based Glean authentication flow.

5. Start a new Codex task so the bundled Glean Skills and MCP tools are available.

6. Ask Codex to search for content the pilot user can access in Glean.

7. Confirm that:

   • The search succeeds and respects the pilot user's Glean permissions
   • The expected tools and Skills are available
   • Codex asks the user for approval before a write tool runs

For current Codex-specific requirements and commands, see Glean Plugin for Codex on the Developer Portal.

Roll out to users

Share Set up the Glean plug-in in Codex with your users. Each user must install the plug-in, connect the Glean MCP server, and authenticate with their own Glean account.

See also

• Manage Glean plug-in access and security
• Troubleshoot Glean plug-in deployment
• Use the Glean plug-in