Skip to main content
Use this guide to add Kyberis to Codex Desktop. MCP gives Codex callable Kyberis tools. The Kyberis skill gives Codex investigation instructions for resolving entities, collecting evidence, pivoting relationships, and running assessments.

​
Prerequisites

  • Codex Desktop installed and signed in
  • A Kyberis account with access to the workspace you want Codex to use
  • Node.js 20 or newer with npx for installing the Kyberis skill
  • Permission to authenticate the Kyberis MCP server through your browser
Do not paste API keys, access tokens, or bearer tokens into screenshots, commits, issues, or shared chat logs. Use the Codex Desktop OAuth login flow for MCP when possible. Store long-lived credentials in a local secret manager or another secure local store.

​
1. Open Codex Desktop Settings

Open Codex Desktop and select Settings from the lower-left account menu. Codex Desktop home screen with Settings visible in the sidebar. Codex Desktop account menu with Settings selected. The account email is redacted.

​
2. Open MCP Servers

In Settings, select MCP servers under Integrations. Codex Desktop settings with MCP servers selected. Select Add server. Codex Desktop MCP servers settings with Add server visible.

​
3. Add the Kyberis MCP Server

Create a custom MCP server: Leave token and header fields empty unless your Kyberis administrator gives you a specific credential flow. Select Save. Codex Desktop custom MCP form with Kyberis, Streamable HTTP, and the Kyberis MCP URL configured.

​
4. Authenticate MCP

Open a terminal and run:
Use the same server name you entered in Codex Desktop. If Codex registered the server as Kyberis, use:
Codex prints an authorization URL. Open it in your browser and complete the Kyberis login. Terminal running codex mcp login kyberis. After you complete auth, Codex reports that it logged in to the Kyberis MCP server. Terminal showing successful Kyberis MCP login. The authorization URL is redacted. You may see a local browser callback page that says authentication is complete. Browser callback page showing authentication complete. The callback state value is redacted.

​
5. Install the Kyberis Skill

Install the Kyberis skill for Codex:
Terminal running the Kyberis skill install command for Codex. The installer writes the skill to ~/.codex/skills/kyberis. Restart Codex Desktop after installation so the skill is available in new chats. To check the installed skill later, run:

​
6. Verify Tools and Skill Behavior

Start a new Codex Desktop chat in the workspace where you want to use Kyberis. Ask Codex to list the Kyberis MCP tools:
Codex Desktop verification prompt asking Codex to list Kyberis MCP tools. Then verify that the skill is guiding the workflow:
A working setup should call Kyberis tools through MCP, separate facts from inference, and preserve request_id, evidence IDs, confidence, and caveats in the response.

​
Troubleshooting

​
Next Steps

Install skills

Connect MCP