Connect an agent

Codex

Codex supports remote Streamable HTTP servers and OAuth with DCR. Add this to your personal ~/.codex/config.toml:

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

Then run:

codex mcp login caroush
codex mcp list

The server permits variable ports on numeric loopback HTTP redirects (127.0.0.1 and [::1]) as required by RFC 8252. The exact redirect used when issuing a code is still required when exchanging it. Never use 0.0.0.0 or a wildcard as a registered redirect.

Official reference: https://developers.openai.com/codex/mcp/

Claude Code

claude mcp add --transport http caroush https://mcp.caroush.com/mcp
claude mcp login caroush

Use the browser consent flow when prompted. You can also open an interactive Claude Code session, run /mcp, select Caroush and authenticate; use this path if an older client does not support the login subcommand. Official reference: https://code.claude.com/docs/en/mcp

Cursor

Add a remote server in Cursor MCP settings, or use its documented MCP JSON shape:

{
  "mcpServers": {
    "caroush": { "url": "https://mcp.caroush.com/mcp" }
  }
}

Complete OAuth in the browser. Official reference: https://cursor.com/docs/mcp.md

Other clients and VS Code agents

Use a current client that supports Streamable HTTP, PKCE S256, resource indicators and dynamic public-client registration. Supply the endpoint; let the client follow the WWW-Authenticate metadata rather than hard-coding token URLs. A client without compatible OAuth needs a compatible connector; this server does not provide an unrestricted static-token workaround. VS Code's native configuration format differs from Cursor's—consult its current MCP documentation rather than copying Cursor JSON into it.