Управляйте организациями, пользователями, SSO-подключениями, каталогами и брендингом AuthKit через WorkOS API.
Также известен как workos/skills, mcp
- Звёзды
- 46
- Инструменты
- 5
- Загрузки, 30 дней
- —
- Последняя версия
- 1.0.0
- Последний коммит
- 2 нояб. 2026 г.
- Лицензия
- MIT
Что такое WorkOS MCP?
Управляйте организациями, пользователями, SSO-подключениями, каталогами и брендингом AuthKit через WorkOS API. Он предоставляет 5 инструментов, например whoami, list_operations, query.
Сводка сгенерирована из README проекта
О WorkOS MCP server
С этим удаленным MCP server можно управлять организациями, пользователями и SSO-подключениями WorkOS через AI agent. Он позволяет разработчикам контролировать настройки рабочих пространств, синхронизацию каталогов, брендинг AuthKit и вебхуки, вызывая WorkOS API напрямую из предпочтительного AI-клиента. Сервер работает как хостинговый сервис и использует OAuth 2.1 с Dynamic Client Registration, а это значит, что для начала работы не нужно вставлять API-ключи.
Пользователи могут подключиться через WorkOS CLI к таким агентам, как Claude Code, Codex или Cursor. Он также совместим с GitHub Copilot, VS Code, Claude Desktop и ChatGPT путем добавления URL удаленного сервера. Агент наследует вашу конкретную роль в панели управления, что гарантирует выполнение только тех действий, которые разрешены вашей учетной записи. В целях безопасности сервер по умолчанию использует среду sandbox и требует явного подтверждения для необратимых операций, таких как удаление организации или подключения.
Что вы можете с ним делать
- 1Создание новых организацийПопросите агента создать новую организацию и пригласить группу пользователей из файла.
- 2Устранение проблем с SSOИспользуйте агента, чтобы выяснить, почему конкретная организация испытывает трудности со входом в систему.
- 3Обновление брендинга AuthKitПопросите агента изменить внешний вид страницы входа в соответствии с определенным дизайном.
- 4Аудит синхронизации каталоговНайдите организации с черновиками подключений или каталоги, синхронизация которых недавно завершилась ошибкой.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить WorkOS MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка WorkOS MCP в Claude Code
$ claude mcp add --transport http mcp https://mcp.workos.com/mcpУстановка WorkOS MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workos.com/mcp"
}
}
}Установка WorkOS MCP в VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.workos.com/mcp"
}
}
}Установка WorkOS MCP в VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.workos.com/mcp"}'Установка WorkOS MCP в Codex
$ codex mcp add mcp --url https://mcp.workos.com/mcpУстановка WorkOS MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.workos.com/mcp"
Установка WorkOS MCP в Gemini CLI
$ gemini mcp add -s user --transport http mcp https://mcp.workos.com/mcpУстановка WorkOS MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workos.com/mcp",
"type": "http"
}
}
}Инструменты WorkOS MCP 5
Определено из READMEwhoamilist_operationsquerymutatesetup_account
| whoami | — | |
| list_operations | — | |
| query | — | |
| mutate | — | |
| setup_account | — |
Автоматические проверки
Запущено 12 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийПройдено
- Open source лицензия (OSI)Пройдено
- Коммит или релиз за последний годПройдено
- Имя пакета не похоже на популярный пакетНе проверялось
- Удаленная конечная точка использует HTTPSПройдено
- Деструктивные инструменты помеченыПройдено
- Нет скрытых инструкций для моделиПройдено
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
README
Открыть на GitHubWorkOS MCP Server
Manage your WorkOS workspace with AI agents. The WorkOS MCP server is a remote Model Context Protocol server. Any MCP client can use it to manage organizations, users, SSO connections, directories, branding, and more, by calling the WorkOS API on your behalf.
- Server URL:
https://mcp.workos.com/mcp - Transport: Streamable HTTP
- Auth: OAuth 2.1 with Dynamic Client Registration (WorkOS Connect). No API keys to paste.
- Docs: https://workos.com/docs/mcp
This folder holds the registry metadata (server.json) for the server. The
server runs as a hosted service at WorkOS. Its source is not published here.
The rest of this repository holds WorkOS skills for AI coding agents.
The server acts as you. It inherits your WorkOS dashboard role and can only do what your account can do.
Connect a client
The first time you connect, your client opens a WorkOS consent screen. Sign in and approve access. After that the agent is connected as your account.
WorkOS CLI (Claude Code, Codex, Cursor)
workos mcp install
The CLI detects installed clients. Use --agent claude-code, --agent codex,
or --agent cursor to target one. workos mcp status shows what is installed
and signed in.
GitHub Copilot / VS Code
Add the server to .vscode/mcp.json:
{
"servers": {
"workos": {
"type": "http",
"url": "https://mcp.workos.com/mcp"
}
}
}
Start the server from the mcp.json editor, or run MCP: List Servers from
the Command Palette.
Claude Code
claude mcp add --transport http workos https://mcp.workos.com/mcp
Use /mcp inside Claude Code to check status or sign in again.
Cursor
Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):
{
"mcpServers": {
"workos": { "url": "https://mcp.workos.com/mcp" }
}
}
Open Settings → MCP and click Login next to WorkOS.
Codex CLI
codex mcp add workos --url https://mcp.workos.com/mcp
codex mcp login workos
Claude Desktop, ChatGPT
Open Settings → Connectors, click Add custom connector, name it
WorkOS, and enter https://mcp.workos.com/mcp.
Other clients
Add a remote MCP server with the URL https://mcp.workos.com/mcp. Setup steps
for Antigravity, Factory, Goose, OpenCode, Windsurf, and Zed are in the
docs.
Tools
| Tool | What it does |
|---|---|
whoami |
Returns your identity, role, and the environments you can reach. |
list_operations |
Lists the WorkOS operations available to the agent, with parameters. |
query |
Runs a read-only operation from the catalog, such as listing organizations or users. |
mutate |
Runs a write operation from the catalog, such as creating an organization or inviting a user. |
setup_account |
Provisions a WorkOS workspace for a first-time user. |
Operations cover organizations, users, SSO connections, Directory Sync, AuthKit branding, webhooks, feature flags, and more.
Example prompts
- "Set up a new organization for Acme Corp and invite everyone in
acme_employees.csv." - "Help me understand why
org_123is having trouble signing in with SSO." - "Invite
bob@example.comtoorg_123as an admin." - "List every organization with a draft SSO connection, and flag any directories that haven't synced in 24 hours."
- "Here's a screenshot of our marketing site. Make our AuthKit sign-in page match it."
- "Set up a Datadog audit log stream for our production environment."
Permissions and safety
- Role inheritance. The agent runs every operation through the same access controls as the dashboard. A read-only role cannot make changes.
- Environment scope. The agent works in one environment at a time. It defaults to a sandbox environment and only touches production when you say so.
- Destructive confirmation. Irreversible operations, such as deleting an organization, connection, or directory, return a description of what will be destroyed and require an explicit confirmation step before they run.
- Secrets. API keys, client secrets, and similar values are stripped from responses before they reach the agent.
- Admin controls. Team admins can disable MCP access, block production access, or make MCP read-only for the whole team from the team authentication settings.
Limitations
- No user impersonation.
- The most sensitive dashboard actions are not exposed: changing MCP access settings, minting or rotating credentials, and deleting your WorkOS team.
- One team at a time. The agent is scoped to the team you authenticate with.
Support
- Docs: https://workos.com/docs/mcp
- Support: support@workos.com
- Status: https://status.workos.com
Listings
server.json here is the source of truth for the com.workos/mcp entry in the
MCP Registry. Other directories are
tracked in LISTINGS.md.
Вопросы о WorkOS MCP
Как добавить WorkOS MCP в Claude Code?
Выполните claude mcp add --transport http mcp https://mcp.workos.com/mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить WorkOS MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие инструменты предоставляет WorkOS MCP?
Он предоставляет 5 инструментов, включая whoami, list_operations, query, mutate, setup_account.
Как проходит аутентификация в WorkOS MCP server?
Используется OAuth 2.1 с Dynamic Client Registration через WorkOS Connect, поэтому вместо копирования API-ключей вы просто проходите авторизацию через экран подтверждения.
Какие права есть у WorkOS MCP agent?
Агент действует от имени вашей учетной записи и наследует вашу роль в панели управления, поэтому пользователь с правами только для чтения не сможет вносить изменения. Агент работает в одной среде за раз, по умолчанию используется sandbox.
Что умеет WorkOS MCP server?
Он выполняет операции чтения и записи, охватывающие организации, пользователей, SSO-подключения, Directory Sync, брендинг AuthKit, вебхуки и feature flags.
Требует ли WorkOS MCP подтверждения деструктивных действий?
Да, необратимые операции, такие как удаление организации, подключения или каталога, возвращают описание того, что будет удалено, и требуют явного подтверждения.