Skip to main content

Connect Codex to Pressidium MCP

Connect Codex CLI or the Codex IDE extension to the Pressidium Dashboard MCP server. Once connected, Codex can use the Pressidium tools available to your Dashboard account.

A
Written by Admin account

This guide covers the Codex setup for Get started with Pressidium MCP.

Read the main guide first for beta requirements, security considerations, supported operations, and general troubleshooting.

Then follow the steps below to connect Codex.

1. Configure the Pressidium MCP server

Create or open ~/.codex/config.toml. Create the .codex directory if necessary.

Add the following configuration while preserving your existing settings. If an mcp_servers.pressidium table already exists, edit it instead of adding another one.

[mcp_servers.pressidium]
url = "https://mcp-dashboard.pressidium.com/dashboard"
enabled = true
tool_timeout_sec = 180

[mcp_servers.pressidium.env_http_headers]
"X-Pressidium-Email" = "PRESSIDIUM_EMAIL"
"X-Pressidium-Password" = "PRESSIDIUM_PASSWORD"

The values in env_http_headers are environment variable names, not ${...} expressions.

Codex reads the actual credential values from the environment when it connects.

The 180-second tool timeout gives operations room for the server's wait period of up to 120 seconds plus communication overhead. A longer client timeout does not guarantee that a background operation will finish during that period.

Do not run an MCP OAuth login for this connection. The current beta authenticates using the Dashboard email and password headers shown above.

2. Set your Dashboard credentials

The setup uses two local environment variables:

  • PRESSIDIUM_EMAIL

  • PRESSIDIUM_PASSWORD

These contain your Pressidium Dashboard credentials. They are not separate credentials issued by Pressidium.

macOS, Linux, or WSL

Open a terminal, run bash, then run:

read -r -p "Pressidium Dashboard email: " PRESSIDIUM_EMAIL read -r -s -p "Pressidium Dashboard password: " PRESSIDIUM_PASSWORD printf '\n' export PRESSIDIUM_EMAIL PRESSIDIUM_PASSWORD

The password is hidden while you type and is not entered as a shell command.

Windows PowerShell

  1. Create or open ~/.codex/config.toml. Create the .codex directory if necessary.

  2. Add this configuration, preserving your existing settings. Edit an existing mcp_servers.pressidium table instead of adding it twice.
    ​

    [mcp_servers.pressidium]
    url = "https://mcp-dashboard.pressidium.com/dashboard"
    enabled = true
    tool_timeout_sec = 180

    [mcp_servers.pressidium.env_http_headers]
    "X-Pressidium-Email" = "PRESSIDIUM_EMAIL"
    "X-Pressidium-Password" = "PRESSIDIUM_PASSWORD"

  3. Open PowerShell and set your credentials in the terminal:

    $env:PRESSIDIUM_EMAIL = Read-Host "Pressidium Dashboard email"
    $env:PRESSIDIUM_PASSWORD = [System.Net.NetworkCredential]::new( 
      '', (Read-Host "Pressidium Dashboard password" -AsSecureString) 
    ).Password

    When prompted, fill in your email and password.

The values remain available only for the current shell session.

Keep your Dashboard credentials out of AI conversations, screenshots, Git repositories, and shared configuration files.

3. Start Codex from the configured environment

After setting the credential variables, fully quit Codex if still open, and launch it from the same shell:

codex

This allows Codex CLI to inherit PRESSIDIUM_EMAIL and PRESSIDIUM_PASSWORD.

If you open a new terminal session, set the variables again before starting Codex.

Codex IDE extension

The Codex IDE extension shares the same MCP configuration.

Fully restart the IDE with the credential variables available to the process running the extension.

If you use a remote development environment, configure the variables in the environment where Codex actually runs.

WSL environment variables are separate from those available to a native Windows application.

4. Check the MCP connection

In Codex CLI, run:

/mcp

Confirm that the pressidium server is enabled and inspect the available Pressidium tools.

If the server or tools do not appear, check the configuration file, environment variables, and troubleshooting section below.

5. Verify the connection

Start with this request:

Use pressidium_whoami to verify my connection and show the selected team if available. Then use pressidium_list_sites to list the websites I can access. Include website names and whether each is Managed Hosting or standalone EDGE. Do not change any website settings.

  • Check that the returned account, team, and websites match what you expect in the Pressidium Dashboard.

  • Inspect the actual tool results as well as the assistant's summary.

If you belong to multiple teams, ask:

  • List my Pressidium teams. Show me their names and ask which team to select before continuing.

  • After selecting the intended team, ask Codex to list its sites again.

  • For larger accounts, ask it to continue through all available pages and state whether the list is complete.

For additional verification prompts and example tasks, return to Get started with Pressidium MCP.

6. Add Pressidium Agent Skills (Optional)

Once your Pressidium MCP connection is working, you can optionally add Pressidium Agent Skills for reusable Pressidium workflows.

See Use Pressidium Agent Skills with Pressidium MCP for installation and verification instructions for Codex.

Troubleshooting

Problem

What to check

Authentication fails

Verify your Dashboard email and password, account access, and that the dedicated beta account does not use MFA. Confirm both environment variables exist in the process running Codex without printing their values.

No pressidium server or Pressidium tools appear

Check ~/.codex/config.toml, the TOML syntax, and that enabled = true. Restart Codex and inspect /mcp again.

Credentials are set in the terminal but Codex cannot use them

Make sure Codex was started from the same shell where PRESSIDIUM_EMAIL and PRESSIDIUM_PASSWORD were set. For the IDE extension, fully restart the IDE with those variables available to its process.

Codex attempts an OAuth flow

Do not use MCP OAuth login for this connection. Confirm the configuration uses env_http_headers and the exact Pressidium MCP server URL.

Wrong sites or no sites appear

Verify the connected account and selected team. List your Pressidium teams, select the intended one, and list its sites again. For larger accounts, check that all available pages were retrieved.

A tool reports an unsupported environment or product

Confirm whether the target is Managed Hosting or standalone EDGE and whether you requested production or staging. Some operations are available only for particular products or environments.

A write operation times out

Check the returned job ID or the Pressidium Dashboard before retrying. A timeout does not necessarily mean the underlying operation stopped.

For other issues that are not specific to Codex, see the troubleshooting section in Get Started with Pressidium MCP.

Did this answer your question?