WorkOS API를 통해 WorkOS 조직, 사용자, SSO 연결, 디렉토리 및 AuthKit 브랜딩을 관리합니다.
다른 이름 workos/skills, mcp
- 스타
- 46
- Tools
- 5
- 다운로드, 30일
- —
- 최신 버전
- 1.0.0
- 마지막 커밋
- 2026년 11월 2일
- 라이선스
- MIT
WorkOS MCP란?
WorkOS은(는) MCP server입니다. WorkOS API를 통해 WorkOS 조직, 사용자, SSO 연결, 디렉토리 및 AuthKit 브랜딩을 관리합니다. 5개 도구를 제공합니다. 예: whoami, list_operations, query.
프로젝트 README에서 생성된 요약
WorkOS MCP server 정보
이 원격 MCP server를 사용하면 AI agent를 통해 WorkOS 조직, 사용자 및 SSO 연결을 관리할 수 있습니다. 개발자는 선호하는 AI 클라이언트에서 WorkOS API를 직접 호출하여 워크스페이스 설정, 디렉토리 sync, AuthKit 브랜딩 및 webhooks를 제어할 수 있습니다. 이 server는 호스팅된 서비스로 실행되며 Dynamic Client Registration 방식의 OAuth 2.1을 사용하므로 시작할 때 API 키를 붙여넣을 필요가 없습니다.
사용자는 WorkOS CLI를 통해 Claude Code, Codex 또는 Cursor와 같은 agent에 연결할 수 있습니다. 또한 원격 server URL을 추가하여 GitHub Copilot, VS Code, Claude Desktop 및 ChatGPT와도 호환됩니다. agent는 사용자의 특정 대시보드 역할을 상속받으므로 계정에서 허용된 작업만 수행할 수 있습니다. 안전을 위해 server는 기본적으로 sandbox 환경으로 설정되며, 조직이나 연결 삭제와 같이 되돌릴 수 없는 작업에 대해서는 명시적인 확인을 요구합니다.
활용 사례
- 1새 조직 프로비저닝agent에게 새 조직을 생성하고 파일에 있는 사용자 그룹을 초대하도록 요청합니다.
- 2SSO 문제 해결특정 조직에서 로그인 문제가 발생하는 원인을 조사하기 위해 agent를 사용합니다.
- 3AuthKit 브랜딩 업데이트특정 디자인에 맞게 로그인 페이지의 외관을 수정하도록 agent에게 요청합니다.
- 4디렉토리 동기화 감사초안 상태의 연결이 있는 조직이나 최근 동기화에 실패한 디렉토리를 식별합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
WorkOS MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 WorkOS MCP 설치
$ claude mcp add --transport http mcp https://mcp.workos.com/mcpCursor에 WorkOS MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workos.com/mcp"
}
}
}VS Code에 WorkOS MCP 설치
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.workos.com/mcp"
}
}
}VS Code CLI에 WorkOS MCP 설치
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.workos.com/mcp"}'Codex에 WorkOS MCP 설치
$ codex mcp add mcp --url https://mcp.workos.com/mcpCodex config.toml에 WorkOS MCP 설치
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.workos.com/mcp"
Gemini CLI에 WorkOS MCP 설치
$ gemini mcp add -s user --transport http mcp https://mcp.workos.com/mcpGemini settings.json에 WorkOS MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workos.com/mcp",
"type": "http"
}
}
}WorkOS MCP 도구 5
README에서 감지됨whoamilist_operationsquerymutatesetup_account
| whoami | — | |
| list_operations | — | |
| query | — | |
| mutate | — | |
| setup_account | — |
자동 검사
2026년 11월 12일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 원격 엔드포인트가 HTTPS 사용통과
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
README
GitHub에서 보기WorkOS 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는 어떻게 인증하나요?
WorkOS Connect를 통한 Dynamic Client Registration 방식의 OAuth 2.1을 사용합니다. 따라서 API 키를 직접 붙여넣는 대신 동의 화면을 통해 로그인합니다.
WorkOS MCP agent는 어떤 권한을 가지나요?
agent는 사용자의 계정을 대행하며 대시보드 역할을 상속받습니다. 따라서 읽기 전용 역할은 변경을 수행할 수 없습니다. 한 번에 하나의 환경에서만 작동하며 기본값은 sandbox입니다.
WorkOS MCP server로 무엇을 할 수 있나요?
조직, 사용자, SSO 연결, Directory Sync, AuthKit 브랜딩, webhooks 및 feature flags에 대한 읽기 및 쓰기 작업을 수행합니다.
WorkOS MCP는 파괴적인 작업 시 확인 절차를 거치나요?
네, 조직, 연결 또는 디렉토리 삭제와 같이 되돌릴 수 없는 작업은 삭제될 항목에 대한 설명을 반환하며 명시적인 확인이 필요합니다.