This article shows you how to install the AI Toolkit and connect Fulcrum MCP in Codex. Codex works with personal ChatGPT plans, including Plus, so it's a good option if you don't have a ChatGPT Business or Enterprise workspace.
If you have a ChatGPT Business or Enterprise workspace, see Setting up Fulcrum MCP and the AI Toolkit in ChatGPT instead.
Prerequisites
Codex installed on your computer. Fulcrum doesn't support Codex installation, so contact your IT team if you need help installing it.
An API token and your region's endpoint. See Getting your API token and endpoint for Fulcrum MCP.
Installing the AI Toolkit
Installing the AI Toolkit in Codex takes two steps: first add the AI Toolkit source, then add the plugin.
In your terminal, enter the following command to add the AI Toolkit source:
codex plugin marketplace add fulcrumapp/fulcrum-ai-toolkit
2. Enter the following command to add the plugin:
codex plugin add fulcrum-ai-toolkit@fulcrum-ai-toolkit
Expected outcome: The AI Toolkit appears in your list of installed plugins in Codex.
Saving your API token
Codex reads your API token from an environment variable on your computer rather than from the connection command. Enter the command for your operating system, replacing YOUR_FULCRUM_API_TOKEN with your API token.
Mac or Linux:
export FULCRUM_MCP_TOKEN=YOUR_FULCRUM_API_TOKEN
Windows (PowerShell):
$env:FULCRUM_MCP_TOKEN="YOUR_FULCRUM_API_TOKEN"
The command above only works until you close the terminal window. To save the token permanently, add the command to your shell profile (for example, ~/.zshrc on Mac), or set FULCRUM_MCP_TOKEN as a user environment variable in Windows.
Connecting Fulcrum MCP
Run these commands in the same terminal window where you saved your API token.
Enter the following command. If your organization isn't hosted in the United States, replace the URL with your region's endpoint.
codex mcp add fulcrum-app --url https://mcp.fulcrumapp.com/ --bearer-token-env-var FULCRUM_MCP_TOKEN
To confirm the connection, enter:
codex mcp list
Expected outcome: fulcrum-app appears in the list.
Testing the connection
Confirm that Codex can reach your organization.
Start Codex.
Enter: "How many apps are in my Fulcrum organization?"
Expected outcome: Codex uses Fulcrum MCP to look up your apps and answers with the number.
Notes
Don't include the word "Bearer" when you save your token. Codex adds it automatically.
Codex can often complete this setup for you. In the ChatGPT desktop app, switch to Codex and ask it to install the AI Toolkit and Fulcrum MCP from https://github.com/fulcrumapp/fulcrum-ai-toolkit. You still need to provide your API token.
If Codex can't connect, see Troubleshooting Fulcrum MCP and the AI Toolkit.