Appearance

Connect Codex to the EdgeComet MCP server ​

You connect OpenAI Codex to EdgeComet with one command: codex mcp add edgecomet --url https://cloud.edgecomet.com/mcp. Codex detects that the server uses OAuth, opens your browser on the EdgeComet sign-in screen, and saves the connection when you approve.

The Codex CLI, the Codex IDE extension and the ChatGPT desktop app share one configuration file, ~/.codex/config.toml. A server you add in one appears in the others. The CLI steps were tested with Codex CLI 0.153.4. For the shared steps and revoking access, see Connect an AI client to the EdgeComet MCP server.

Before you start ​

  • An EdgeComet account.
  • The Codex CLI, the Codex IDE extension or the ChatGPT desktop app, signed in to your OpenAI account.
  • A browser on the same computer, for the EdgeComet sign-in.

Add EdgeComet from the Codex CLI ​

  1. Run:

    bash
    codex mcp add edgecomet --url https://cloud.edgecomet.com/mcp

  2. Codex starts the sign-in, prints the link and opens it in your browser. On the EdgeComet screen Authorize Codex, check the account under Signed in as and press Authorize.

  3. The terminal confirms the sign-in:

    text
    Added global MCP server 'edgecomet'.
Detected OAuth support. Starting OAuth flow…
Authorize `edgecomet` by opening this URL in your browser:
https://cloud.edgecomet.com/oauth/authorize?response_type=code&client_id=...

Successfully logged in.

  4. Check the server with codex mcp list. The edgecomet row shows enabled and OAuth.

If no browser opens, open the printed link in a browser on the same computer: the sign-in returns to Codex through a local address. In a Codex session, /mcp lists the server and its tools.

To sign in again later, run codex mcp login edgecomet.

Add EdgeComet in config.toml ​

The command writes this entry to ~/.codex/config.toml. You can also add it by hand:

toml
[mcp_servers.edgecomet]
url = "https://cloud.edgecomet.com/mcp"

Then run codex mcp login edgecomet to sign in. For one project only, put the entry in .codex/config.toml inside a project you trust.

Add EdgeComet in the IDE extension or the ChatGPT desktop app ​

  1. Open the settings:
    • IDE extension: open the gear menu, then MCP servers.
    • ChatGPT desktop app: open Settings, then MCP servers.
  2. Press Add server and choose Streamable HTTP.
  3. Enter the name edgecomet and the URL https://cloud.edgecomet.com/mcp, and save.
  4. Press Restart extension in the IDE extension, or Restart in the app.
  5. Choose Authenticate for the server and approve the EdgeComet sign-in screen.

Let read-only tools run without prompts ​

Codex can prompt only for tools that are not marked read-only. Add default_tools_approval_mode to the server entry:

toml
[mcp_servers.edgecomet]
url = "https://cloud.edgecomet.com/mcp"
default_tools_approval_mode = "writes"

With writes, Codex runs the EdgeComet tools marked read-only without asking. It asks before the others: adding a website, live page reads, keyword research, export, redirect mapping and Edge SEO drafting. The other values are auto, prompt and approve. See Read-only tools.

To use EdgeComet in your repository, add project instructions. See Use EdgeComet MCP with coding agents.

Remove EdgeComet from Codex ​

  • Sign out and keep the server: codex mcp logout edgecomet.
  • Turn it off for now: add enabled = false to the server entry.
  • Remove it: codex mcp remove edgecomet.

Then revoke the connection in EdgeComet. See Manage and revoke connections.

If it does not work ​

error: unexpected argument '--transport' found ​

Codex does not take --transport. Give the URL with --url:

bash
codex mcp add edgecomet --url https://cloud.edgecomet.com/mcp

The server shows no tools after sign-in ​

Run codex mcp login edgecomet to sign in again, then start a new Codex session. In the session, /mcp verbose shows the server's status and tools.

Next ​