WorkOS

WorkOS MCP 服务

使用 AI Agent 管理 WorkOS 工作区。WorkOS MCP 服务是一个远程 Model Context Protocol 服务。任何 MCP 客户端 都可以通过代表你调用 WorkOS API，来管理组织、用户、SSO 连接、目录、 品牌设置等。

• 服务 URL： https://mcp.workos.com/mcp
• 传输方式： Streamable HTTP
• 身份验证： OAuth 2.1 和动态客户端注册（WorkOS Connect）。无需粘贴 API 密钥。
• 文档： https://workos.com/docs/mcp

此文件夹存放该服务的注册表元数据（server.json）。该服务由 WorkOS 托管并运行。 其源代码未在此处发布。 此仓库的其余部分存放适用于 AI 编码 Agent 的 WorkOS 技能。

该服务以你的身份运行。它继承你在 WorkOS 控制面板中的角色，并且只能 执行你的账户有权限执行的操作。

连接客户端

首次连接时，客户端会打开 WorkOS 授权页面。登录并批准访问权限。 之后，Agent 会以你的账户身份连接。

WorkOS CLI（Claude Code、Codex、Cursor）

workos mcp install

CLI 会检测已安装的客户端。使用 --agent claude-code、--agent codex 或 --agent cursor 指定目标客户端。workos mcp status 会显示已安装 并已登录的客户端。

GitHub Copilot / VS Code

将服务添加到 .vscode/mcp.json：

{
  "servers": {
    "workos": {
      "type": "http",
      "url": "https://mcp.workos.com/mcp"
    }
  }
}

从 mcp.json 编辑器启动服务，或从命令面板运行 MCP: List Servers。

Claude Code

claude mcp add --transport http workos https://mcp.workos.com/mcp

在 Claude Code 中使用 /mcp 查看状态或重新登录。

Cursor

添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（按项目）：

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

打开 设置 → MCP，然后点击 WorkOS 旁边的登录。

Codex CLI

codex mcp add workos --url https://mcp.workos.com/mcp
codex mcp login workos

Claude Desktop、ChatGPT

打开设置 → 连接器，点击添加自定义连接器，将其命名为 WorkOS，并输入 https://mcp.workos.com/mcp。

其他客户端

使用 URL https://mcp.workos.com/mcp 添加远程 MCP 服务。 Antigravity、Factory、Goose、OpenCode、Windsurf 和 Zed 的设置步骤见 文档。

工具

工具	功能
whoami	返回你的身份、角色以及你可以访问的环境。
list_operations	列出 Agent 可用的 WorkOS 操作及其参数。
query	执行目录中的只读操作，例如列出组织或用户。
mutate	执行目录中的写入操作，例如创建组织或邀请用户。
setup_account	为首次使用的用户配置 WorkOS 工作区。

操作涵盖组织、用户、SSO 连接、Directory Sync、AuthKit 品牌设置、webhook、 功能标志等。

示例提示词

• “为 Acme Corp 设置一个新组织，并邀请 acme_employees.csv 中的所有人。”
• “帮我了解 org_123 使用 SSO 登录遇到问题的原因。”
• “邀请 [email protected] 以管理员身份加入 org_123。”
• “列出所有带有草稿 SSO 连接的组织，并标记 24 小时内未同步的目录。”
• “这是我们营销网站的截图。让我们的 AuthKit 登录页面与之匹配。”
• “为我们的生产环境设置 Datadog 审计日志流。”

权限与安全

• 角色继承。 Agent 执行的每项操作都遵循与控制面板相同的访问控制。只读角色无法进行更改。
• 环境范围。 Agent 一次只在一个环境中工作。默认使用沙盒环境，只有在你明确指示时才会访问生产环境。
• 破坏性操作确认。 删除组织、连接或目录等不可逆操作会返回将被销毁内容的说明，并要求在执行前明确确认。
• 机密信息。 API 密钥、客户端机密及类似值会在传给 Agent 前从响应中移除。
• 管理员控制。 团队管理员可以在团队身份验证设置中，为整个团队禁用 MCP 访问、阻止访问生产环境，或将 MCP 设为只读。

限制

• 不支持冒充用户。
• 不提供最敏感的控制面板操作：更改 MCP 访问设置、创建或轮换凭据，以及删除你的 WorkOS 团队。
• 一次只能访问一个团队。Agent 的访问范围仅限于你进行身份验证时使用的团队。

支持

• 文档：https://workos.com/docs/mcp
• 支持：[email protected]
• 状态：https://status.workos.com

列表

此处的 server.json 是 MCP Registry 中 com.workos/mcp 条目的权威来源。其他目录见 LISTINGS.md。