WorkOS

WorkOS MCP サーバー

AI エージェントで WorkOS ワークスペースを管理できます。WorkOS MCP サーバーは、リモートの Model Context Protocol サーバーです。あらゆる MCP クライアントから、WorkOS API をユーザーに代わって呼び出し、組織、ユーザー、SSO 接続、ディレクトリ、 ブランディングなどを管理できます。

• サーバー URL： https://mcp.workos.com/mcp
• トランスポート： Streamable HTTP
• 認証： Dynamic Client Registration（WorkOS Connect）を使用した OAuth 2.1。API キーを貼り付ける必要はありません。
• ドキュメント： https://workos.com/docs/mcp

このフォルダーには、サーバーのレジストリメタデータ（server.json）が含まれています。サーバーは WorkOS のホステッドサービスとして稼働しています。ソースコードはここでは公開されていません。 このリポジトリの残りの部分には、AI コーディングエージェント向けの WorkOS スキルが含まれています。

サーバーは、あなた自身として動作します。WorkOS ダッシュボードでのあなたのロールを引き継ぎ、あなたのアカウントで可能な操作のみを実行できます。

クライアントを接続する

初回の接続時に、クライアントに WorkOS の同意画面が表示されます。サインインしてアクセスを許可してください。その後、エージェントはあなたのアカウントとして接続されます。

WorkOS CLI（Claude Code、Codex、Cursor）

workos mcp install

CLI はインストール済みのクライアントを検出します。対象を指定するには、--agent claude-code、--agent codex、または --agent cursor を使用します。workos mcp status を実行すると、インストール済みでサインインしているクライアントが表示されます。

GitHub Copilot / VS Code

.vscode/mcp.json にサーバーを追加します。

{
  "servers": {
    "workos": {
      "type": "http",
      "url": "https://mcp.workos.com/mcp"
    }
  }
}

mcp.json エディターからサーバーを起動するか、コマンドパレットから MCP: List Servers を実行します。

Claude Code

claude mcp add --transport http workos https://mcp.workos.com/mcp

Claude Code 内で /mcp を使用すると、ステータスを確認したり、再度サインインしたりできます。

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト単位）に追加します。

{
  "mcpServers": {
    "workos": { "url": "https://mcp.workos.com/mcp" }
  }
}

Settings → MCP を開き、WorkOS の横にある Login をクリックします。

Codex CLI

codex mcp add workos --url https://mcp.workos.com/mcp
codex mcp login workos

Claude Desktop、ChatGPT

Settings → Connectors を開き、Add custom connector をクリックして、名前に WorkOS と入力し、https://mcp.workos.com/mcp を入力します。

その他のクライアント

URL https://mcp.workos.com/mcp を使用してリモート MCP サーバーを追加します。 Antigravity、Factory、Goose、OpenCode、Windsurf、Zed のセットアップ手順は ドキュメントにあります。

ツール

ツール	機能
whoami	あなたの ID、ロール、およびアクセス可能な環境を返します。
list_operations	パラメーターとともに、エージェントが利用できる WorkOS の操作を一覧表示します。
query	組織やユーザーの一覧表示など、カタログ内の読み取り専用操作を実行します。
mutate	組織の作成やユーザーの招待など、カタログ内の書き込み操作を実行します。
setup_account	初回利用者向けに WorkOS ワークスペースをプロビジョニングします。

操作の対象は、組織、ユーザー、SSO 接続、Directory Sync、AuthKit のブランディング、Webhook、フィーチャーフラグなどです。

プロンプトの例

• 「Acme Corp の新しい組織をセットアップして、acme_employees.csv に載っている全員を招待してください。」
• 「org_123 で SSO を使ったサインインに問題が起きている理由を調べてください。」
• 「[email protected] を管理者として org_123 に招待してください。」
• 「SSO 接続が下書き状態の組織をすべて一覧表示し、24 時間同期されていないディレクトリがあれば知らせてください。」
• 「マーケティングサイトのスクリーンショットです。AuthKit のサインインページをこれに合わせてください。」
• 「本番環境用に Datadog の監査ログストリームをセットアップしてください。」

権限と安全性

• ロールの継承。 エージェントは、ダッシュボードと同じアクセス制御を通じてすべての操作を実行します。読み取り専用ロールでは変更できません。
• 環境の範囲。 エージェントは一度に1つの環境で動作します。デフォルトではサンドボックス環境を使用し、指定された場合にのみ本番環境にアクセスします。
• 破壊的な操作の確認。 組織、接続、ディレクトリの削除など、取り消せない操作では、削除される内容の説明が返され、実行前に明示的な確認が必要です。
• シークレット。 API キー、クライアントシークレットなどの値は、エージェントに届く前にレスポンスから削除されます。
• 管理者による制御。 チーム管理者は、チームの認証設定から MCP アクセスの無効化、本番環境へのアクセスのブロック、チーム全体での MCP の読み取り専用化を行えます。

制限事項

• ユーザーになりすます機能はありません。
• ダッシュボードで最も機密性の高い操作は公開されていません。MCP アクセス設定の変更、認証情報の発行またはローテーション、WorkOS チームの削除が該当します。
• 一度に扱えるのは1つのチームです。エージェントの対象は、認証に使用したチームに限定されます。

サポート

• ドキュメント：https://workos.com/docs/mcp
• サポート：[email protected]
• ステータス：https://status.workos.com

掲載情報

ここの server.json は、MCP Registry の com.workos/mcp エントリーの信頼できる情報源です。 その他のディレクトリについては、LISTINGS.md で管理しています。