WorkOS — MCP-сервер для Claude Code: функции и установка
WorkOS MCP-сервер даёт агенту доступ к операциям с организациями, пользователями и SSO. Он пригодится для управления WorkOS из чата.
claude mcp add --transport http mcp https://mcp.workos.com/mcpЧто делает WorkOS
Сервер позволяет агенту просматривать данные WorkOS и выполнять действия через API: например, находить организации и пользователей, создавать организации или приглашать пользователей. Также доступны операции с SSO, Directory Sync, AuthKit, вебхуками и флагами функций.
Доступ зависит от роли вашей учётной записи WorkOS. Агент работает в одном окружении за раз и начинает с sandbox; необратимые действия требуют отдельного подтверждения. Это ограничивает риск случайного удаления, но для операций записи аккаунту нужна соответствующая роль.
Подключение использует OAuth 2.1: при первом входе нужно авторизоваться и одобрить доступ. API-ключ вставлять не требуется. Сервер работает удалённо, а его доступ можно ограничить настройками команды WorkOS.
Какие задачи решает
- найти организации и пользователей в WorkOS
- создать организацию и пригласить пользователей
- проверить доступные агенту операции и параметры
- разобраться с проблемой входа через SSO
- настроить брендирование страницы входа AuthKit
Примеры запросов агенту
- Покажи организации WorkOS, доступные в текущем окружении.
- Создай организацию Acme Corp и пригласи пользователей из
acme_employees.csv. - Проверь, почему пользователи
org_123не могут войти через SSO.
Как установить WorkOS
Командой платформы: удалённый сервер
claude mcp add --transport http mcp https://mcp.workos.com/mcpКомандой платформы: удалённый сервер
codex mcp add mcp --url https://mcp.workos.com/mcpФайл настроек
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workos.com/mcp"
}
}
}Файл настроек
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.workos.com/mcp"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http mcp https://mcp.workos.com/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о WorkOS
Как установить WorkOS в Claude Code?
Выполните claude mcp add --transport http mcp https://mcp.workos.com/mcp. При первом подключении войдите в WorkOS и подтвердите доступ.
Что делает WorkOS MCP-сервер?
Он позволяет агенту читать данные WorkOS и выполнять доступные операции с организациями, пользователями, SSO и другими функциями сервиса.
Какие права есть у агента WorkOS?
Агент использует роль вашей учётной записи и работает в одном окружении за раз. Удаление и другие необратимые действия требуют явного подтверждения.
