WorkOS API aracılığıyla WorkOS organizasyonlarını, kullanıcılarını, SSO bağlantılarını, dizinlerini ve AuthKit markalamasını yönetin.
Ayrıca bilinen adı workos/skills, mcp
- Yıldızlar
- 46
- Araçlar
- 5
- İndirmeler, 30 gün
- —
- En son sürüm
- 1.0.0
- Son commit
- 2 Kas 2026
- Lisans
- MIT
WorkOS MCP nedir?
WorkOS bir MCP sunucusudur. WorkOS API aracılığıyla WorkOS organizasyonlarını, kullanıcılarını, SSO bağlantılarını, dizinlerini ve AuthKit markalamasını yönetin. 5 araç sunar; örneğin whoami, list_operations, query.
Özet, projenin README dosyasından oluşturuldu
WorkOS MCP sunucusu hakkında
Bu uzak MCP server ile WorkOS organizasyonlarını, kullanıcılarını ve SSO bağlantılarını bir AI agent üzerinden yönetmek mümkündür. Geliştiricilerin tercih ettikleri AI istemcisi üzerinden doğrudan WorkOS API'sini çağırarak çalışma alanı ayarlarını, dizin senkronizasyonunu (directory sync), AuthKit markalamasını ve webhooks yapılandırmalarını kontrol etmelerine olanak tanır. Server, barındırılan bir servis olarak çalışır ve Dynamic Client Registration ile OAuth 2.1 kullanır; bu da başlamak için herhangi bir API anahtarı yapıştırmanıza gerek olmadığı anlamına gelir.
Kullanıcılar, Claude Code, Codex veya Cursor gibi agent'ları hedeflemek için WorkOS CLI üzerinden bağlantı kurabilirler. Ayrıca uzak server URL'si eklenerek GitHub Copilot, VS Code, Claude Desktop ve ChatGPT ile de uyumlu çalışır. Agent, dashboard üzerindeki spesifik rolünüzü devralarak yalnızca hesabınızın izin verdiği eylemleri gerçekleştirmesini sağlar. Güvenlik amacıyla server varsayılan olarak bir sandbox ortamında çalışır ve bir organizasyonu veya bağlantıyı silmek gibi geri alınamaz işlemler için açık onay gerektirir.
Neler yapabilirsiniz
- 1Yeni organizasyonlar oluşturmaAgent'tan yeni bir organizasyon oluşturmasını ve bir dosyadan bir grup kullanıcıyı davet etmesini isteyin.
- 2SSO sorunlarını gidermeBelirli bir organizasyonun neden oturum açma zorlukları yaşadığını araştırmak için agent'ı kullanın.
- 3AuthKit markalamasını güncellemeOturum açma sayfası görünümünü belirli bir tasarıma uydurması için agent'tan talepte bulunun.
- 4Dizin senkronizasyonunu denetlemeTaslak bağlantıları olan organizasyonları veya son zamanlarda senkronizasyonu başarısız olan dizinleri tespit edin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
WorkOS MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleWorkOS MCP'yi Claude Code içine yükleyin
$ claude mcp add --transport http mcp https://mcp.workos.com/mcpWorkOS MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workos.com/mcp"
}
}
}WorkOS MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.workos.com/mcp"
}
}
}WorkOS MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.workos.com/mcp"}'WorkOS MCP'yi Codex içine yükleyin
$ codex mcp add mcp --url https://mcp.workos.com/mcpWorkOS MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.workos.com/mcp"
WorkOS MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user --transport http mcp https://mcp.workos.com/mcpWorkOS MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workos.com/mcp",
"type": "http"
}
}
}WorkOS MCP araçları 5
README dosyasından algılandıwhoamilist_operationsquerymutatesetup_account
| whoami | — | |
| list_operations | — | |
| query | — | |
| mutate | — | |
| setup_account | — |
Otomatik kontroller
Çalıştırıldı 12 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Uzak uç nokta HTTPS kullanıyorGeçti
- Yıkıcı araçlar etiketlenmişGeçti
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
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 soruları
WorkOS MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --transport http mcp https://mcp.workos.com/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
WorkOS MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
WorkOS MCP hangi araçları sunar?
5 araç sunar; bunlar arasında whoami, list_operations, query, mutate, setup_account yer alır.
WorkOS MCP server nasıl kimlik doğrulaması yapar?
WorkOS Connect üzerinden Dynamic Client Registration ile OAuth 2.1 kullanır; böylece API anahtarlarını yapıştırmak yerine bir onay ekranı üzerinden giriş yaparsınız.
WorkOS MCP agent hangi izinlere sahiptir?
Agent sizin hesabınız gibi hareket eder ve dashboard rolünüzü devralır; bu nedenle salt okunur (read-only) bir rol değişiklik yapamaz. Tek seferde tek bir ortamda çalışır ve varsayılan olarak sandbox modundadır.
WorkOS MCP server neler yapabilir?
Organizasyonlar, kullanıcılar, SSO bağlantıları, Directory Sync, AuthKit markalaması, webhooks ve feature flag'leri kapsayan salt okunur ve yazma işlemlerini gerçekleştirir.
WorkOS MCP, yıkıcı işlemler için onay gerektiriyor mu?
Evet; bir organizasyonu, bağlantıyı veya dizini silmek gibi geri alınamaz işlemler, nelerin silineceğine dair bir açıklama döndürür ve önce açık bir onay gerektirir.