Codex

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

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.

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.

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

Problem	Solution
`ops` not listed	Check the `[mcp_servers.ops]` block in `~/.codex/config.toml` for typos, then restart Codex
Login didn’t complete	Re-run `codex mcp login ops` and finish both login and team selection in the browser
Wrong team’s data	Run `codex mcp login ops` again and select a different team
Tool calls fail after a while	Re-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.

MCP

Setup

Connect

Test it

Troubleshooting

Switching teams

​Connect

​Test it

​Troubleshooting

​Switching teams

Connect

Test it

Troubleshooting

Switching teams