Skip to main content

Prerequisites

  • Codex CLI installed
  • Linkly AI Desktop running with the MCP service active

Configuration Steps

Codex may run shell commands in a network sandbox that can execute linkly but cannot reach Linkly AI Desktop on localhost. If linkly status reports App: Unreachable, do not assume that Desktop is stopped. Prefer the configured Linkly MCP integration. If MCP is unavailable, approve retrying only the exact Linkly CLI command outside the network sandbox; do not disable sandboxing globally. Ask the user to launch Desktop only if that approved retry also fails.
We recommend also installing Linkly AI Skills to teach the AI assistant how to efficiently use Linkly AI’s tools, improving search and reading efficiency.

Verify the Connection

After adding, send the following prompt in Codex to verify:
If configured correctly, Codex will call Linkly AI’s tools and return the search results.

FAQ

Check whether Linkly AI Desktop is running and whether the MCP service is active. The default port is 60606, which you can confirm in Linkly AI settings.