如何将 Clerk Auth 远程 MCP 连接到 OpenAI Codex CLI

约 1 分钟即可把 Clerk 的远程 MCP 服务端接入 OpenAI Codex CLI。如需排查 OAuth / 401 问题,可先用 OAuth 2.1 调试器体检端点。

🛡️ Official✓ VerifiedStreamable HTTPOAuth 2.1🛡️ A+~345 tok6 tools
Streamable HTTPhttps://mcp.clerk.com/mcp

Add to ~/.codex/config.toml — Codex reads remote HTTP servers from [mcp_servers.*] tables:

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

接入步骤

  1. 编辑 TOML 配置 — 打开 ~/.codex/config.toml,加入 [mcp_servers.clerk] 与 url = "https://mcp.clerk.com/mcp"。
  2. 配置凭据 — 首次调用时客户端会打开 Clerk 的 OAuth 授权页面——点击允许后工具即可用。
  3. 验证 — 在 在线 Inspector 中粘贴 https://mcp.clerk.com/mcp 并运行 initialize + tools/list 验证连通性。

🧰 工具预览(6)

ToolSafetyDescriptionParameters
list_users
~49 tok
🟢 ReadList users with search and filters.query: string
get_user
~50 tok
🟢 ReadGet a user's profile, emails and metadata.userId*: string
update_user_metadata
~71 tok
🟠 WriteUpdate public or unsafe metadata on a user.userId*: stringmetadata*: object
list_organizations
~50 tok
🟢 ReadList organizations in your instance.query: string
get_organization_memberships
~56 tok
🟢 ReadList members of an organization.organizationId*: string
list_sessions
~49 tok
🟢 ReadList active sessions for a user.userId*: string

更多连接指南