Ferndesk
MCP

Connect Codex CLI

Connect Codex CLI to Ferndesk by adding the remote MCP server to ~/.codex/config.toml, then signing in with codex mcp login ferndesk.

For the full AI clients overview, see Use Ferndesk with AI tools. OpenAI also documents MCP setup in the Codex MCP docs.

Get your connector URL

Copy the connector URL from the Codex CLI setup panel in Ferndesk.

  1. In Ferndesk, go to Integrations.

  2. Open AI clients.

Integrations page highlighting the AI clients category

  1. In the Clients list, select Codex CLI.

  2. Copy the Connector URL shown on the setup panel.

AI clients page with Clients list and connector URL

Add Ferndesk to config.toml

Remote MCP servers are configured in the Codex config file, not with codex mcp add.

  1. Open ~/.codex/config.toml in a text editor.

  2. Add this block to the file (setup panel label: Add to ~/.codex/config.toml). Paste your connector URL as the url value:

    [mcp_servers.ferndesk]
url = "<connectorUrl>"

  3. Save the file.

Remote servers are added in the config file; codex mcp add only supports local stdio servers.

Sign in to Ferndesk

Run the login command from your terminal to approve access. The setup panel labels this step Then sign in.

  1. In your terminal, run:

    codex mcp login ferndesk

  2. Complete the Ferndesk sign-in that opens, and pick the workspace to connect.

Confirm the connection

Run /mcp inside a Codex session to confirm the connection.

In Ferndesk, open Integrations → AI clients and scroll to Connected clients. Click Refresh if the new connection is not listed yet.

Was this helpful?