如何将 WorkOS 远程 MCP 连接到 Windsurf

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

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

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "workos": {
      "serverUrl": "https://mcp.workos.com/mcp"
    }
  }
}

接入步骤

  1. 打开配置文件 — 编辑 ~/.codeium/windsurf/mcp_config.json。
  2. 添加服务端 — 在 mcpServers 中加入 "workos": { "serverUrl": https://mcp.workos.com/mcp }。
  3. 完成认证 — 首次调用时客户端会打开 WorkOS 的 OAuth 授权页面——点击允许后工具即可用。
  4. 验证 — 在 在线 Inspector 中粘贴 https://mcp.workos.com/mcp 并运行 initialize + tools/list 验证连通性。

🧰 工具预览(6)

ToolSafetyDescriptionParameters
list_organizations
~53 tok
🟢 ReadList organizations in your WorkOS environment.domain: string
get_organization
~55 tok
🟢 ReadGet an organization's details.organizationId*: string
list_users
~64 tok
🟢 ReadList users with email and state filters.email: stringorganizationId: string
create_user
~76 tok
🟠 WriteCreate a user in your environment.email*: stringfirstName: stringlastName: string
list_connections
~52 tok
🟢 ReadList SSO connections with their states.organizationId: string
list_directories
~35 tok
🟢 ReadList directory-sync directories.—

更多连接指南