Skip to main content
Codex connects to the hosted OnePerfectSlice server over streamable HTTP. You register the URL in your Codex config, then authenticate with codex mcp login.

Connect

1

Register the server

Add the server to ~/.codex/config.toml:
[mcp_servers.ops]
url = "https://mcp.oneperfectslice.ai/mcp"
OAuth login is supported only for streamable HTTP servers — the url field is what enables it. Don’t set a command for ops.
2

Authenticate

Run the OAuth login flow:
codex mcp login ops
Your browser opens to OnePerfectSlice — log in and select the team whose data this connection should access. Codex stores the token in its managed encrypted credential storage.
3

Verify

codex mcp list
You should see ops listed and authenticated.

Test it

In Codex, try:
Use ops to list available slices
You should see a tool call to list_slices and get back a list of your team’s slices.

Troubleshooting

ProblemSolution
ops not listedCheck the [mcp_servers.ops] block in ~/.codex/config.toml for typos, then restart Codex
Login didn’t completeRe-run codex mcp login ops and finish both login and team selection in the browser
Wrong team’s dataRun codex mcp login ops again and select a different team
Tool calls fail after a whileRe-run codex mcp login ops to refresh credentials

Switching teams

Each connection is scoped to one team. To switch, run codex mcp login ops again and select the new team during sign-in.