Media
バックオフィス・管理Claude EnterpriseAdmin APIAdmin API keyRBAC GroupsSCIMSSO

Claude Enterprise Admin APIで入退社時のアカウント管理を自動化する設定手順

AI Hack 編集部確認日

入社や退職のたびに、情報システム部門の担当者が手作業でClaude Enterpriseのアカウントを追加・削除している組織は少なくないはずです。人手に頼った運用では、退職者のアカウントを消し忘れる、異動先のグループへの権限付け替えが漏れるといった事故が起きやすくなります。2026年7〜8月にかけて、メンバーの招待・削除・ロール変更・グループ管理を担うエンドポイント群がベータとして全Claude Enterprise組織に開放された、とAnthropicの公式ドキュメントは説明しています。これにより、入退社の処理を人事システムや社内チケットフローと連携させ、手作業を減らす形での自動化が組みやすくなったと言えそうです。ただし現時点ではあくまでベータ機能であり、シングルサインオン(SSO、一度のログインで複数サービスを使えるようにする仕組み)の設定次第では一部の操作がAPI経由でできない点にも注意が必要です。

Claude Enterprise Admin APIとは

Claude Enterprise Admin APIは、組織のメンバー・招待・グループ・カスタムロールをプログラムから操作できる仕組みです。呼び出す先はhttps://api.anthropic.com/v1/organizations/以下の共通エンドポイント群で、Claude Console(開発者向けのプラットフォーム)組織とClaude Enterprise組織は、それぞれ別の鍵(Admin API key、管理操作専用の認証情報)で認証し、利用できるエンドポイントの範囲も異なる、とされています。Claude Enterprise組織が使えるのは主にメンバー・招待・グループ・カスタロールの読み取りで、ワークスペース管理やAPIキー管理といった一部の機能はClaude Console組織向けに限られています。

メンバーと招待のエンドポイントはベータ開始前から存在していたものの、グループの作成・削除・メンバー管理までAPI経由で行えるようになったのは今回のベータからです。招待やメンバーへのリクエストには従来どおりのバージョン指定ヘッダーだけで済みますが、グループとカスタムロール関連のリクエストにはanthropic-beta: ce-user-management-2026-07-13という専用のヘッダーを付ける必要があり、これを付け忘れると404エラーが返ってくる、と公式ドキュメントは明記しています。

前提条件・対象プラン

項目内容
対象組織Claude Enterprise(claude.ai)組織。ベータは全Claude Enterprise組織で有効になっているとされています
Admin API keyの作成者親組織のprimary owner(全リンク組織を横断して作成可能)。organization ownerはコンプライアンス関連のスコープに限定した鍵のみ作成できるとされています
作成場所claude.ai の組織設定内「API」ページとされています
メンバー・招待操作に必要なスコープ読み取りはread:members、ロール変更・削除・招待の作成/取消にはwrite:membersが必要とされています
グループ操作に必要なスコープ読み取りはread:rbac_groups、作成・削除・メンバー管理にはwrite:rbac_groupsが必要とされています
APIが割り当てられるロールuserとmanagedの2種類のみ。owner・membership_admin・primary_ownerはclaude.aiの管理画面側でのみ変更できるとされています
レート制限組織あたり100リクエスト/分が共通の上限で、招待の作成のみ1,200リクエスト/時の別枠が設けられているとされています

限界・注意点

API経由でどこまで自動化できるかは、組織がSSOやSCIM(人事システム側の情報をもとにアカウントを自動発行・削除する連携方式)をどう構成しているかによって変わります。以下の対比表で整理します。

できること注意点・限界
メンバーの一覧取得・メールアドレス検索・ロール変更・削除をAPI経由で行えるとされていますowner・membership_admin・primary_ownerといった管理系ロールを持つメンバーは、API経由での変更・削除ができないとされています
招待の作成・一覧・取消をAPI経由で行え、作成時にグループへの同時割り当ても指定できるとされています組織がJIT(初回ログイン時の自動発行)やSCIMでユーザーを自動プロビジョニングしている場合、招待の作成はエラーになるとされています
グループの作成・改名・削除、メンバーの追加・削除をAPI経由で行えるとされていますIDプロバイダ(社内で使う認証基盤)が管理するSCIM由来のグループは、名前もメンバーもAPI側からは変更できず、変更しようとするとエラーになるとされています
カスタムロールとその権限一覧を読み取れるとされていますカスタムロール自体の作成・変更はclaude.aiの管理画面でのみ行え、API経由では読み取り専用とされています

実務での使い方

1. 入社時の招待発行とグループ割り当てを自動化する

人事システムに新入社員の情報が登録されたタイミングをきっかけに、メールアドレスとロール、所属予定のグループIDを指定して招待を作成するスクリプトを動かせます。招待作成のリクエストにrbac_group_idsという項目を含めておけば、招待を受け入れた時点で自動的にそのグループに入る、とされているため、権限付与を後追いで手作業する必要がなくなる可能性があります。

2. 退職時のアカウント削除と招待取消をセットで実行する

公式ドキュメントは「退職者のオフボーディング」という具体的な処理手順を例示しています。メールアドレスでメンバーを検索し、見つかればそのユーザーIDを使って削除する、見つからず招待がpending(承認待ち)のままであれば代わりにその招待を取り消す、という流れです。人事システムの退職処理と連動させてこの2段階の処理をスクリプト化しておけば、退職者アカウントの消し忘れというありがちな事故を防ぎやすくなります。

3. グループメンバーを定期的に棚卸しする

異動や兼務が多い組織では、グループの割り当てが実態とずれていきがちです。グループの一覧とそのメンバーを定期的に取得し、社内の人事システムやIDプロバイダの名簿と突き合わせるスクリプトを組んでおくと、権限が残ったままの元担当者を見つけやすくなります。ただしSCIM由来のグループはAPI側から直接削除できないため、そうしたグループについてはIDプロバイダ側での修正を促す通知だけを出す設計にするのが現実的です。

活用事例|どんな業種・職種で使えるか

Admin APIによる自動化は、Claude Enterpriseを契約している企業のうち、アカウントの発行・削除を実際に担当している部署が主な使い手になります。

1. 製造業の人事総務部門でシステムアカウント管理を兼任する担当者

入社・異動・退職のたびに、社内の複数システムのアカウントをまとめて処理する業務です。人事システムへの登録をきっかけに、Claude Enterpriseの招待発行やグループ割り当てを自動で行うスクリプトを組み込んでおけば、複数システムを1件ずつ手作業で処理する手間の一部を減らせます。

2. 専任の情報システム部門を持たないスタートアップのバックオフィス担当者

人事・総務・情報システムを1人または少人数で兼任している業務です。退職処理のたびにClaude Enterpriseの管理画面を開いてアカウントを探す代わりに、退職連絡を受けたら実行する小さなスクリプトを1本用意しておくと、消し忘れのリスクを減らしながら作業時間も圧縮できます。

3. 全国に支店を持つ地方銀行の情報システム部門担当者

拠点間の異動が多く、そのたびに所属グループや権限を見直す業務です。異動情報をもとにグループの追加・削除をAPI経由で自動反映させておけば、異動先の権限が付与されないまま業務が始まってしまう、といった事態を防ぎやすくなります。

4. IT資産・アカウントの棚卸しを担当する情報セキュリティ監査担当者

四半期ごとなどの節目で、各システムのアカウントとロールが実態と一致しているかを確認する業務です。グループメンバーの一覧をAPI経由で定期的に取得し、人事データと突き合わせるチェックスクリプトを用意しておくと、監査のたびに手作業で画面を1件ずつ確認する負担を減らせます。

導入手順

  1. claude.aiの組織設定内「API」ページで、親組織のprimary ownerがAdmin API keyを作成する。メンバー・招待の操作にはread:membersとwrite:members、グループ操作も行う場合はread:rbac_groupsとwrite:rbac_groupsのスコープを選択する。
  2. 発行された鍵(sk-ant-api01-から始まる文字列)を控え、社内のシークレット管理システムに保存する。表示は一度きりなので、その場でコピーしておく必要がある。
  3. 入社時に実行するスクリプトを用意し、POST /v1/organizations/invitesにメールアドレス・ロール(userまたはmanaged)・必要に応じてrbac_group_idsを指定して招待を作成する処理を組み込む。
  4. 退職時に実行するスクリプトを用意し、GET /v1/organizations/users?email=...でメールアドレスからユーザーIDを検索し、見つかればDELETE /v1/organizations/users/{user_id}で削除する。見つからず招待がpendingのままであれば、GET /v1/organizations/invitesで一覧を取得し、該当する招待をDELETE /v1/organizations/invites/{invite_id}で取り消す。
  5. 人事システムや社内のワークフロー管理ツールにこれらのスクリプトを組み込み、入社・退職の申請が承認されたタイミングで自動実行されるようにする。
  6. 組織あたり100リクエスト/分、招待作成は1,200リクエスト/時というレート制限を踏まえ、対象人数が多い一括処理ではリトライ処理とページネーション(一覧を少しずつ取得する仕組み)を実装しておく。
  7. 運用開始後は、グループメンバーの一覧やAdmin API keyの一覧を定期的に棚卸しし、退職者が作成した鍵が残っていないかを確認する。

つまずきポイント・注意点

まとめ

Claude Enterprise Admin APIのメンバー・招待・グループ管理エンドポイントは、2026年7〜8月にベータとして全Claude Enterprise組織に開放され、入社時の招待発行からグループ割り当て、退職時のアカウント削除までをスクリプトで自動化できるようになりました。情報システム部門にとっての本論は、この機能を使うこと自体よりも、自社のSSO・SCIM構成のもとでどの操作がAPI経由で行え、どの操作がIDプロバイダ側の管理下に残るのかを正しく切り分け、退職者アカウントや発行済みの鍵が放置されない運用を設計することにあります。まずは退職時のオフボーディング処理のような小さな範囲から、人事システムとの連携をスクリプト化して試してみるのが現実的な次の一歩と言えそうです。

出典

この記事で扱ったツールClaude EnterpriseAdmin APIAdmin API keyRBAC GroupsSCIMSSO

AI Hackマーケット公式LINE

このメディアは、AI Hackマーケットが運営しています。
AI Hackマーケットは、AIノウハウを売買できるマーケットプレイスです。
現在ローンチ準備中のため公式LINEにご登録ください。
ご登録いただくと、実績あるクリエイターの新着記事や、記事クーポン情報をお届けします。

友だち追加LINE友だち追加QRコード