Documentation Index
Fetch the complete documentation index at: https://docs.oneperfectslice.ai/llms.txt
Use this file to discover all available pages before exploring further.
Install
Check prerequisites
Verify Node.js v20+ and Codex are installed:node --version # must be v20.0.0 or higher
codex --version # any recent version
Download the MCP server
curl -sL https://pub-a9df95cb361d4d8ca33bc8682da287c0.r2.dev/ops-mcp.tar.gz -o /tmp/ops-mcp.tar.gz
rm -rf ~/ops-mcp
tar xzf /tmp/ops-mcp.tar.gz -C ~
cd ~/ops-mcp && npm install
Get your API key
If you don’t have one, create an API key in Org Settings. It starts with sk_. Register the MCP server
codex mcp add ops \
--env OPS_API_KEY=sk_your_api_key \
-- node $HOME/ops-mcp/src/index.js
Verify
Restart Codex or start a new session, then run:You should see ops in the output. Test it
In Codex, try:
Use ops to list available slices
list_slices and get back a list of your team’s slices.
Troubleshooting
| Problem | Solution |
|---|
ops not showing in mcp list | Re-run the codex mcp add command and restart Codex |
INVALID_OR_EXPIRED_TOKEN in logs | Check your API key is correct. View logs at ~/.ops-mcp/logs/ops-mcp.log |
node: command not found | Use the full path to node (e.g., /usr/local/bin/node) |
| Tool calls fail silently | Fully quit Codex and start a new session |
Updating
To update to the latest version:
curl -sL https://pub-a9df95cb361d4d8ca33bc8682da287c0.r2.dev/ops-mcp.tar.gz -o /tmp/ops-mcp.tar.gz
rm -rf ~/ops-mcp
tar xzf /tmp/ops-mcp.tar.gz -C ~
cd ~/ops-mcp && npm install
