# faros mcp codex

Add the workspace MCP server to Codex

Source: https://faros.sh/docs/reference/cli/commands/mcp-codex/

<!-- Generated by scripts/sync-cli-docs.py from faroshq/faros docs/cli. Do not edit by hand; run `make sync-cli-docs`. -->

## Synopsis

Registers the workspace's aggregate MCP server with Codex
(codex mcp add --url), reading the workspace's long-lived MCP token from
FAROS_MCP_TOKEN. An existing entry with the same name is replaced.

Codex cannot skip certificate verification. For a hub whose certificate is
not publicly trusted, pass --ca-file: the command writes a bundle of your
system roots plus that CA and prints how to start Codex with it
(CODEX_CA_CERTIFICATE, Codex 0.129.0 or later).

```bash
faros mcp codex [flags]
```

## Examples

```bash
  # Publicly trusted hub
  faros mcp codex

  # Local hub from faros dev init
  faros mcp codex --ca-file faros-hub-ca.crt
```

## Options

```text
      --ca-file string          PEM CA that signs the hub's certificate, for a hub whose certificate is not publicly trusted (faros dev init writes <cluster>-ca.crt)
      --dry-run                 Print the commands instead of running them
  -h, --help                    help for codex
      --mcpserver-name string   Aggregate MCPServer to connect (default "default")
      --name string             Server name in the client's configuration (default: faros-<mcpserver-name>)
```

## Inherited options

```text
      --insecure-skip-tls-verify   Skip TLS certificate verification when talking to the hub
      --kubeconfig string          Path to the kubeconfig file (default: $KUBECONFIG, then ~/.kube/config)
```

## See also

- [faros mcp](https://faros.sh/docs/reference/cli/commands/mcp/) — MCP endpoints for AI clients (Claude Code, Cursor, Codex)