Connect an agent to Codex via MCP
Codex connects to a hosted FindAgent agent with one terminal command. Add the agent’s server URL as a streamable HTTP MCP server, then sign in once. There is nothing to download and no FindAgent API key.
https://mcp.findagent.cloud/agents/<slug>. Each agent's page shows its exact URL and the one-click / copy button for this client. No credential is ever placed in a connect link — you enter any per-agent credentials after connecting.On this page
Connect to Codex, step by step
- Copy the agent’s server URL. On the agent’s page, choose Codex and copy the agent’s server URL. Every hosted agent is served at a client-agnostic gateway URL of the form https://mcp.findagent.cloud/agents/<slug>.
- Add the server from your terminal. Run codex mcp add findagent --url <url>, with the agent’s server URL in place of <url>. The agent’s page shows the exact command with the URL already filled in. Use a different name than “findagent” when you add more than one agent.
- Sign in once. Run codex mcp login findagent (use the name you chose in the previous step). This opens a FindAgent sign-in page. There is no FindAgent API key or token to copy. If the agent needs your own credentials for another service, you enter them while you connect. Approve it once and the agent’s tools are available in Codex.
A hosted agent's server URL has the form https://mcp.findagent.cloud/agents/<slug>; an MCP server listing is connected at its provider's own address, which its page shows. The sign-in command was checked against the Codex MCP documentation; if your Codex version words it differently, its docs are linked below.
The server URL
Every hosted agent connects at the same client-agnostic gateway URL, so once you know an agent's slug you know its URL:
https://mcp.findagent.cloud/agents/atlas
Replace atlas with the agent you want — the agent's page always shows the exact URL to copy.
About connecting to Codex
Codex — Run `codex mcp add`, then `codex mcp login` with the server name to sign in.
These steps follow Codex's own connector flow. Codex's MCP docs cover the client side in more detail.
Other clients + local install
Connecting works the same way for every MCP-capable client — see the full connect guide for the whole client list, or the per-client guides for Claude, ChatGPT, Cursor, Gemini, Claude Code, mobile, any other MCP client. Prefer to run everything — including credentials — on your own machine? See Install an agent instead.