Skip to content

Commit 56992b6

Browse files
committed
brainkb skill: single sign-on — one login covers admin tools too
Update §9: with SSO, one brainkb_login (or env auto-login) is enough for usermanagement admin tools; the MCP exchanges the session for a usermanagement-scoped token — no separate admin login. Header callers should pass a refresh token to unlock all services.
1 parent e9de64d commit 56992b6

1 file changed

Lines changed: 6 additions & 4 deletions

File tree

skills/brainkb_skills/SKILL.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -162,10 +162,12 @@ Call `brainkb_login(email, password, base_url?)`. Confirm with `brainkb_whoami()
162162
- Owner and Admin/SuperAdmin always bypass rules (no lockout).
163163

164164
### 9. Admin: manage users, roles & activation (usermanagement service)
165-
These act on the **usermanagement service** (a separate service with its own
166-
token) and require the caller to hold an **Admin/SuperAdmin** role. They work when
167-
the MCP has credentials (env auto-login, or `brainkb_login(email, password)` — an
168-
OAuth-only session can't log into usermanagement).
165+
These act on the **usermanagement service** and require the caller to hold an
166+
**Admin/SuperAdmin** role. With single sign-on, one `brainkb_login(email,
167+
password)` (or env auto-login) is enough — the MCP exchanges your session for a
168+
usermanagement-scoped token automatically; **no separate admin login**. (A caller
169+
authenticating by header should pass a refresh token so admin tools work too; a
170+
query_service-only access token won't authorize usermanagement.)
169171
- Onboarding: users are usually created by **first login via Globus/ORCID/GitHub**
170172
(auto-creates their profile + a default `Curator` role). Admins then adjust.
171173
- Inspect: `brainkb_list_users(q, role)` · `brainkb_available_roles()`.

0 commit comments

Comments
 (0)