更新情報をお知らせします。
この度、マネジメントAPIに ロールを管理するAPI と メンバーのロールを変更するAPI が追加されました。
あわせて公式リモートMCPサーバーも対応したので、ChatGPTやClaudeなどのAIアプリから、話しかけるだけでロールを管理できるようになっています。
これまでロールの作成や、メンバーへのロールの付与は管理画面からの操作のみでした。
メンバーやロールが増えてくると、入社や異動のたびにロールを付け替えたり、同じ設定のロールを何度も作ったりと、手作業が多くなりがちです。
今回のアップデートにより、こうした作業をプログラムやAIに任せられるようになりました。
この記事では主な機能と使い方を簡単に紹介します。
アップデートの概要
マネジメントAPIに、次のエンドポイントが追加されました。
メソッド | パス | 内容 | 必要なAPIキーの権限 |
|---|---|---|---|
GET |
| ロールの一覧を取得 | ロールの取得 (一覧・詳細) |
GET |
| ロールの詳細を取得 | ロールの取得 (一覧・詳細) |
POST |
| ロールを作成 | ロールの作成 |
PATCH |
| ロールを更新 | ロールの更新 |
DELETE |
| ロールを削除 | ロールの削除 |
PATCH |
| メンバーに付与するロールを変更 | メンバーのロールを変更 |
また、メンバーの一覧・詳細を取得するAPIのレスポンスに、そのメンバーに付与されているロールのID(roleIds)が含まれるようになりました。
AIアプリからロールを管理できます
公式リモートMCPサーバーにも、ロールを扱うツールが追加されました。
microcms_get_roles/microcms_get_role… ロールの一覧・詳細を取得microcms_create_role… ロールを作成microcms_update_role… ロールを更新microcms_delete_role… ロールを削除microcms_update_member_roles… メンバーに付与するロールを変更
MCPサーバーを設定したAIアプリなら、次のように伝えるだけで操作できます。
ブログのコンテンツだけ編集できる「ブログ編集者」ロールを作って、〇〇さんに付与してください。いまあるロールと、それぞれ誰に付与されているかを一覧にしてください。ロールの権限は項目が多く、管理画面で一つずつ設定するのはなかなか大変です。やりたいことを言葉で伝えるだけで、AIが権限を組み立ててロールを作成・付与してくれるので、ロールの設計や見直しがぐっと手軽になります。ぜひお試しください。
MCPサーバーの設定方法はドキュメントをご覧ください。
使い方
1. APIキーに権限を付与する
APIキー管理画面で対象のAPIキーを選択し、「マネジメントAPI」の「ロール」「メンバー」にある、使いたい操作の権限にチェックを入れます。今回、次の5つの権限が追加されました。
- ロールの取得 (一覧・詳細)
- ロールの作成
- ロールの更新
- ロールの削除
- メンバーのロールを変更
2. ロールを取得する
リクエストするURLは https://{サービスID}.microcms-management.io/api/v1/roles です。X-MICROCMS-API-KEY ヘッダーに権限を付与したAPIキーを指定します。
curl -X GET "https://<SERVICE_ID>.microcms-management.io/api/v1/roles" -H "X-MICROCMS-API-KEY: <API_KEY>"リクエストに成功すると、ロールの一覧が返ってきます。permissions には、管理画面のロール編集画面で設定できる権限がそのまま入っています。
{
"roles": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "コンテンツ編集者",
"isAdmin": false,
"permissions": { ... },
"createdAt": "2026-11-16T00:00:00.000Z",
"updatedAt": "2026-11-16T00:00:00.000Z"
}
],
"totalCount": 1
}ロールの作成・更新では、この permissions と同じ形で権限を指定します。
取得したロールの内容をもとに、少しだけ変えたロールを作る、といった使い方もできます。
3. メンバーのロールを変更する
PATCH /api/v1/members/{memberId} で、メンバーに付与するロールを変更できます。
curl \
-X PATCH \
-H 'X-MICROCMS-API-KEY: <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"roleIds": [
"550e8400-e29b-41d4-a716-446655440000",
"7c9e6679-7425-40de-944b-e07fc1f90ae7"
]
}' \
'https://<SERVICE_ID>.microcms-management.io/api/v1/members/<MEMBER_ID>'このAPIは、付与されているロールを 指定したロールIDで置き換えます。今あるロールを残したい場合は、それも含めて指定してください。
ユースケース
入社や異動にあわせてロールを付け替える
社内のアカウント管理や人事システムと連携すれば、部署や役割の変更にあわせて、microCMSのロールも自動で付け替えられます。付け替え忘れによる権限の残りも防げます。
同じ設定のロールを別のサービスへ展開する
取得したロールの内容を別のサービスでそのまま作成すれば、複数のサービスで同じ権限設定をそろえられます。手作業での作り直しによる設定漏れを防げます。
権限を定期的に棚卸しする
ロールの一覧と、メンバーに付与されているロールのIDを定期的に取得すれば、誰がどの権限を持っているかを一覧にできます。AIアプリに「権限が強すぎるメンバーがいないか確認して」と頼むのも便利です。
注意事項
- 管理者ロールは更新・削除できません。
- メンバー(招待中のメンバーを含む)に付与されているロールは削除できません。
- 招待中のメンバーのロールは変更できません。
- サービスに参加している管理者が0人になる変更はできません。
また、「ロールの更新」や「メンバーのロールを変更」の権限を持つAPIキーは、メンバーが管理画面でできることを変えられます。必要な場面に限って付与し、APIキーの取り扱いにはご注意ください。
詳細な仕様は、ドキュメントの「ロールの取得」「ロールの作成」「ロールの更新」「ロールの削除」「メンバーの更新」をご覧ください。
おわりに
今回は、ロールを管理するマネジメントAPIと、MCPサーバーの対応について紹介しました。
メンバーとロールの管理もAPIやAIアプリから扱えるようになり、運用の自動化の幅が広がります。ぜひお試しください。
今後もより使いやすいサービスを目指してプロダクトの改善に努めてまいります。ご要望等ございましたら管理画面右下のチャットボタンよりご意見をお寄せください。