Connect Codex

What you need

• Codex installed on a computer with a browser, so you can sign in to DeskWink.
• DeskWink running on the computer whose folders you want to use (it can be the same computer), with a folder shared. Run deskwink status to check. See Getting started.

Codex in a terminal, the Codex app and the IDE extension share one configuration, so you add DeskWink once. ChatGPT on the web does not read your local Codex configuration; to use DeskWink there, follow Connect ChatGPT.

Codex CLI

1. Add DeskWink as a remote server:
   codex mcp add deskwink --url https://mcp.deskwink.com/mcp Copy
2. Sign in:
   codex mcp login deskwink Copy
   Codex opens DeskWink’s page in your browser. Sign in with the account you used to pair your computer, choose the computers and abilities on the consent page, and click Allow.
3. Start codex and type /mcp to see the active servers. codex mcp list lists what is configured.
4. Ask something that needs your files, such as “Which computers do I have connected to DeskWink?”

OpenAI documents --oauth-client-id and --oauth-client-secret for servers that require a pre-registered OAuth client. DeskWink does not: leave them out.

Codex app and IDE extension

• App. OpenAI’s page describes the desktop app as the “ChatGPT desktop app”: open Settings → MCP servers → Add server, enter the name DeskWink, choose Streamable HTTP, enter the address below, save, and select Restart.
• IDE extension. Open the gear menu, choose MCP servers → Add server, enter the same details, save, and select Restart extension.
• Then select Authenticate next to DeskWink in the server list and sign in on DeskWink’s page. Type /mcp in the composer to see connected servers.

Config file

You can also add a table to ~/.codex/config.toml (or .codex/config.toml in a trusted project, for a server that applies only there):

[mcp_servers.deskwink]
url = "https://mcp.deskwink.com/mcp"

Then run codex mcp login deskwink as above. Do not add bearer_token_env_var: DeskWink uses OAuth, not a fixed token.

If it does not work

• Codex says the computer is offline. DeskWink only runs while you have started it. Run deskwink launch on the computer whose folders you want to use.
• The sign-in did not start, or it expired. Run codex mcp login deskwink again, or select Authenticate in the app or extension. Sign-in opens a browser, so it needs a computer with one.
• Codex cannot see a folder. Add it with deskwink folders add, and check on the consent page that this computer is allowed. You can change it in the console under AI connections.
• You changed the configuration and nothing changed. Restart Codex, or use Restart in the app or Restart extension in the IDE.
• Codex asks before it uses a tool. That is Codex’s own approval setting. DeskWink separately holds every file change for your approval in the console.

More in Troubleshooting, and the steps shared by every app in Connect your AI.