インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、WorkOS をワンクリックで追加して、AI クライアント(Claude、ChatGPT、Copilot、Cursor)を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
1 つの環境での B2B アイデンティティ向け WorkOS API:組織とそのドメイン、AuthKit ユーザー、メンバーシップ、招待、セッション、SSO 接続、Directory Sync のディレクトリ、ユーザー、グループ、Audit Logs のエクスポート、イベントストリーム、RBAC のロールと権限。組織、ユーザー、メンバーシップ、招待の作成と更新ができ、削除と取り消しはインストール時にオフです。
こう聞いてみよう
WorkOS のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → WorkOS をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
WorkOS + Microsoft Copilot
1 つの環境での B2B アイデンティティ向け WorkOS API:組織とそのドメイン、AuthKit ユーザー、メンバーシップ、招待、セッション、SSO 接続、Directory Sync のディレクトリ、ユーザー、グループ、Audit Logs のエクスポート、イベントストリーム、RBAC のロールと権限。組織、ユーザー、メンバーシップ、招待の作成と更新ができ、削除と取り消しはインストール時にオフです。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
WORKOS_API_KEY
ステップ 1 — 認証情報を取得
設定は約 2 分です。
- https://dashboard.workos.com を開き、上部のバーで環境(Sandbox または Production)を選んで API Keys を開きます。
- シークレットキー(
sk_...、一度だけ表示)を作成し、空白やBearerの接頭辞を付けずにWORKOS_API_KEYに貼り付けます。 - コネクタをインストールし、
workos_list_organizationsを実行します。環境の組織を一覧表示し、キーを確認します。
キーは 1 つの環境に属し、その環境の API に完全にアクセスできます。WorkOS のキーにはスコープがありません。まず Sandbox のキーで始め、AI に実データを扱わせるときだけ Production のキーを使ってください。
個人データと機微なデータ: キーは環境内のすべての組織のアイデンティティデータに届き、AI はツールが返すものをすべて読みます。名前とメールアドレス、サインイン ID、セッションの IP アドレスとユーザーエージェント、役職付きのディレクトリユーザー、組織のメタデータと Stripe の顧客 ID、監査ログの内容などです。workos_get_directory_user と workos_get_directory_group はプロバイダーの生の属性をすべて返し、電話番号、上長、部署、社員番号が含まれることがあります。一覧ツールではこれらは省かれます。AI はタスクに必要なものだけを共有します。
秘密の値: コネクタは API キーを決して返しません。招待の応答からは token と accept_invitation_url が取り除かれます。そのリンクを持っている人なら誰でも組織に参加できるためです。workos_get_audit_log_export は CSV への短時間だけ有効なダウンロードリンク(url)を返します。AI はそれをパスワードと同様に扱い、ほかの場所には貼り付けません。
組織とドメイン: workos_list_organizations(名前のテキストやドメインで絞り込み)、workos_get_organization、workos_get_organization_by_external_id、workos_create_organization、workos_update_organization。workos_create_organization_domain はドメインを保留中として追加し、ドメインの所有者が公開する DNS TXT レコード(verification_prefix、verification_token)を返します。その後 workos_verify_organization_domain で確認を開始し、workos_get_organization_domain で状態を確認します。
ユーザー、メンバーシップ、ロール: workos_list_users(email や organization_id で絞り込み)、workos_get_user、workos_get_user_by_external_id、workos_create_user(パスワードなしで作成。本人は Magic Auth、ソーシャルログイン、SSO、または招待でサインインします)、workos_update_user。サインインプロバイダーは workos_list_user_identities、セッションは workos_list_user_sessions で確認します。メンバーシップ: workos_list_organization_memberships、workos_get_organization_membership、workos_create_organization_membership、ロールを変える workos_update_organization_membership、アクセスを止めて戻す workos_deactivate_organization_membership と workos_reactivate_organization_membership。ロールの slug は workos_list_roles、workos_get_role、workos_list_organization_roles(カスタムロールは org- で始まります)から、権限は workos_list_permissions から取得します。
招待: workos_list_invitations、workos_get_invitation、workos_send_invitation(メールは WorkOS 自身が送ります)、workos_resend_invitation。
SSO と Directory Sync: workos_list_connections と workos_get_connection は接続の種類と state を示します(active ならユーザーがサインインできます)。workos_list_directories、workos_get_directory、workos_list_directory_users(directory または group が必要)、workos_get_directory_user、workos_list_directory_groups(directory または user が必要)、workos_get_directory_group は同期されたユーザーとグループを読み取ります。workos_sync_directory はすぐに同期をキューに入れます。
Audit Logs とイベント: workos_list_audit_log_actions と workos_list_audit_log_schemas は何が記録されるかを示します。workos_create_audit_log_export は期間を指定して CSV エクスポートを開始し(イベントは書き込みません)、workos_get_audit_log_export は state が ready になるまで状態を報告します。workos_get_audit_log_retention はイベントの保存日数を示します。workos_list_events は range_start と range_end を指定し、種類(user.created、organization_membership.updated、dsync.user.created、connection.activated など)ごとにイベントストリームを読み取ります。order: asc で発生順にたどれます。API が保持するのは 90 日分のイベントで、1 回の呼び出しで扱えるのは最大 30 日分です。
更新: workos_update_organization と workos_update_user は渡したフィールドだけを変更しますが、domain_data と metadata は保存済みの値を置き換えるため、AI は一覧やオブジェクトを丸ごと送ります。ユーザーのメールを変えると email_verified は false に戻ります。メンバーシップの新しいロールは現在のロールを置き換えます。
インストール時はオフ: workos_delete_organization、workos_delete_organization_domain、workos_delete_user、workos_delete_organization_membership、workos_revoke_invitation、workos_revoke_session、workos_create_audit_log_event。どれも元に戻せない(監査ログのイベントは一度書き込むと削除できない)ため、チームが必要なときにワークスペース管理者がオンにします。
データ形式: ID には種類を示す接頭辞があります(org_、org_domain_、user_、om_、invitation_、session_、conn_、directory_、directory_user_、directory_group_、audit_log_export_、event_)。タイムスタンプは UTC の ISO 8601 です。一覧は {"object": "list", "data": [...], "list_metadata": {...}} の形で返ります。metadata の値は文字列です。
ページング: 一覧は既定で 10 件、limit で最大 100 件を新しい順に返します。次のページでは AI が list_metadata.after を after に渡し、null になったら止めます。workos_list_events も同じ方法でページングします。
制限: キーごとに 1 分あたり 6,000 リクエスト、AuthKit は 10 秒あたり読み取り 1,000 回と書き込み 500 回、ディレクトリユーザーはディレクトリごとに 1 秒あたり 4 リクエスト、組織の削除は 1 分あたり 50 回です。招待メールは WorkOS のメール送信上限に数えられます。
よくあるエラー: 401 はキーの誤りまたは取り消しです。403 はキーにその操作が許されていないか、環境でその機能が有効になっていません。404 は不明な ID、または別の環境の ID です。400 や 422 は無効なフィールドで、本文にフィールド名が示されます。429 はレート制限です。待ってから 1 回だけ再試行してください。
このコネクタは SSO 接続、AuthKit のブランディング、リダイレクト URI、Vault、Pipes、API キーを設定せず、パスワードも設定せず、誰かの代わりにサインインすることもありません。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — Microsoft Copilot にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き(または新規作成し)、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name(例:
AnythingMCP)、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー(MCP Servers → 対象のサーバー → API keys)を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
WorkOSのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| Tool | What it does |
|---|---|
workos_list_organizations | List organizations (the customer companies of this WorkOS environment), newest first: id, name, external_id, domains with their… |
workos_get_organization | One organization by id: name, domains (each with id, state and verification strategy), external_id, stripe_customer_id, metadata and… |
workos_get_organization_by_external_id | One organization by the external_id your own application stored on it |
workos_create_organization | Create an organization |
workos_update_organization | Update an organization: name, domains (domain_data replaces the whole list), external_id, Stripe customer id, metadata or the… |
workos_delete_organization | Permanently delete an organization together with its SSO connections and directories |
workos_get_organization_domain | One organization domain: domain name, state (pending, verified, failed, legacy_verified), verification strategy (dns or manual), the DNS… |
workos_create_organization_domain | Add a domain to an organization |
workos_verify_organization_domain | Start DNS verification of a pending organization domain after its TXT record was published |
workos_delete_organization_domain | Remove a domain from its organization |
workos_list_users | List AuthKit users of the environment, newest first: id, email, email_verified, first and last name, profile picture URL, external_id… |
workos_get_user | One AuthKit user by id: email, verification state, names, external_id, metadata, locale and last sign-in time |
workos_get_user_by_external_id | One AuthKit user by the external_id your own application stored on it |
workos_create_user | Create an AuthKit user without a password; the person signs in with a method enabled in the environment (Magic Auth, social or SSO) or… |
workos_update_user | Update an AuthKit user: name, email (resets email_verified to false), email_verified, external_id, metadata or locale |
workos_delete_user | Permanently delete an AuthKit user with their memberships, identities and sessions |
workos_list_user_identities | The sign-in identities linked to a user: provider (e.g |
workos_list_user_sessions | A user's AuthKit sessions, newest first: id, status, auth_method, organization_id, ip_address, user_agent, impersonator, expires_at and… |
workos_revoke_session | End one AuthKit session (sign the user out of that device) |
workos_list_organization_memberships | List organization memberships (which user belongs to which organization, with role(s) and status active, inactive or pending) |
workos_get_organization_membership | One organization membership: user, organization, role(s), status, whether a directory manages it, and IdP custom attributes |
workos_create_organization_membership | Add an existing AuthKit user to an organization with one role (role_slug) or several (role_slugs) |
workos_update_organization_membership | Change the role(s) of an organization membership; the new role replaces the current one |
workos_deactivate_organization_membership | Deactivate a membership: the user keeps the account and the membership record but can no longer sign in to that organization |
workos_reactivate_organization_membership | Reactivate an inactive membership, with its previous role(s) |
workos_delete_organization_membership | Permanently remove a user from an organization |
workos_list_invitations | List invitations, newest first: email, state (pending, accepted, expired, revoked), organization, role, inviter, expires_at |
workos_get_invitation | One invitation by id with its state and expiry, without the token and accept link |
workos_send_invitation | Invite someone by email, optionally into an organization with a role |
workos_resend_invitation | Send the email of a pending invitation again, optionally in another language |
workos_revoke_invitation | Revoke a pending invitation so its link stops working |
workos_list_connections | List SSO connections, newest first: id, name, organization_id, connection_type (OktaSAML, AzureSAML, GoogleOAuth, GenericOIDC, ...), state… |
workos_get_connection | One SSO connection by id: connection type, state, organization and domains |
workos_list_directories | List Directory Sync directories (SCIM, Entra ID, Google Workspace, Okta, BambooHR, ...), newest first: id, name, type, state (linked… |
workos_get_directory | One directory: type, state, organization, domain and user and group counts |
workos_sync_directory | Ask WorkOS to sync a directory from its provider now |
workos_list_directory_users | List users synced from a directory or a directory group: name, emails, username, job title, state (active, suspended, inactive), role(s)… |
workos_get_directory_user | One directory user with everything the provider sent, including raw_attributes (can hold phone numbers, manager, department, employee ids) |
workos_list_directory_groups | List groups synced from a directory, or the groups of one directory user: id, name, idp_id. raw_attributes are left out |
workos_get_directory_group | One directory group by id: name, idp_id, directory, organization and the provider's raw_attributes |
workos_list_audit_log_actions | List the Audit Logs actions configured in the environment (e.g. user.signed_in, document.updated) with their latest schema |
workos_list_audit_log_schemas | List the schema versions of one Audit Logs action: allowed target types and the actor, target and metadata JSON schemas |
workos_create_audit_log_event | Write an event into an organization's audit log |
workos_create_audit_log_export | Start a CSV export of an organization's audit log events for a time range, optionally filtered by actions, actors and target types |
workos_get_audit_log_export | State of an audit log export (pending, ready, error) |
workos_get_audit_log_retention | How many days an organization's audit log events are kept (retention_period_in_days) |
workos_list_events | Read the environment's event stream (what happened in WorkOS and at the connected identity and directory providers): id, event type… |
workos_list_roles | List the environment roles (RBAC) with slug, name, description, permissions and type, the roles every organization starts with |
workos_get_role | One environment role by slug: name, description, type and its permission slugs |
workos_list_organization_roles | All roles available in one organization: the environment roles plus its own custom roles (slugs starting with org-), with permissions |
workos_list_permissions | List the RBAC permissions defined in the environment: slug, name, description |
プロンプトの例
- 「SSO 接続がまだ有効になっていない組織はどれですか?」
- 「組織 Acme Corp のメンバーをロールと状態付きで一覧にしてください。」
- 「[email protected] をロール admin で組織 Acme Corp に招待してください。」
- 「状態が invalid_credentials のディレクトリはどれで、どの組織に属していますか?」
- 「Acme Corp の 10 月分の監査ログを CSV ファイルでエクスポートしてください。」
FAQ
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント(ライセンスまたは試用版)が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?