Skip to main content
Fygment
<- Docs home

Guides

Alpha

Connect OpenAI Codex to Fygment

Use the Fygment CLI to connect Codex to one workspace through a local authenticated MCP proxy and companion Skill.

Audience
OpenAI Codex users who want Fygment search and governed Skills in local coding sessions.
Updated
2026-08-22

The guided CLI path signs you in, previews the local Codex registry change, and keeps workspace authentication in the Fygment CLI rather than a config file.

What this connection does

MCP (Model Context Protocol) is a standard way to let an AI client use Fygment workspace tools.

The default connection is a local authenticated proxy that forwards Codex requests to the workspace-scoped Fygment endpoint after you sign in with the CLI.

Recommended setup

Run this in a terminal, replacing the placeholder with the workspace slug you want to connect. It opens Fygment sign-in when needed and asks before it writes local configuration.

npx fygment setup --workspace=<workspace-slug> --target=codexAlpha

Sign in, register the local connector through Codex, and install the Fygment companion Skill.

Finish and check

  1. 1

    Review the preview

    Confirm the workspace before accepting the Fygment stdio connection in the Codex MCP registry.

  2. 2

    Restart Codex

    Open a new Codex session so it loads the connection and companion Skill.

  3. 3

    Use a real search

    Ask Codex to search Fygment for a repeatable workflow. If it fails, run `fygment doctor` before removing registry entries.

Manual command

Use this only when guided setup is unavailable

After `fygment auth login --workspace=<workspace-slug>` completes, the local connector command is `codex mcp add fygment -- npx -y fygment mcp proxy`. Guided setup is preferred because it selects the workspace, previews changes, and installs the companion Skill.

Related docs

  • Set up Fygment MCP

    MCP setup gives AI clients access to workspace-scoped Fygment tools. Hosted clients use OAuth; local clients use guided setup and a local authenticated proxy where needed.

  • Connect Claude Code to Fygment

    The guided CLI path signs you in, previews the local change, and registers a local Fygment connector through the installed Claude CLI.

  • Install Skills in Codex

    Codex is one of the first writable install targets. Use the guided CLI path so Fygment can preview config changes and track install state.

  • Troubleshooting

    Start with safe, non-sensitive checks. Fygment support reports should capture bounded diagnostics, not package bodies, secrets, raw prompts, or local paths.