Connect Codex

Codex CLI runs local processes and can also connect to a remote server directly, so it supports every Moodle and Ed Discussion Model Context Protocol (MCP) surface described in MCP servers. Official reference: MCP in Codex, fetched 2026-09-21.

Prerequisites

moodle-cli and edstem-cli installed and signed in. See Install and Install.
Codex CLI installed.

Codex reads MCP servers from ~/.codex/config.toml (or .codex/config.toml for a project-scoped config).

Moodle
Ed Discussion

Preferred: `moodle mcp connect`

moodle mcp connect codex

This writes a bridge block to ~/.codex/config.toml, wrapped in # >>> moodle-cli mcp:... markers so it can find and update its own entry later:

[mcp_servers."moodle-<profile>"]
command = "moodle"
args = ["mcp", "bridge", "--profile", "<profile>"]

Manual: remote, header auth

[mcp_servers."moodle"]
url = "https://<worker-host>/mcp"
http_headers = { Authorization = "Bearer <your-token>" }

Get <your-token> with moodle mcp connect codex --mode remote --show-token.

Stdio, local

codex mcp add edstem --env EDSTEM_TOKEN=<your-token> -- edstem-mcp

or directly in config.toml:

[mcp_servers.edstem]
command = "edstem-mcp"
env_vars = ["EDSTEM_TOKEN"]

Remote, hosted OAuth

[mcp_servers.edstem]
url = "https://edstem.tuuhub.com/mcp"

Then run codex mcp login edstem to complete the OAuth sign-in.

Remote, self-deployed Worker

[mcp_servers.edstem]
url = "https://<your-worker>/mcp"
http_headers = { Authorization = "Bearer <your-token>" }

Verify the connection

codex mcp list

Or, inside a Codex session, run /mcp to see active servers and their tools.

Connect an AI app

Connect a client

Prerequisites

Preferred: `moodle mcp connect`

Manual: remote, header auth

Stdio, local

Remote, hosted OAuth

Remote, self-deployed Worker

Verify the connection

​Prerequisites

​Preferred: moodle mcp connect

​Manual: remote, header auth

​Stdio, local

​Remote, hosted OAuth

​Remote, self-deployed Worker

​Verify the connection

Prerequisites

Preferred: `moodle mcp connect`

Manual: remote, header auth

Stdio, local

Remote, hosted OAuth

Remote, self-deployed Worker

Verify the connection