Kelola organisasi, user, koneksi SSO, directory, dan branding AuthKit WorkOS melalui WorkOS API.
Juga dikenal sebagai workos/skills, mcp
- Stars
- 46
- Tools
- 5
- Unduhan, 30 hari
- —
- Versi terbaru
- 1.0.0
- Commit terakhir
- 2 Nov 2026
- Lisensi
- MIT
Apa itu WorkOS MCP?
Kelola organisasi, user, koneksi SSO, directory, dan branding AuthKit WorkOS melalui WorkOS API. Server ini menyediakan 5 tool, seperti whoami, list_operations, query.
Ringkasan dibuat dari README proyek
Tentang WorkOS MCP server
Mengelola organisasi, user, dan koneksi SSO WorkOS melalui AI agent kini dimungkinkan dengan remote MCP server ini. Anda dapat mengontrol pengaturan workspace, directory sync, branding AuthKit, dan webhooks dengan memanggil WorkOS API secara langsung dari AI client pilihan Anda. Server ini berjalan sebagai layanan hosted dan menggunakan OAuth 2.1 dengan Dynamic Client Registration, yang berarti Anda tidak perlu menempelkan API keys apa pun untuk memulai.
User dapat terhubung melalui WorkOS CLI untuk menargetkan agent seperti Claude Code, Codex, atau Cursor. Server ini juga kompatibel dengan GitHub Copilot, VS Code, Claude Desktop, dan ChatGPT dengan menambahkan URL remote server. Agent akan mewarisi role dashboard spesifik Anda, memastikan ia hanya dapat melakukan tindakan yang diizinkan oleh akun Anda. Untuk keamanan, server secara default menggunakan environment sandbox dan memerlukan konfirmasi eksplisit untuk operasi yang tidak dapat dibatalkan seperti menghapus organisasi atau koneksi.
Apa yang bisa Anda lakukan dengannya
- 1Provisioning organisasi baruMinta agent untuk membuat organisasi baru dan mengundang sekelompok user dari sebuah file.
- 2Troubleshooting masalah SSOGunakan agent untuk menyelidiki mengapa organisasi tertentu mengalami kesulitan saat proses sign-in.
- 3Memperbarui branding AuthKitMinta agent untuk mengubah tampilan halaman sign-in agar sesuai dengan desain tertentu.
- 4Audit sinkronisasi directoryIdentifikasi organisasi dengan koneksi draft atau directory yang gagal melakukan sinkronisasi baru-baru ini.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal WorkOS MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal WorkOS MCP di Claude Code
$ claude mcp add --transport http mcp https://mcp.workos.com/mcpInstal WorkOS MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workos.com/mcp"
}
}
}Instal WorkOS MCP di VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.workos.com/mcp"
}
}
}Instal WorkOS MCP di VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.workos.com/mcp"}'Instal WorkOS MCP di Codex
$ codex mcp add mcp --url https://mcp.workos.com/mcpInstal WorkOS MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.workos.com/mcp"
Instal WorkOS MCP di Gemini CLI
$ gemini mcp add -s user --transport http mcp https://mcp.workos.com/mcpInstal WorkOS MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workos.com/mcp",
"type": "http"
}
}
}Tool WorkOS MCP 5
Terdeteksi dari READMEwhoamilist_operationsquerymutatesetup_account
| whoami | — | |
| list_operations | — | |
| query | — | |
| mutate | — | |
| setup_account | — |
Pengecekan otomatis
Berjalan 12 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauLolos
- Lisensi open source (OSI)Lolos
- Ada commit atau release dalam satu tahun terakhirLolos
- Nama package tidak mirip dengan package populerTidak diperiksa
- Remote endpoint menggunakan HTTPSLolos
- Tools yang bersifat destruktif telah diberi labelLolos
- Tidak ada instruksi tersembunyi untuk modelLolos
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
README
Lihat di 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.
Pertanyaan tentang WorkOS MCP
Bagaimana cara menambahkan WorkOS MCP ke Claude Code?
Jalankan claude mcp add --transport http mcp https://mcp.workos.com/mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan WorkOS MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan WorkOS MCP?
Server ini menyediakan 5 tool, termasuk whoami, list_operations, query, mutate, setup_account.
Bagaimana cara autentikasi WorkOS MCP server?
Server ini menggunakan OAuth 2.1 dengan Dynamic Client Registration melalui WorkOS Connect, sehingga Anda cukup login melalui layar persetujuan alih-alih menempelkan API keys secara manual.
Izin apa saja yang dimiliki agent WorkOS MCP?
Agent ini bertindak sebagai akun Anda dan mewarisi role dashboard Anda, sehingga role read-only tidak akan bisa melakukan perubahan. Agent bekerja di satu environment dalam satu waktu dan secara default menggunakan sandbox.
Apa saja yang bisa dilakukan WorkOS MCP server?
Server ini menjalankan operasi read-only dan write yang mencakup organisasi, user, koneksi SSO, Directory Sync, branding AuthKit, webhooks, dan feature flags.
Apakah WorkOS MCP memerlukan konfirmasi untuk tindakan destruktif?
Ya, operasi yang tidak dapat dibatalkan seperti menghapus organisasi, koneksi, atau directory akan menampilkan deskripsi mengenai apa yang akan dihapus dan memerlukan konfirmasi eksplisit terlebih dahulu.